Definieren einer 1:1-Beziehung zwischen zwei Schemata mithilfe des Schema Editor relationship-ui
Die Möglichkeit, Beziehungen zwischen Ihren Kunden und deren Interaktionen mit Ihrer Marke kanalübergreifend zu analysieren, ist ein wichtiger Bestandteil von Adobe Experience Platform. Durch die Definition dieser Beziehungen innerhalb der Struktur Ihrer Experience Data Model (XDM)-Schemas können Sie komplexe Einblicke in Ihre Kundendaten gewinnen.
Während Schemabeziehungen durch die Verwendung des Vereinigungsschemas und Real-Time Customer Profile abgeleitet werden können, gilt dies nur für Schemata einer gemeinsamen Klasse. Um eine Beziehung zwischen zwei Schemas herzustellen, die zu verschiedenen Klassen gehören, muss einem Quellschema ein dediziertes Beziehungsfeld hinzugefügt werden, das auf die Identität des anderen verwandten Schemas verweist.
Dieses Dokument bietet eine Anleitung zum Definieren einer Beziehung zwischen zwei Schemas mithilfe des Schema-Editors in der Benutzeroberfläche von Experience Platform. Anweisungen zum Definieren von Schemabeziehungen mithilfe der API finden Sie in der Anleitung zum Definieren einer Beziehung mithilfe der Schema Registry-API.
Erste Schritte
Für dieses Tutorial sind ein grundlegendes Verständnis von XDM System und des Schema-Editors in der Benutzeroberfläche von Experience Platform erforderlich. Bevor Sie mit dem Tutorial beginnen, lesen Sie die folgenden Dokumente:
- XDM-System in Experience Platform: Eine Übersicht über XDM und dessen Implementierung in Experience Platform.
- Grundlagen der Schemakomposition: Eine Einführung in die Bausteine von XDM-Schemata.
- Erstellen Sie ein Schema mit dem Schema Editor: Ein Tutorial, das die Grundlagen der Arbeit mit dem Schema Editor behandelt.
Quell- und Referenzschema definieren
Wir gehen davon aus, dass Sie die beiden Schemata, die in der Beziehung definiert werden sollen, bereits erstellt haben. Zu Demonstrationszwecken erstellt dieses Tutorial eine Beziehung zwischen Mitgliedern des Treueprogramms einer Organisation (definiert in einem "Loyalty Members"-Schema) und ihrem Lieblingshotel (definiert in einem "Hotels"-Schema).
Schemabeziehungen werden durch ein dediziertes Feld innerhalb eines Quellschemas dargestellt, das auf ein anderes Feld innerhalb eines Referenzschemas verweist. In den folgenden Schritten ist "Loyalty Members" das Quellschema, während "Hotels" als Referenzschema fungiert.
In den folgenden Abschnitten wird die Struktur der einzelnen Schemas beschrieben, die in diesem Tutorial verwendet werden, bevor eine Beziehung definiert wurde.
Loyalty Members schema
Das Quellschema "Loyalty Members" basiert auf der Klasse XDM Individual Profile und enthält ein Feld, das Mitglieder eines Treueprogramms beschreibt. Eines dieser Felder, personalEmail.addess, dient als primäre Identität für das Schema unter dem Namespace E-Mail . Wie unter Schemaeigenschaften zu sehen ist, wurde dieses Schema für die Verwendung in Real-Time Customer Profile aktiviert.
Hotels schema
Das Referenzschema "Hotels" basiert auf einer benutzerdefinierten Klasse "Hotels" und enthält Felder, die ein Hotel beschreiben. Um an einer Beziehung teilnehmen zu können, muss das Referenzschema auch über eine primäre Identität verfügen, die für Profil definiert und aktiviert ist. In diesem Fall fungiert _tenantId.hotelIdals primäre Identität für das Schema und verwendet einen benutzerdefinierten Identitäts-Namespace "Hotel ID".
Erstellen einer Beziehungsfeldgruppe
Um eine Beziehung zwischen zwei Schemas zu definieren, muss das Quellschema über ein dediziertes Feld verfügen, das die primäre Identität des Referenzschemas angibt. Sie können dieses Feld zum Quellschema hinzufügen, indem Sie eine neue Schemafeldergruppe erstellen oder eine bestehende erweitern.
Im Fall des Schemas Loyalty Members wird ein neues Feld preferredHotel hinzugefügt, das das bevorzugte Hotel des Treuemitglieds für Unternehmensbesuche angibt. Wählen Sie zunächst das Pluszeichen (+) neben dem Namen des Quellschemas aus.
Auf der Arbeitsfläche wird ein neuer Feld-Platzhalter angezeigt. Geben Sie unter "Feldeigenschaften"einen Feldnamen und einen Anzeigenamen für das Feld ein und setzen Sie dessen Typ auf "String". Wählen Sie unter Zuweisen zu eine vorhandene Feldergruppe aus, die erweitert werden soll, oder geben Sie einen eindeutigen Namen ein, um eine neue Feldergruppe zu erstellen. In diesem Fall wird eine neue Feldergruppe "Preferred Hotel" erstellt.
Wenn Sie fertig sind, wählen Sie Anwenden aus.
Das aktualisierte preferredHotel -Feld wird auf der Arbeitsfläche unter einem _tenantId -Objekt angezeigt, da es sich um ein benutzerdefiniertes Feld handelt. Wählen Sie Speichern aus, um die Änderungen am Schema abzuschließen.
Definieren eines Beziehungsfelds für das Quellschema relationship-field
Sobald in Ihrem Quellschema ein dediziertes Referenzfeld definiert ist, können Sie es als Beziehungsfeld festlegen.
Wählen Sie das Feld preferredHotel auf der Arbeitsfläche aus und scrollen Sie dann unter Feldeigenschaften nach unten, bis das Kontrollkästchen Beziehung angezeigt wird. Aktivieren Sie das Kontrollkästchen, um die erforderlichen Parameter für die Konfiguration eines Beziehungsfelds anzuzeigen.
Wählen Sie das Dropdown-Menü für Referenzschema aus und wählen Sie das Referenzschema für die Beziehung ("Hotels" in diesem Beispiel). Wählen Sie unter Referenz-Identitäts-Namespace den Namespace des Identitätsfelds des Referenzschemas (in diesem Fall "Hotel ID"). Wählen Sie Anwenden aus, wenn Sie fertig sind.
Das Feld preferredHotel wird jetzt auf der Arbeitsfläche als Beziehung hervorgehoben und zeigt den Namen des Referenzschemas an. Wählen Sie Speichern aus, um Ihre Änderungen zu speichern und den Workflow abzuschließen.
Nächste Schritte
In diesem Tutorial haben Sie mithilfe von Schema Editor erfolgreich eine Eins-zu-Eins-Beziehung zwischen zwei Schemas erstellt. Anweisungen zum Definieren von Beziehungen mithilfe der API finden Sie in der Anleitung zum Definieren einer Beziehung mithilfe der Schema Registry-API.