Documentation Experience Platform Guide de modèle de données d’expérience (XDM)

Définir une relation un-à-un entre deux schémas à l’aide de Schema Editor

Dernière mise à jour : 24 septembre 2024

Rubriques :

Créé pour :

Développeur

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 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é.

NOTE

Si les schémas source et de destination appartiennent à la même classe, un champ de relation dédié doit ne pas être utilisé. Dans ce cas, utilisez l’interface utilisateur du schéma d’union pour afficher la relation. Vous trouverez des instructions pour ce faire dans la section Afficher les relations du guide de l’interface utilisateur du schéma d’union.

Ce document fournit un tutoriel pour la définition d’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.

NOTE

Pour savoir comment créer une relation multiple-à-un dans Adobe Real-Time Customer Data Platform B2B Edition, consultez le guide sur la création de relations B2B.

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 :

Système XDM en Experience Platform : présentation de XDM et de sa mise en oeuvre 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 de Schema Editor : tutoriel sur les principes de base de l’utilisation de 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 schéma "Loyalty Members") et leur hôtel préféré (défini dans un schéma "Hotels").

IMPORTANT

Pour établir une relation, les deux schémas doivent avoir défini des identités primaires et être activés pour Real-Time Customer Profile. Consultez la section Activation d’un schéma à utiliser dans Profile dans le tutoriel de création de schéma si vous avez besoin de conseils sur la configuration de 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 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" servira de 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.

schéma Loyalty Members

Le schéma source "Loyalty Members" est basé sur la classe XDM Individual Profile, qui contient un champ 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 Email . Comme vous pouvez le constater sous Propriétés du schéma, ce schéma a été activé pour une utilisation dans Real-Time Customer Profile.

schéma Hotels

Le schéma de référence "Hotels" est basé sur une classe personnalisée "Hotels" 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 Profile. Dans ce cas, _tenantId.hotelId agit comme l’identité principale du schéma, à l’aide d’un espace de noms d’identité personnalisé "Hotel ID".

Activer pour Profile

NOTE

Pour savoir comment créer des espaces de noms d’identité personnalisés, reportez-vous à la documentation Identity Service.

Création d’un groupe de champs de relation

NOTE

Cette étape n’est nécessaire que si votre schéma source ne dispose pas d’un champ de type chaîne dédié à utiliser comme pointeur vers l’identité principale du schéma de référence. 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é 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 du schéma Loyalty Members, un nouveau champ 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 tout 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 un nom de champ et un nom d’affichage pour le champ, puis définissez son type sur "String". Sous Attribuer à, sélectionnez un groupe de champs existant à étendre ou saisissez un nom unique pour créer un nouveau 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 apparaît dans la zone de travail, situé sous un objet _tenantId puisqu’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

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.

NOTE

Les relations ne peuvent être prises en charge que dans les champs de tableau de chaîne ou de chaîne.

Sélectionnez le champ preferredHotel dans la zone de travail, puis Ajouter une relation dans la barre latérale Propriétés du champ.

L’éditeur de schémas avec l’option Ajouter une relation mise en surbrillance dans la barre latérale des 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 de Real-Time CDP B2C, vous pouvez uniquement définir une relation un-à-un entre le schéma source et le schéma de référence.

NOTE

Si vous avez accès à l’édition B2B de Real-Time CDP, vous pouvez utiliser les commandes du rail droit du canevas pour définir un champ de relation, ainsi que créer une relation multiple-à-un à l’aide de la même boîte de dialogue.

Boîte de dialogue Ajouter une relation.

Utilisez la liste déroulante pour Schéma de référence et sélectionnez le schéma de référence pour la relation ("Hotels" dans cet exemple).

NOTE

Seuls les schémas qui contiennent une identité principale sont inclus dans le menu déroulant du schéma de référence. Cette protection vous empêche de créer accidentellement une relation avec un schéma qui n’est pas encore correctement configuré.

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 Apply lorsque vous avez terminé.

La boîte de dialogue Ajouter une relation avec les paramètres de relation configurés et Appliquer mis en surbrillance.

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 processus.

L’éditeur de schéma avec les références de relation et l’option Enregistrer en surbrillance.

Modifier un champ de relation existant

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.

L’éditeur de schémas avec la relation Modifier mise en surbrillance.

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.

Boîte de dialogue Modifier la relation.

Filtrage et recherche de relations

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

Onglet Relations de l’espace de travail des schémas.

Étapes suivantes

En suivant ce tutoriel, vous avez réussi à créer une relation 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.

recommendation-more-help