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 Platform-Benutzeroberfläche beschrieben.

Voraussetzungen prerequisites

Dieses Handbuch setzt ein Grundverständnis des XDM-Systems voraus. Im Abschnitt 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

Wählen Sie in der Platform Benutzeroberfläche im linken Navigationsbereich die Option Schemata​ aus, um den Arbeitsbereich Schemata zu öffnen. Wählen Sie dann die Registerkarte Datentypen 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 vom 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 Datentypen die Option Datentyp erstellen 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 Benutzerdefiniert zu wählen. Die Option Standard zeigt Entitäten an, die durch Adobe erstellt wurden, und die Option Benutzerdefiniert 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 Benutzerdefiniert 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 findenim Handbuch unter „Definieren von Feldern in der“.

Der Datentyp Restaurant erfordert ein Zeichenfolgenfeld, das den Namen des Restaurants darstellt. Daher wird der Feldname als „Name“ und der Typ als "String" festgelegt. Wählen Sie Übernehmen 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 "Postanschrift“ ​ 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, klicken Sie auf Speichern, 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 eineroder 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 den Typ 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. Stellen Sie vor dem Konvertieren des Felds sicher dass der Anzeigename) für die Daten beschreibend ist, die das Objekt enthalten wird, da dies zum Namen des Datentyps wird. Wenn Sie bereit sind, das Feld zu konvertieren, wählen Sie In neuen Datentyp konvertieren in der rechten Leiste aus.

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

Nächste Schritte next-steps

In diesem Handbuch wurde beschrieben, wie Sie Datentypen mithilfe der Platform-Benutzeroberfläche erstellen und bearbeiten. Weitere Informationen zu den Funktionen des Arbeitsbereichs Schemata finden Sie unter Schemata Arbeitsbereich - Übersicht.

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