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 commande à votre entité à l'aide du Générateur de requêtes. Reportez-vous à la section Utilisation des fonctions Récupérer pour obtenir des exemples pratiques.

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.

Paramètres supplémentaires

Dans l'onglet Paramètres supplémentaires , vous pouvez configurer des règles pour les données interrogées.

Le tableau suivant décrit les éléments de l'onglet Paramètres supplémentaires .

Élément	Description
Index de début de page (ignorer)	Vous permet de définir le nombre d'enregistrements à ignorer avant de commencer à renvoyer des résultats. Par exemple, si vous saisissez 10 , la requête commence à partir du 11e enregistrement. La définition d’un index de début de page peut être utile pour la pagination lors de l’utilisation d’ensembles de données volumineux.
Limite de la page (haut)	Permet de définir le nombre maximal d’enregistrements à renvoyer. Par exemple, si vous saisissez 50, la requête renvoie les 50 premières lignes. La définition d'une limite de page permet de contrôler la taille des requêtes.
Ajouter un champ de tri	Ajoute un champ de tri qui vous permet de configurer une règle de tri pour les données interrogées. Le champ Trier par et les éléments ascendants Trier s'affichent.
Trier par champ	Vous permet d'entrer le champ que vous souhaitez utiliser pour trier les données.
Trier par ordre croissant	Si la valeur est Vrai (True), trie les données interrogées dans l'ordre croissant
Projection	Vous permet de définir un champ spécifique à partir de l'entité qui doit uniquement être inclus dans l'ensemble de résultats. La projet peut être utilisé pour simplifier les données de sortie. Le projet est disponible uniquement lorsque le Générateur de requêtes est ouvert à partir de la règle Définir la valeur.

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"})