Define a relationship between two schemas using the 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. Defining these relationships within the structure of your Experience Data Model (XDM) schemas allows you to gain complex insights into your customer data.

Bien que les relations de schéma puissent être déduites par l'utilisation du schéma et Real-time Customer Profilede l'union, 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émas dans l’ Experience Platform 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

This tutorial requires a working understanding of XDM System and the Schema Editor in the Experience Platform UI. 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. For demonstration purposes, this tutorial creates a relationship between members of an organization's loyalty program (defined in a "Loyalty Members" schema) and their favorite hotel (defined in a "Hotels" schema).

IMPORTANT

Pour établir une relation, les deux schémas doivent avoir défini des identités Principales et être autorisés à Real-time Customer Profileétablir une relation. Reportez-vous à la section relative à l’ activation d’un schéma pour une utilisation en Profil dans le 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. In the steps that follow, "Loyalty Members" will be the source schema, while "Hotels" will act as the destination schema.

À 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

The source schema "Loyalty Members" is based on the XDM Individual Profile class, and is the schema that was constructed in the tutorial for creating a schema in the UI. It includes a loyalty object under its _tenantId namespace, which includes several loyalty-specific fields. One of these fields, loyaltyId, serves as the primary identity for the schema under the Email namespace. 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 schema

Le schéma de destination "Hotels" est basé sur une classe "Hotels" personnalisée et contient des champs qui décrivent un hôtel. The hotelId field serves as the primary identity for the schema under a custom hotelId namespace. Tout comme le Loyalty Members schéma, ce schéma a également été activé pour Real-time Customer Profilele.

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.

Start by selecting Add in the Mixins section.

La boîte de dialogue Ajouter un mixin s’affiche. From here, select Create new mixin. Dans les champs de texte qui s’affichent, saisissez le nom d’affichage et la description du nouveau mixin. Select Add mixin when finished.


The canvas reappears with "Favorite Hotel" appearing in the Mixins section. Select the mixin name, then select Add field next to the root-level Loyalty Members field.

A new field appears in the canvas under the _tenantId namespace. Under Field properties, provide a field name and display name for the field, and set its type to "String".

When finished, select Apply.

The updated favoriteHotel field appears in the canvas. Select Save to finalize your changes to the schema.

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.

Select the favoriteHotel field in the canvas, then scroll down under Field properties until the Relationship checkbox appears. Cochez la case pour afficher les paramètres requis pour la configuration d’un champ de relation.

Select the dropdown for Reference schema and select the destination schema for the relationship ("Hotels" in this example). If the destination schema is enabled for Profile, the Reference identity namespace field is automatically set to the namespace of the destination schema's primary identity. 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. Select Apply when finished.

The favoriteHotel field is now highlighted as a relationship in the canvas, displaying the name and reference identity namespace of the destination schema. Select Save to save your changes and complete the workflow.

Étapes suivantes

By following this tutorial, you have successfully created a one-to-one relationship between two schemas using the 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