Interroger une Entity

​

Vue d’ensemble

Le Data Node Interroger une entité exécute la version Live d’une Entity Datagraph et expose les lignes obtenues aux Nodes suivants. C’est le seul moyen de consommer le modèle Datagraph dans un Workflow. Contrairement à un Node Datasource, qui lit une seule Datasource, ce Node exécute le SQL joint préparé dans l’Entity. Les filtres, les jointures et le tri vivent donc dans l’Entity, pas dans le Node.

​

Ajouter le Node

Survolez le bouton Data de la barre d’outils de l’éditeur et sélectionnez Interroger une entité. Voir Data Nodes pour la procédure générale.

​

Configuration

L’icône située à côté du champ Entité ouvre l’Entity dans DataHub → Datagraph → Entities, dans un nouvel onglet et dans le scope de compte courant. Changer l’Entity sélectionnée efface les valeurs de paramètres déjà saisies, car les noms de paramètres appartiennent à la définition de l’Entity.

​

Lier les paramètres

Chaque paramètre est lié soit à une valeur statique, soit à une valeur produite en amont dans le Workflow, via le Variable Picker. Le contrôle affiché suit le type déclaré du paramètre. Un paramètre prend une seule valeur. Les valeurs multiples pour un même paramètre ne sont pas prises en charge. Les paramètres obligatoires doivent être liés. Si un paramètre obligatoire n’a pas de valeur à l’exécution, l’Entity est rejetée avec une erreur de paramètre invalide, plutôt que de renvoyer un résultat vide.

​

Sortie

Le Node renvoie une liste de lignes. Chaque ligne contient les colonnes de sortie inférées par l’Entity, avec des valeurs texte, numériques ou vides. Ces colonnes sont exposées aux Nodes suivants dans le Variable Picker, sous le nom de l’Entity, et peuvent alimenter un Content ou une Condition. Le Node affiché sur le canvas porte le nom de l’Entity sélectionnée : un Workflow utilisant plusieurs Entities reste lisible.

​

Exemple concret

Un Datagraph d’annonces immobilières relie les utilisateurs, les annonces, les recommandations et les prix du marché. L’Entity listings_matching_a_user_search déclare un paramètre, user_id, et renvoie une ligne par annonce correspondante avec sa référence, sa surface, sa ville et son prix. Dans le Workflow :

1. Un Node URL Parameter capte user_id depuis l’appel réalisé par l’outil d’envoi.
2. Un Node Interroger une entité sélectionne listings_matching_a_user_search, lie user_id à ce URL Parameter et fixe la Limite de résultats à 6.
3. Le Content parcourt les lignes renvoyées pour construire un bloc de six annonces.

Comme les jointures vivent dans l’Entity, la même configuration de Node fonctionne pour chaque destinataire, et le modèle peut être corrigé sans toucher au Workflow.

​

Points opérationnels

• Alignez la limite de résultats sur ce que le Content affiche. Les lignes récupérées mais jamais affichées coûtent quand même du temps d’exécution.
• Testez l’Entity avec Run query dans l’éditeur d’Entity avant de la brancher dans un Workflow, avec les mêmes valeurs de paramètres.
• Les relations dont le taux de correspondance est faible produisent des résultats partiels. Vérifiez-les dans l’Explorer Datagraph avant de mettre en cause le Node.
• Une Entity dont les Datasources sont protégées par des filtres au niveau des lignes ne peut pas être exécutée depuis un Workflow.

​

Pour aller plus loin