Rechercher des enregistrements d’entités

Interroger le nœud d’enregistrement des entités pour lire un ou plusieurs enregistrements à partir d’une entité Data Fabric dans un flux, sans connexion Integration Service.

Lit un ou plusieurs enregistrements à partir d’une entité Data Fabric. Il s’agit d’un nœud de flux natif, il ne nécessite pas de connexion Integration Service. Il fonctionne avec les entités existantes de la plate-forme Data Fabric (entités de locataire et de dossier) et avec les entités définies dans une solution VS Code. Reportez-vous aux Entités dans 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 flux définit ce ticket sur Closed, une expression lisant $vars.Find ticket.output.Status après ce point renvoie Closed — ce n'est pas 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.