Erstellen und Bearbeiten von Datentypen über die Benutzeroberfläche ui-create-and-edit

Im Experience-Datenmodell (XDM) sind Datentypen wiederverwendbare Felder, die mehrere Unterfelder enthalten. Datentypen ähneln zwar den Schemafeldgruppen insofern, als sie die konsistente Verwendung einer Struktur mit mehreren Feldern ermöglichen, sind aber flexibler, da sie an einer beliebigen Stelle in die Schemastruktur aufgenommen werden können, während Feldgruppen nur auf der Stammebene hinzugefügt werden können.

Adobe Experience Platform bietet viele Standarddatentypen, mit denen eine Vielzahl gängiger Anwendungsfälle für die Erlebnisverwaltung abgedeckt werden können. Sie können jedoch auch eigene benutzerdefinierte Datentypen definieren, um Ihre individuellen Geschäftsanforderungen zu erfüllen.

In diesem Tutorial werden die Schritte zum Erstellen und Bearbeiten benutzerdefinierter Datentypen in der Benutzeroberfläche von Experience Platform beschrieben.

Voraussetzungen prerequisites

Dieses Handbuch setzt ein Grundverständnis des XDM-Systems voraus. Unter XDM-Übersicht finden Sie eine Einführung in die Rolle von XDM im Experience Platform-Ökosystem und in die Grundlagen der Schemakomposition wie Datentypen zu XDM-Schemata beitragen.

Obwohl dies für dieses Handbuch nicht erforderlich ist, wird empfohlen, auch das Tutorial zum Erstellen ​ Schemas in der Benutzeroberfläche zu befolgen um sich mit den verschiedenen Funktionen des Schema Editor vertraut zu machen.

Öffnen der Schema Editor für einen Datentyp data-type

Klicken Sie in der Benutzeroberfläche von Experience Platform im linken Navigationsbereich auf Schemas , um den Schemas-Arbeitsbereich zu öffnen, und wählen Sie dann die Registerkarte Data types aus. Eine Liste der verfügbaren Datentypen wird angezeigt. Die Liste der Datentypen wird automatisch nach der Art ihrer Erstellung gefiltert. Die Standardeinstellung zeigt die von Adobe definierten Datentypen an. Sie können die Liste auch so filtern, dass die von Ihrem Unternehmen erstellten Listen angezeigt werden.

Von hier aus haben Sie die folgenden Optionen:

Erstellen eines neuen Datentyps create

Wählen Sie auf der Registerkarte Data types die Option Create data type aus.

Das Schema Editor wird angezeigt und zeigt die aktuelle Struktur des neuen Datentyps auf der Arbeitsfläche an. Auf der rechten Seite des Editors können Sie einen Anzeigenamen und eine optionale Beschreibung für den Datentyp angeben. Stellen Sie sicher, dass Sie einen eindeutigen und knappen Namen für Ihren Datentyp angeben, da er auf diese Weise identifiziert wird, wenn Sie ihn einem Schema hinzufügen.

In diesem Tutorial wird ein Datentyp erstellt, der eine Restauranteigenschaft beschreibt, sodass dem Datentyp der Anzeigename „Restaurant“ zugewiesen wird.

Von hier aus können Sie mit dem ​ Abschnitt fortfahren um Felder zum neuen Datentyp hinzuzufügen.

Filtern von Datentypen filter

Die Liste der verfügbaren Datentypen wird je nach ihrer Erstellung vorab gefiltert. Wählen Sie das Optionsfeld aus, um zwischen den Optionen Standard und Custom auszuwählen. Die Option Standard zeigt Entitäten an, die von Adobe erstellt wurden, und die Option Custom zeigt Entitäten an, die in Ihrem Unternehmen erstellt wurden.

Bearbeiten eines vorhandenen Datentyps edit

Es können nur benutzerdefinierte Datentypen bearbeitet werden, die von Ihrer Organisation definiert wurden. Wählen Sie Custom aus, um nur benutzerdefinierte Datentypen anzuzeigen, die Ihrem Unternehmen gehören.

Wählen Sie in der Liste den Datentyp aus, den Sie bearbeiten möchten, um die rechte Leiste mit den Details des Datentyps zu öffnen. Im Detailbereich können Sie auch eine Beispieldatei herunterladen, die JSON-Struktur kopieren oder den Datentyp zu einem Paket hinzufügen.

Wählen Sie den Namen des Datentyps in der rechten Leiste aus, um seine Struktur im Schema Editor zu öffnen.

Hinzufügen von Feldern zum Datentyp add-fields

Um Felder zum Datentyp hinzuzufügen, wählen Sie auf der Arbeitsfläche das Symbol plus (+) neben dem Feld auf der Stammebene aus. Darunter wird ein neues Feld angezeigt, und die rechte Leiste wird aktualisiert, um Steuerelemente für das neue Feld anzuzeigen.

Verwenden Sie die Steuerelemente in der rechten Leiste, um die Details des neuen Felds zu konfigurieren. Spezifische Schritte zum Konfigurieren ​ Hinzufügen des Felds zum Datentyp finden ​ im Handbuch unter „Definieren von Feldern in der“.

Der Datentyp Restaurant erfordert ein Zeichenfolgenfeld, das den Namen des Restaurants darstellt. Daher wird der Field name als „Name“ und der Type als "String" festgelegt. Wählen Sie Apply aus, um die Änderungen auf das Feld anzuwenden.

Fügen Sie dem Datentyp nach Bedarf weitere Felder hinzu. Der Datentyp „Beispiel-Restaurant“ verfügt jetzt über zusätzliche Felder für die Marke, die Sitzplatzkapazität und die Bodenfläche.

Zusätzlich zu den grundlegenden Feldern können Sie auch zusätzliche Datentypen in Ihrem benutzerdefinierten Datentyp verschachteln. Der Datentyp Restaurant erfordert beispielsweise ein Feld, das die physische Adresse der Eigenschaft darstellt. In diesem Szenario können Sie ein neues Feld „Adresse“ hinzufügen, dem der Standarddatentyp "Postal address" zugewiesen ist.

Dies zeigt, wie flexibel Datentypen in Bezug auf die Beschreibung Ihrer Daten sein können: Datentypen können Felder verwenden, die auch Datentypen sind, die selbst weitere Datentypen enthalten können usw. Auf diese Weise können Sie gängige Datenmuster in Ihren XDM-Schemata abstrahieren und wiederverwenden, was die Darstellung komplexer Datenstrukturen erleichtert.

Nachdem Sie dem Datentyp Felder hinzugefügt haben, wählen Sie Save aus, um Ihre Änderungen zu speichern und den Datentyp zum Schema Library hinzuzufügen.

Hinzufügen des Datentyps zu einem Schema add-data-type

Nachdem Sie einen Datentyp erstellt haben, können Sie ihn in Ihren Schemata verwenden. Da XDM-Schemata aus einer Klasse und keiner oder mehreren Feldergruppen bestehen, können von einem Datentyp bereitgestellte Felder nicht direkt zu einem Schema hinzugefügt werden. Stattdessen müssen sie in eine Klasse oder Feldergruppe aufgenommen werden.

Führen Sie zunächst die Schritte aus, die mit dem Hinzufügen eines Felds zu einer ​ oder Hinzufügen eines Felds zu einer Feldergruppe“ ​ sind. Alternativ können Sie mit dem Hinzufügen eines Felds direkt zu einem Schema beginnen und dort die übergeordnete Klasse oder Feldergruppe auswählen. Wenn Sie die Type für das neue Feld auswählen, wählen Sie den Namen Ihres Datentyps aus dem Dropdown-Menü aus.

Konvertieren eines Objekts mit mehreren Feldern in einen Datentyp convert

Wenn Sie ein Feld vom Typ „Objekt“ mit mehreren Unterfeldern im Schema Editor erstellen, können Sie dieses Feld in einen Datentyp konvertieren, damit Sie dieselbe Feldstruktur in einer anderen Klasse oder Feldergruppe verwenden können.

Um ein Feld vom Typ „Objekt“ in einen Datentyp zu konvertieren, wählen Sie das Feld auf der Arbeitsfläche aus. Bevor Sie das Feld konvertieren, stellen Sie sicher, dass die Display name die Daten beschreibt, die das Objekt enthalten wird, da dies der Name des Datentyps wird. Wenn Sie bereit sind, das Feld zu konvertieren, wählen Sie Convert to new data type in der rechten Leiste aus.

Die Arbeitsfläche aktualisiert den Datentyp des Felds von "Object" auf den neuen Datentyp. Diese Struktur kann jetzt in anderen Klassen und Feldergruppen wiederverwendet werden, indem dieser Datentyp beim Definieren eines neuen Felds aus dem Dropdown-Menü "Type" ausgewählt wird.

Nächste Schritte next-steps

In diesem Handbuch wurde beschrieben, wie Sie Datentypen mithilfe der Experience Platform-Benutzeroberfläche erstellen und bearbeiten. Weiterführende Informationen zu den Funktionen von Schemas Workspace finden Sie in der Übersicht zu Schemas Workspace ​.

Informationen zum Verwalten von Datentypen mit der Schema Registry-API finden Sie im Handbuch zu Datentypendpunkten.