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. Auch wenn sie Schemafeldgruppen insofern ähneln, als sie die konsistente Verwendung einer Mehrfeld-Struktur ermöglichen, sind Datentypen 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 das Erlebnismanagement abgedeckt werden kann. Sie können jedoch auch eigene benutzerdefinierte Datentypen definieren, um Ihren individuellen Geschäftsanforderungen gerecht zu werden.

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

Voraussetzungen prerequisites

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

Für dieses Handbuch ist zwar nicht erforderlich, Sie sollten jedoch auch das Tutorial zum Erstellen eines Schemas in der Benutzeroberfläche 🔗 befolgen, um sich mit den verschiedenen Funktionen von Schema Editor vertraut zu machen.

Öffnen Sie den Schema Editor für einen Datentyp. data-type

Wählen Sie in der Platform-Benutzeroberfläche im linken Navigationsbereich Schemas aus, um den Arbeitsbereich Schemas zu öffnen, und wählen Sie dann die Registerkarte Datentypen aus. Eine Liste der verfügbaren Datentypen wird angezeigt. Die Liste der Datentypen wird automatisch nach ihrer Erstellung gefiltert. Die Standardeinstellung zeigt die durch Adobe definierten Datentypen an. Sie können die Liste auch filtern, um die von Ihrer Organisation erstellten anzuzeigen.

Von hier aus haben Sie die folgenden Optionen:

Neuen Datentyp erstellen create

Wählen Sie auf der Registerkarte Datentypen die Option Datentyp erstellen aus.

Der 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 präzisen Namen für Ihren Datentyp angeben, da dieser beim Hinzufügen zu einem Schema identifiziert wird.

In diesem Tutorial wird ein Datentyp erstellt, der eine Restauranteigenschaft beschreibt, sodass der Datentyp den Anzeigenamen "Restaurant"erhält.

Von hier aus können Sie zum nächsten Abschnitt 1} überspringen, um Felder zum neuen Datentyp hinzuzufügen.

Datentypen filtern 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 von Adobe erstellte Entitäten und die Option Benutzerdefiniert zeigt Entitäten an, die innerhalb Ihres Unternehmens erstellt wurden.

Vorhandenen Datentyp bearbeiten edit

Es können nur benutzerdefinierte Datentypen bearbeitet werden, die von Ihrem Unternehmen definiert wurden. Wählen Sie Benutzerdefiniert aus, um nur benutzerdefinierte Datentypen anzuzeigen, die sich im Besitz Ihrer Organisation befinden.

Wählen Sie in der Liste den zu bearbeitenden Datentyp aus, um die rechte Leiste mit Details zum Datentyp 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 in der Schema Editor zu öffnen.

Felder zum Datentyp hinzufügen add-fields

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

Konfigurieren Sie mithilfe der Steuerelemente in der rechten Leiste die Details des neuen Felds. Spezifische Schritte zum Konfigurieren und Hinzufügen des Felds zum Datentyp finden Sie im Handbuch zu Definieren von Feldern in der Benutzeroberfläche .

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 Anwenden aus, um die Änderungen auf das Feld anzuwenden.

Fügen Sie dem Datentyp nach Bedarf weitere Felder hinzu. Der Beispieldatentyp Restaurant enthält jetzt zusätzliche Felder für Marke, Sitzkapazität und Bodenfläche.

Zusätzlich zu den grundlegenden Feldern können Sie auch zusätzliche Datentypen in Ihrem benutzerdefinierten Datentyp verschachteln. Beispielsweise erfordert der Datentyp Restaurant 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"zugewiesen ist.

Dies zeigt, wie flexible Datentypen in Bezug auf die Beschreibung Ihrer Daten sein können: Datentypen können Felder verwenden, die auch Datentypen sind, die wiederum weitere Datentypen enthalten können usw. Auf diese Weise können Sie allgemeine Datenmuster in Ihren XDM-Schemas abstrahieren und wiederverwenden, um die Darstellung komplexer Datenstrukturen zu vereinfachen.

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

Datentyp zu einem Schema hinzufügen add-data-type

Nachdem Sie einen Datentyp erstellt haben, können Sie ihn in Ihren Schemata verwenden. Da XDM-Schemas aus einer Klasse und null oder mehr Feldgruppen 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 eingeschlossen sein.

Führen Sie zunächst die Schritte aus, die mit dem Hinzufügen eines Felds zu einer Klasse 🔗 oder mit dem Hinzufügen eines Felds zu einer Feldergruppe 🔗 durch erforderlich sind. Alternativ können Sie ein Feld direkt zu einem Schema hinzufügen und die übergeordnete Klasse oder Feldergruppe von dort 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 in der Schema Editor erstellen, können Sie dieses Feld in einen Datentyp konvertieren, sodass 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 die Daten beschreibt, die das Objekt enthalten wird, da dies zum Namen des Datentyps wird. Wenn Sie bereit sind, das Feld zu konvertieren, wählen Sie in der rechten Leiste die Option In neuen Datentyp konvertieren 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 Sie diesen Datentyp beim Definieren eines neuen Felds aus der Dropdown-Liste Typ auswählen.

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 Schemas finden Sie in der Übersicht über den Arbeitsbereich Schemas.

Informationen zum Verwalten von Datentypen mithilfe der Schema Registry -API finden Sie im Endpunkthandbuch zu Datentypen.