Interroger plusieurs enregistrements d’entités

Envoie une demande à l'API Data Fabric pour interroger les enregistrements d'une entité principale, avec une extension facultative à une entité secondaire via un filtre au niveau du champ.

Description

Envoie une demande à l'API Data Fabric pour interroger les enregistrements d'une entité principale, avec une extension facultative à une entité secondaire via un filtre au niveau du champ.

Cette activité est équivalente à l'activité du même nom dans le package d'activités classique Data Service.

Compatibilité du projet

Windows | Multiplate-forme

Workflows pris en charge

Tous les workflows de Studio Desktop et Studio Web.

Propriétés

• Connexion à UiPath Data Fabric : sélectionnez la connexion de Data Fabric que vous avez établie dans Integration Service. Accédez au menu déroulant pour sélectionner, ajouter ou gérer les connexions.
• Entité principale : spécifiez l'entité principale à partir de laquelle les enregistrements sont récupérés.
• Entité secondaire : spécifiez l’entité associée à joindre à l’entité principale.
• Type de jointure : définissez le type de jointure effectué entre les entités principale et secondaire.
  • Jointure interne : sélectionnez cette option pour renvoyer uniquement les enregistrements où des valeurs correspondantes existent dans les deux entités.
  • Joindre de gauche : sélectionnez pour renvoyer tous les enregistrements de l'entité principale et les enregistrements correspondants de l'entité secondaire. Si aucune correspondance n'existe, les champs secondaires renvoient la valeur Null.
• Champ de jointure de l'entité principale : spécifiez le champ de l'entité principale utilisée pour établir la relation de jointure.
• Champ de jointure de l'entité secondaire : spécifiez le champ de l'entité secondaire utilisée pour établir la relation de jointure.
• Conditions de filtrage : définissez les critères de filtrage des enregistrements de l'entité principale et/ou secondaire. Le générateur de filtres fonctionne comme celui de Requête d'enregistrement d'entité, et les noms de champs sont tirés des entités principales et secondaires.

Le générateur de filtres propose un ensemble d'opérateurs que vous pouvez utiliser pour filtrer les enregistrements en fonction des valeurs des champs d'entité. Les opérateurs disponibles pour un champ dépendent de son type de données.

Le tableau suivant décrit chaque opérateur pris en charge et les types de données auxquels il s’applique.

Pour les opérateurs In et Not In , saisissez les valeurs sous forme de liste séparée par des virgules. Les noms de champ sont précédés du nom de l'entité. Par exemple, le champ Name de l'entité Student apparaît sous la forme Student_Name, et les champs de relation utilisent la notation pointillée des enregistrements d'entité de requête. Pour renvoyer uniquement les enregistrements où Student_Name correspond à John ou Jane, saisissez John,Jane.

Opérateur	Description	Types de données applicables
égale (=)	Correspond aux enregistrements dont la valeur du champ est exactement égale à la valeur spécifiée.	Texte, Nombre, Oui/Non, Date-Heure, Ensemble de choix
Pas égale à (!=)	Correspond aux enregistrements où la valeur du champ n'est pas égale à la valeur spécifiée.	Texte, Nombre, Oui/Non, Date-Heure, Ensemble de choix
inférieur à (<)	Correspond aux enregistrements dont la valeur du champ est inférieure à la valeur spécifiée. Pour les champs de date, cela renvoie les enregistrements avec une date ou une heure antérieure.	Nombre, date-heure
Inférieur(e) ou 'Égal(<=)	Correspond aux enregistrements où la valeur du champ est inférieure ou égale à la valeur spécifiée.	Nombre, date-heure
supérieur à (>)	Correspond aux enregistrements dont la valeur du champ est supérieure à la valeur spécifiée. Pour les champs de date, cela renvoie les enregistrements avec une date ou une heure ultérieure.	Nombre, date-heure
Supérieur(e) ou 'Égal(e>;=)	Correspond aux enregistrements dont la valeur du champ est supérieure ou égale à la valeur spécifiée.	Nombre, date-heure
Contient	Correspond aux enregistrements où la valeur de champ contient le texte spécifié en tant que sous-chaîne.	Texte
Ne contient pas	Correspond aux enregistrements dont la valeur de champ ne contient pas le texte spécifié.	Texte
Commence par	Correspond aux enregistrements où la valeur de champ commence par le texte spécifié.	Texte
Se termine par	Correspond aux enregistrements où la valeur du champ se termine par le texte spécifié.	Texte
dans	Correspond aux enregistrements où la valeur du champ est égale à n'importe quelle valeur d'une liste spécifiée.	Texte, Nombre, Date-Heure, Ensemble de choix
pas dans	Correspond aux enregistrements où la valeur du champ n'est égale à aucune valeur dans la liste spécifiée.	Texte, Nombre, Date-Heure, Ensemble de choix
Est nul	Correspond aux enregistrements où la valeur du champ est nulle. Cet opérateur ne nécessite pas de valeur d'entrée.	Texte, Nombre, Oui/Non, Date-Heure, Ensemble de choix
N’est pas nul	Correspond aux enregistrements où le champ contient une valeur non null. Cet opérateur ne nécessite pas de valeur d'entrée.	Texte, Nombre, Oui/Non, Date-Heure, Ensemble de choix
est True	Correspond aux enregistrements où un champ Oui/Non est défini sur Vrai. Cet opérateur ne nécessite pas de valeur d'entrée.	Oui/Non
est False	Correspond aux enregistrements où un champ Oui/Non est défini comme Faux. Cet opérateur ne nécessite pas de valeur d'entrée.	Oui/Non

Options

• Ignorer : spécifiez le nombre d'enregistrements à ignorer au début.
• Top : spécifiez le nombre d'enregistrements à renvoyer au maximum. La propriété prend en charge des valeurs comprises entre 1 et 1 000. La valeur par défaut est 100.
• Trier par ordre croissant : spécifiez si vous souhaitez trier par ordre croissant (vrai) ou par ordre décroissant (faux).
• Trier par champ : spécifiez le champ utilisé pour trier les enregistrements renvoyés.

Sortie

• Interroger plusieurs enregistrements d'entité - Renvoie une liste d'enregistrements produits en joignant les deux entités sélectionnées et en appliquant le filtre fourni. Chaque enregistrement contient tous les champs auxquels l’appelant a accès dans les deux entités.