Définir une relation un-à-un entre deux schémas à l’aide de Schema Editor relationship-ui
Comprendre les relations entre vos clients et leurs interactions avec votre marque sur divers canaux est un aspect important d’Adobe Experience Platform. Définir ces relations au sein de la structure de votre Experience Data Model Les schémas (XDM) vous permettent d’obtenir des informations complexes sur les données de vos clients.
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 s’applique uniquement aux schémas partageant 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 référence l’identité de l’autre schéma associé.
Ce document fournit un tutoriel sur la définition d’une relation entre deux schémas à l’aide de l’éditeur de schémas dans la variable Experience Platform de l’interface utilisateur. 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 tutoriel nécessite une compréhension pratique de XDM System et de l’éditeur de schémas dans le Experience Platform Interface utilisateur. Avant de commencer ce tutoriel, consultez la documentation suivante :
- Système XDM en Experience Platform: présentation de XDM et de son implémentation dans Experience Platform.
- Principes de base de composition des schémas : une présentation des blocs de création de schémas XDM.
- Créez un schéma à l’aide du Schema Editor: tutoriel sur les principes de base de l’utilisation de la fonction Schema Editor.
Définition d’un schéma source et de référence
Vous devez avoir déjà créé les deux schémas qui seront définis dans la relation. À des fins de démonstration, ce tutoriel crée une relation entre les membres du programme de fidélité d’une organisation (définis dans un "Loyalty Members"" et leur hôtel préféré (défini dans un ") Hotels").
Les relations de schéma sont représentées par un champ dédié dans un schéma source qui pointe vers un autre champ dans un schéma de référence. Dans les étapes suivantes, "Loyalty Members" sera le schéma source, tandis que "Hotels" agira comme schéma de référence.
Les sections suivantes décrivent la structure de chaque schéma utilisé dans ce tutoriel avant la définition d’une relation.
Loyalty Members schema
Le schéma source "Loyalty Members" est basé sur la variable XDM Individual Profile contenant un champ décrivant les membres d’un programme de fidélité. Un de ces champs, personalEmail.addess
, sert d’identité principale au schéma sous la propriété Email espace de noms. Comme vu sous Propriétés du schéma, ce schéma peut être utilisé dans Real-Time Customer Profile.
Hotels schema
Le schéma de référence "Hotels" est basé sur unHotels" et contient des champs qui décrivent un hôtel. Pour participer à une relation, une identité principale doit également être définie pour le schéma de référence et activée pour Profil. Dans ce cas, _tenantId.hotelId
agit comme l’identité principale du schéma, à l’aide d’un " personnalisé"Hotel ID" identity namespace.
Création d’un groupe de champs de relation
Pour définir une relation entre deux schémas, le schéma source doit disposer d’un champ dédié qui indiquera l’identité principale du schéma de référence. Vous pouvez ajouter ce champ au schéma source en créant un nouveau groupe de champs de schéma ou en étendant un autre existant.
Dans le cas de la fonction Loyalty Members schéma, un nouveau preferredHotel
sera ajouté pour indiquer l’hôtel préféré du membre du programme de fidélité pour les visites de la société. Sélectionnez d’abord l’icône Plus (+) en regard du nom du schéma source.
Un nouvel espace réservé de champ apparaît dans la zone de travail. Sous Propriétés du champ, indiquez le nom du champ et son nom d’affichage, puis définissez son type sur "Chaîne". Sous Attribuer à, sélectionnez un groupe de champs existant à étendre ou saisissez un nom unique pour créer un groupe de champs. Dans ce cas, un nouveau "Preferred Hotel" est créé.
Lorsque vous avez terminé, sélectionnez Appliquer.
La mise à jour preferredHotel
apparaît dans la zone de travail, située sous un _tenantId
car il s’agit d’un champ personnalisé. Sélectionner Enregistrer pour finaliser les modifications apportées au schéma.
Définir un champ de relation pour le schéma source relationship-field
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 la variable preferredHotel
dans la zone de travail, puis faites défiler l’écran vers le bas sous Propriétés du champ jusqu’à ce que la variable 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 pour Schéma de référence et sélectionnez le schéma de référence de la relation ("Hotels" dans cet exemple). Sous Espace d’identité de référence, sélectionnez l’espace de noms du champ d’identité du schéma de référence (ici : "Hotel ID"). Sélectionner Appliquer lorsque vous avez terminé.
La variable preferredHotel
est maintenant mis en surbrillance en tant que relation dans la zone de travail, affichant le nom du schéma de référence. Sélectionner Enregistrer pour enregistrer vos modifications et terminer le processus.
Étapes suivantes
En suivant ce tutoriel, vous avez réussi à créer une relation un-à-un entre deux schémas à l’aide de la variable 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.