Datagraph Entity Groups

​

Vue d’ensemble

Un Datagraph Entity Group est un contrat de sortie partagé par plusieurs Datagraph Entities. Il rend plusieurs Entities — une par pays, par marque ou par algorithme de recommandation — interchangeables pour le consommateur qui les lit. Ouvrez DataHub → Datagraph → Entity groups — Define output contracts shared by a set of entities. La liste affiche chaque groupe avec son Name, le nombre de Fields du contrat, le nombre d’Entities membres, son Status (Draft ou Live) et sa dernière mise à jour. Deux actions sont disponibles : Edit et Delete. Create group ouvre l’éditeur sur un nouveau Draft.

​

Avant de commencer

• Les Entities à lier doivent exister et, pour publier le groupe, disposer d’une version Live. Voir Datagraph Entities.
• Créer et modifier des groupes requiert la permission Datagraph Entity. Voir Permissions.

​

Organisation de l’éditeur

La barre d’outils contient le Name du groupe, l’action Save, l’action Publish et un panneau latéral Versions, exactement comme dans l’éditeur d’Entity. Sous la barre d’outils, deux sections définissent le contrat et ses membres.

​

Fields

Fields liste les sorties que chaque Entity membre doit fournir. Cliquez sur Add field pour en déclarer une.

​

Entities

Entities liste les Entities liées à ce contrat. Choisissez-les dans Select entities… ; chaque membre affiche ensuite sa Conformance : La conformité est vérifiée sur la version Live de chaque Entity : une modification non publiée d’une Entity n’a aucun effet tant qu’elle n’est pas publiée.

​

Règles de conformité

• Un champ requis doit être présent dans la sortie de l’Entity avec un type compatible.
• Un champ optionnel peut être absent. S’il est présent, son type doit rester compatible.
• Deux types sont compatibles lorsqu’ils sont identiques, ou lorsqu’ils partagent la même primitive — datetime et datetime_iso correspondent tous deux à une date, par exemple.
• Les colonnes de sortie supplémentaires retournées par une Entity sont ignorées.

​

Exemple détaillé

Le modèle d’annonces immobilières de Datagraph Entities compte deux Entities qui retournent des annonces : recommended_listings et listings_matching_search. Un Content qui affiche une fiche d’annonce a besoin des mêmes colonnes quelle que soit l’Entity sélectionnée dans le Workflow. Liez les deux Entities à un groupe nommé listings_recommendations. Chacune affiche Conform lorsque son SQL Live retourne les quatre colonnes requises, et le Workflow peut changer d’Entity sans modifier le Content. Le même schéma s’applique à une Entity de recommandation par algorithme dans un modèle retail.

​

Sauvegarde et publication

Save valide la définition — un nom non vide, des noms et types de champs valides, des Entities membres existantes — puis enregistre le Draft. Unsaved changes apparaît dans la barre d’outils jusqu’à la sauvegarde. Cliquez sur Publish pour promouvoir le Draft en Live. La fenêtre Publish entity group accepte un Commit message optionnel décrivant le changement. La version Live précédente devient Inactive, et une nouvelle copie Draft est créée pour poursuivre l’édition. La publication exige que chaque membre soit Conform ; un membre en No live version bloque la publication.

​

Versions

Ouvrez le panneau Versions depuis le rail de la barre d’outils. Chaque carte affiche l’état de la version, son nombre de champs, l’auteur et le commit message lorsqu’il a été renseigné. Cliquez sur une carte pour charger cette définition dans l’éditeur — l’éditeur demande confirmation si vous avez des modifications non sauvegardées. Sauvegardez pour faire de la définition chargée le nouveau Draft.

​

Supprimer un groupe

Delete dans la liste supprime le groupe et toutes ses versions. La fenêtre avertit que Contents bound to this group will stop resolving ; l’opération est irréversible. Les Entities membres ne sont pas supprimées.

​

Et ensuite ?