Générateur de requêtes (Query builder)

Le générateur de requêtes vous permet de filtrer les données des entités Data Service, tout en respectant une syntaxe prédéfinie.

Important :

Les fonctions Fetch, FetchOne, GetChoiceSet et GetChoiceSetValue sont asynchrones et ne prennent pas en charge le chaînage.

Pour afficher les enregistrements d'entité dans un contrôle**,** utilisez une variable d'application et la règle Définir la valeur . Vous pouvez également lier la source de données de contrôle à votre entité à l'aide du Générateur de requêtes.

Reportez-vous à la section Utilisation des fonctions de récupération pour obtenir des exemples pratiques.

Astuce :

Pour actualiser une variable d'entité lors du chargement de la page ou d'un clic sur un bouton, ajoutez une règle Définir la valeur . Ouvrez le générateur de requêtes dans la règle de la valeur définie et ajoutez une condition de filtre pour Date de mise à jour <= maintenant() ).

Utilisation du générateur de requêtes (Query builder)

Le générateur de requêtes utilise la fonction Fetch() pour évaluer et trier vos entités Data Service.

Au préalable, vous devez référencer les entités Data Service existantes dans votre application. Pour utiliser le générateur de requêtes, procédez comme suit :

1. Pour le contrôle souhaité, sélectionnez une propriété VB activée. Vous pouvez identifier ces types de propriétés grâce au champ Source de données VB (VB Data source) dans l'onglet Général (General).

   

2. Sélectionnez Générateur de requêtes (Query Builder). Cela ouvre la fenêtre du générateur de requêtes.

3. Sélectionnez l'entité pour laquelle vous souhaitez définir les autorisations.

4. Dans l'onglet Conditions, cliquez sur :

   Option	Description
   Ajouter une condition	pour ajouter une seule condition
   Ajouter un groupe	pour regrouper plusieurs conditions

   Lorsque vous ajoutez deux conditions ou plus, la requête évalue et renvoie des données en fonction des opérateurs ET (AND) ou OU (OR) :

   • ET (AND) : renvoie les données lorsque toutes les conditions sont remplies
   • OR (OU) : renvoie des données lorsqu'une condition est remplie

5. Sélectionnez le champ d'entité dont vous souhaitez interroger les données.

6. Sélectionnez l'opérateur d'évaluation.

7. Saisissez la valeur de votre condition. La valeur doit être du même type que le type de champ. Par exemple, utilisez des chaînes pour les champs Texte (Text) et des entiers pour les champs Nombre (Number).

8. Vous pouvez éventuellement configurer des règles pour les données interrogées dans l'onglet Paramètres supplémentaires .

9. Sélectionnez Enregistrer pour enregistrer votre requête.

La fonction Récupérer (Fetch)

Le générateur de requêtes utilise la fonction Fetch() pour récupérer et manipuler les données d'entité. La fonction Fetch() est asynchrone et ne prend pas en charge le chaînage.

La fonction Fetch() a les paramètres suivants :

Paramètre	Description
FilterGroup	Un groupe de filtres dans Data Service
PaginationProps	Spécifiez la taille de la page et le nombre d'enregistrements à ignorer.
SortOption[] sortOptions	Spécifiez la colonne à trier et l'ordre de tri.
string[] selectedFields	Spécifiez les champs d'entité qui doivent être renvoyés.
ExpansionFieldOption[] expansionFieldOptions	Spécifiez quelle colonne d'une entité de relation doit être développée et renvoyée. Les applications autorisent les développements de niveau un, ce qui signifie que si vous avez un champ de relation, les expressions s'attendent à ce qu'un niveau de propriétés soit accessible. Le générateur de requêtes ajoute automatiquement ces propriétés, et elles sont obligatoires pour les entités n'appartenant pas au système.

The FetchOne() function

Alors que Fetch() renvoie un objet ListSource<T>, qui est du même type que pour les contrôles de liste, FetchOne() renvoie un seul enregistrement de type T.

Comme la fonctionFetch() , la fonction FetchOne() est asynchrone et ne prend pas en charge la chaîne.

Pour les scénarios suivants, vous devez modifier manuellement la fonction Fetch() pour obtenir des résultats plus personnalisés :

Récupération simple

Obtient le nombre d'enregistrements pour une entité, par exemple UtilisateursSystème (SystemUsers).

Fetch(of SystemUsers)()

Récupérer avec condition de filtre

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10))

Récupérer avec condition de filtre et ordre de tri (croissant)

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date")})

Récupérer avec condition de filtre et ordre de tri (décroissant)

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date", true)})

Récupérer avec PaginationProps statiques

Fetch(of SystemUsers)(Nothing, new PaginationProps(0, 100))

Récupérer avec PaginationProps liés à la commande

Par exemple, pour le champ Modifier la grille (Edit Grid) :

Fetch(of SystemUsers)(Nothing, new PaginationProps(MainPage.EditableGrid.PageStart, MainPage.EditableGrid.PageLimit))

Récupérer avec une projection

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), Nothing, new string(){"Name"})