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 (Set Value) . Vous pouvez également lier la source de données de contrôle à votre entité à l'aide du Générateur de requêtes (Query Builder).

Reportez-vous à Utilisation des fonctions Récupérer pour obtenir des exemples pratiques.

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. Dans l'onglet Paramètres supplémentaires (Additional settings), vous pouvez configurer des règles de tri pour les données interrogées :

   Option	Description
   Trier par champ	Trie les données interrogées par le champ sélectionné
   Trier par ordre croissant	Si la valeur est Vrai (True), trie les données interrogées dans l'ordre croissant

9. Cliquez sur Enregistrer (Save) 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"})