Définissez une relation entre deux schémas à l'aide de Schema Editor

Comprendre les relations entre vos clients et leurs interactions avec votre marque sur divers canaux est un aspect important d’Adobe Experience Platform. La définition de ces relations au sein de la structure de vos schémas Experience Data Model (XDM) vous permet d’obtenir des informations complexes sur vos données client.

Bien que les relations de schéma puissent être déduites par l'utilisation du schéma d'union et Real-time Customer Profile, cela ne s'applique qu'aux schémas qui partagent la même classe. Pour établir une relation entre deux schémas appartenant à des classes différentes, un champ de relation dédié doit être ajouté à un schéma source, qui fait référence à l'identité d'un schéma de destination.

Ce document fournit un didacticiel pour la définition d'une relation entre deux schémas à l'aide de l'éditeur de Schéma dans l'interface utilisateur Experience Platform. Les étapes de la définition des relations de schémas à l’aide de l’API sont décrites dans le tutoriel sur la définition d’une relation à l’aide de l’API Schema Registry.

Prise en main

Ce didacticiel nécessite une bonne compréhension de XDM System et de l’éditeur de Schéma dans l’interface utilisateur Experience Platform. Avant de commencer ce tutoriel, consultez la documentation suivante :

Définition d’un schéma source et de destination

Vous devez avoir déjà créé les deux schémas qui seront définis dans la relation. À des fins de démonstration, ce didacticiel crée une relation entre les membres du programme de fidélité d'une organisation (défini dans un schéma "Loyalty Members") et leur hôtel favori (défini dans un schéma "Hotels").

IMPORTANT

Pour établir une relation, les deux schémas doivent avoir défini des identités Principales et être autorisés pour Real-time Customer Profile. Consultez la section activation d'un schéma à utiliser dans Profil du didacticiel de création de schéma si vous avez besoin de conseils sur la manière de configurer vos schémas en conséquence.

Les relations de schéma sont représentées par un champ dédié dans un schéma source qui fait référence à un autre champ dans un schéma de destination. Dans les étapes suivantes, "Loyalty Members" sera le schéma source, tandis que "Hotels" agira comme schéma de destination.

À titre de référence, les sections suivantes décrivent la structure de chaque schéma utilisé dans ce tutoriel avant de définir une relation.

Loyalty Members schema

Le schéma source "Loyalty Members" est basé sur la classe XDM Individual Profile et est le schéma qui a été construit dans le didacticiel pour créer un schéma dans l'interface utilisateur. Il comprend un objet loyalty sous son espace de nommage _tenantId, qui comprend plusieurs champs spécifiques à la fidélité. L'un de ces champs, loyaltyId, sert d'identité Principale au schéma sous l'espace de nommage E-mail. Comme vous pouvez le voir sous Propriétés du schéma, ce schéma a été activé pour une utilisation dans Real-time Customer Profile.

Hotels schéma

Le schéma de destination "Hotels" est basé sur une classe personnalisée "Hotels" et contient des champs qui décrivent un hôtel. Le champ hotelId sert d'identité Principale pour le schéma sous un espace de nommage personnalisé hotelId. Comme le schéma Loyalty Members, ce schéma a également été activé pour Real-time Customer Profile.

Création d’une relation mixin

REMARQUE

Cette étape n’est requise que si votre schéma source ne dispose pas d’un champ de type chaîne dédié à utiliser comme référence au schéma de destination. Si ce champ est déjà défini dans votre schéma source, passez à l’étape suivante de la définition d’un champ de relation.

Pour définir une relation entre deux schémas, le schéma source doit disposer d’un champ dédié à utiliser comme référence au schéma de destination. Vous pouvez ajouter ce champ au schéma source en créant un nouveau mixin.

Début en sélectionnant Ajouter dans la section Mixins.

La boîte de dialogue Ajouter un mixin s’affiche. À partir de là, sélectionnez Créer un nouveau mixin. Dans les champs de texte qui s’affichent, saisissez le nom d’affichage et la description du nouveau mixin. Sélectionnez Ajouter le mixin une fois terminé.


Le canevas réapparaît avec "Favorite Hotel" apparaissant dans la section Mixins. Sélectionnez le nom du mixin, puis Ajouter le champ en regard du champ racine Loyalty Members.

Un nouveau champ apparaît dans la trame sous l'espace de nommage _tenantId. Sous Propriétés de champ, indiquez un nom de champ et un nom d’affichage pour le champ, puis définissez son type sur "String".

Lorsque vous avez terminé, sélectionnez Appliquer.

Le champ favoriteHotel mis à jour apparaît dans la trame. Sélectionnez Enregistrer pour finaliser les modifications apportées au schéma.

Définition d’un champ de relation pour le schéma source

Une fois que le champ de référence dédié de votre schéma source est défini, vous pouvez le désigner comme champ de relation.

Sélectionnez le champ favoriteHotel dans la trame, puis faites défiler la liste sous Propriétés du champ jusqu'à ce que la case Relation s'affiche. Cochez la case pour afficher les paramètres requis pour la configuration d’un champ de relation.

Sélectionnez la liste déroulante schéma de référence et sélectionnez le schéma de destination de la relation ("Hotels" dans cet exemple). Si le schéma de destination est activé pour Profile, le champ espace de nommage d'identité de référence est automatiquement défini sur l'espace de nommage de l'identité Principale du schéma de destination. Si aucune identité principale n’est définie pour le schéma, vous devez sélectionner manuellement l’espace de noms que vous prévoyez d’utiliser dans le menu déroulant. Sélectionnez Appliquer une fois terminé.

Le champ favoriteHotel est désormais mis en évidence en tant que relation dans la trame, affichant le nom et l'espace de nommage d'identité de référence du schéma de destination. Sélectionnez Enregistrer pour enregistrer vos modifications et terminer le processus.

Étapes suivantes

En suivant ce didacticiel, vous avez réussi à créer une relation de type "un à un" entre deux schémas à l’aide de Schema Editor. Les étapes de la définition des relations à l’aide de l’API sont décrites dans le tutoriel sur la définition d’une relation à l’aide de l’API Schema Registry.

Sur cette page