apps
latest
false
Important :
Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique.
Guide de l'utilisateur d'Apps
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 17 juin 2024

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.

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).
    docs image
  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 :
    OptionDescription

    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 :
    OptionDescription

    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() a les paramètres suivants :

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.
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)()Fetch(of SystemUsers)()

Récupérer avec condition de filtre

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10))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")})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)})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))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))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"})Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), Nothing, new string(){"Name"})

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.