Rechercher des enregistrements d’entités

Configure the Query entity records node to read Data Fabric records, and read its output in later nodes.

Lit un ou plusieurs enregistrements à partir d’une entité Data Fabric. Il s’agit d’un nœud natif. Aucune connexion n’est nécessaire. Il fonctionne avec les entités existantes de la plate-forme Data Fabric, où qu’elles soient stockées, et avec les entités définies dans une solution VS Code. Entités dans VS Code: comment définir une entité dans une solution VS Code.

Configuration

Champ	Requis	Description
Entité Data Fabric	Oui (Yes)	L'entité à interroger. Sélectionnez Actualiser le schéma si les champs de l'entité ont changé depuis que vous avez ajouté le nœud.
Enregistrements à renvoyer	Oui (Yes)	Un enregistrement unique renvoie un enregistrement et échoue si le filtre en correspond à plus d’un. L'option Enregistrements multiples renvoie un tableau d'enregistrements correspondants.
Condition(s) de filtre	Non (No)	Une ou plusieurs conditions de champ/opérateur/valeur, combinées avec Tous (ET) ou N’importe lequel (OU).
Trier par (enregistrements multiples uniquement)	Non (No)	Le champ par lequel trier les résultats et la direction (croissant ou décroissant). Sans tri, la requête peut renvoyer un ensemble différent d'enregistrements à chaque fois.
Enregistrements à ignorer (Multiples enregistrements uniquement)	Non (No)	Nombre d’enregistrements correspondants à ignorer avant de renvoyer les résultats. Par défaut 0.
Limite d'enregistrements (enregistrements multiples uniquement)	Non (No)	Le nombre maximal d’enregistrements à renvoyer. 100 par défaut, 1000 maximum.

Dans Filtrer condition(s), sélectionnez Ajouter une condition pour une autre condition au même niveau ou Ajouter un groupe pour imbriquer un groupe de conditions avec sa propre logique ET/OU.

Ce nœud ne prend pas en charge l’onglet de gestion des erreurs .

Sortie

Pour Enregistrement unique, les champs de sortie reflètent directement le schéma de l’entité. Pour Plusieurs enregistrements, la sortie est un tableau results , chaque élément reflétant le schéma de l'entité. Accédez-y en aval sous la forme de $vars.<nodeId>.output.<fieldName> (enregistrement unique) ou $vars.<nodeId>.output.results[<index>].<fieldName> (enregistrements multiples).

Comportement de référence en direct

La sortie est une référence dynamique à la requête, et non une copie stockée des résultats. Chaque expression, condition ou script qui la lit réexécute la requête à ce moment, de sorte qu'il puisse toujours afficher les données actuelles de l'entité. La puce Live Query dans l'arborescence du schéma marque les sorties qui se comportent de cette manière.

Par exemple, si un nœud d'entité de requête nommé Rechercher un ticket renvoie un ticket dont le statut est Open, et qu'un nœud ultérieur dans le workflow définit ce ticket sur Closed, une expression lisant $vars.Find ticket.output.Status après ce point renvoie Closed, et non la valeur Open affichée par la requête. Une copie stockée indiquerait toujours Open.

Mettez à jour l'enregistrement d'entité et Supprimer l'enregistrement d'entité défini sur Référence d'entité en fonction de ceci: ils agissent sur l'enregistrement trouvé par cette requête sans spécifier à nouveau l'entité et le filtre.

Les collections de boucle et de transformation de données sont l'exception. Elles lisent un instantané des résultats pris lors de l’exécution du nœud, plutôt que de réexécuter la requête.

Prochaines étapes

• Nœuds d'entité Data Fabric: les autres nœuds d'enregistrement d'entité.
• Référence du nœud: chaque nœud et comment le configurer.
• Community (Communauté): posez des questions et partagez des workflows avec d'autres développeurs sur le forum UiPath.