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. La définition de ces relations dans 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 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 fait référence à l’identité de l’autre schéma associé.

Ce document fournit un tutoriel expliquant comment définir une relation entre deux schémas à l’aide de l’éditeur de schémas dans l’interface utilisateur de 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.

Commencer

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

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éfini dans un schéma « Loyalty Members ») et leur hôtel préféré (défini dans un schéma « 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 qui suivent, « 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 le schéma

Le schéma source « Loyalty Members » est basé sur la classe XDM Individual Profile , qui contient des champs décrivant les membres d’un programme de fidélité. L’un de ces champs, personalEmail.addess, sert d’identité principale pour le schéma sous l’espace de noms E-mail. Comme indiqué sous Propriétés du schéma, ce schéma peut être utilisé dans Real-Time Customer Profile.

Hotels le schéma

Le schéma de référence « Hotels » est basé sur une classe « Hotels » personnalisée 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.hotelIdagit comme identité principale pour le schéma, en utilisant un espace de noms d’identité « Hotel ID » personnalisé.

Créer 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 indique 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 groupe existant.

Dans le cas du schéma Loyalty Members, un nouveau champ de preferredHotel est ajouté pour indiquer l’hôtel préféré du membre du programme de fidélité pour les visites d’entreprise. Commencez par sélectionner l’icône plus (+) en regard du nom du schéma source.

Un espace réservé pour le nouveau champ s’affiche dans la zone de travail. Sous Propriétés du champ, indiquez un nom de champ et un nom d’affichage pour le champ, puis définissez son type sur « Chaîne ». Sous Affecter à, 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 groupe de champs « Preferred Hotel » est créé.

Lorsque vous avez terminé, sélectionnez Appliquer.

Le champ preferredHotel mis à jour s’affiche dans la zone de travail, sous un objet _tenantId, car il s’agit d’un champ personnalisé. Sélectionnez 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 le champ preferredHotel dans la zone de travail, puis sélectionnez Ajouter une relation dans la barre latérale Propriétés du champ.

La boîte de dialogue Ajouter une relation s’affiche. Dans cette boîte de dialogue, vous pouvez définir les paramètres requis pour configurer un champ de relation. Pour les utilisateurs B2C de Real-Time CDP, vous pouvez uniquement définir une relation un-à-un entre le schéma source et le schéma de référence.

Utilisez 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).

L’espace de noms d’identité du schéma de référence (dans ce cas, « Hotel ID ») est automatiquement renseigné sous Espace de noms d’identité de référence. Sélectionnez Appliquer lorsque vous avez terminé.

Le champ preferredHotel est désormais mis en surbrillance en tant que relation dans la zone de travail, affichant le nom du schéma de référence. Sélectionnez Enregistrer pour enregistrer vos modifications et terminer le workflow.

Modifier un champ de relation existant edit-relationship

Pour modifier le schéma de référence, sélectionnez un champ avec une relation existante, puis sélectionnez Modifier la relation dans la barre latérale Propriétés du champ.

La boîte de dialogue Modifier la relation s’affiche. À partir de là, vous pouvez suivre le processus décrit dans définition d’un champ de relation ou supprimer la relation. Sélectionnez Supprimer la relation pour supprimer la relation avec le schéma de référence.

Filtrer et rechercher des relations filter-and-search

Vous pouvez filtrer et rechercher des relations spécifiques dans vos schémas à partir de l’onglet Relations de l’espace de travail Schémas. Vous pouvez utiliser cette vue pour localiser et gérer rapidement vos relations. Lisez le document exploration des ressources de schéma pour obtenir des instructions détaillées sur les options de filtrage.

Étapes suivantes

Ce tutoriel vous a permis de créer une relation un-à-un entre deux schémas à l’aide de l’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.