Erstellen und Bearbeiten von Klassen in der Benutzeroberfläche

Im Experience-Datenmodell (XDM) definieren Klassen die verhaltensbezogenen Aspekte der Daten, die ein Schema enthalten wird (Datensatz oder Zeitreihen). Darüber hinaus beschreiben Klassen die kleinste Anzahl gemeinsamer Eigenschaften, die alle Schemas, die auf dieser Klasse basieren, beinhalten müssen, und bieten eine Möglichkeit zum Zusammenführen mehrerer kompatibler Datensätze.

Adobe bietet mehrere Standard-XDM-Klassen ("Core"), darunter XDM Individual Profile und XDM ExperienceEvent. Zusätzlich zu diesen Core-Klassen können Sie auch eigene benutzerdefinierte Klassen erstellen, um spezifischere Anwendungsfälle für Ihr Unternehmen zu beschreiben.

Dieses Dokument bietet einen Überblick darüber, wie Sie benutzerdefinierte Klassen in der Adobe Experience Platform-Benutzeroberfläche erstellen, bearbeiten und verwalten.

Voraussetzungen

Dieses Handbuch setzt ein Verständnis des XDM-Systems voraus. Siehe Abschnitt XDM-Übersicht für eine Einführung in die Rolle von XDM im Experience Platform-Ökosystem und die Grundlagen der Schemakomposition , um zu erfahren, wie Klassen zu XDM-Schemas beitragen.

Für dieses Handbuch ist zwar nicht erforderlich, es wird jedoch empfohlen, auch das Tutorial zu Erstellen eines Schemas in der Benutzeroberfläche sich mit den verschiedenen Fähigkeiten der Schema Editor.

Neue Klasse erstellen

Im Schemas Arbeitsbereich, wählen Sie Schema erstellen, wählen Sie Durchsuchen aus dem Dropdown-Menü aus.

Es wird ein Dialogfeld angezeigt, in dem Sie aus einer Liste verfügbarer Klassen auswählen können. Wählen Sie oben im Dialogfeld die Option Neue Klasse erstellen. Anschließend können Sie Ihrer neuen Klasse einen Anzeigenamen (einen kurzen, beschreibenden, eindeutigen und benutzerfreundlichen Namen für die Klasse), eine Beschreibung und ein Verhalten für die Daten geben, die das Schema definieren wird ("Datensatz" oder "Zeitreihen").

Wenn Sie fertig sind, wählen Sie Klasse zuweisen.

Die Schema Editor angezeigt wird, wird ein neues Schema auf der Arbeitsfläche angezeigt, das auf der soeben erstellten benutzerdefinierten Klasse basiert. Da der Klasse noch keine Felder hinzugefügt wurden, enthält das Schema nur eine _id -Feld, das die systemgenerierte eindeutige Kennung darstellt, die automatisch auf alle Ressourcen im Schema Registry.

WICHTIG

Denken Sie beim Erstellen eines Schemas, das eine von Ihrem Unternehmen definierte Klasse implementiert, daran, dass Schemafeldgruppen nur für kompatible Klassen verfügbar sind. Da die von Ihnen definierte Klasse neu ist, sind keine kompatiblen Feldergruppen in der Feldergruppe hinzufügen angezeigt. Stattdessen müssen Sie Erstellen neuer Feldergruppen zur Verwendung mit dieser Klasse. Wenn Sie das nächste Mal ein Schema erstellen, das die neue Klasse implementiert, werden die von Ihnen definierten Feldergruppen aufgelistet und zur Verwendung verfügbar.

Sie können jetzt beginnen Hinzufügen von Feldern zur Klasse, das von allen Schemas gemeinsam genutzt wird, die die Klasse verwenden.

Vorhandene Klasse bearbeiten

WICHTIG

Benutzerdefinierte Klassen, die nach dem 30. April 2022 erstellt wurden, können nicht direkt bearbeitet werden. Eine Korrektur befindet sich derzeit in der Entwicklung. Als Problemumgehung können Sie Erstellen einer benutzerdefinierten Feldergruppe und verwenden Sie es für jedes Schema erneut, das die benutzerdefinierte Klasse verwendet, die Sie erweitern möchten. Benutzerdefinierte Klassen, die vor dem 30. April 2022 erstellt wurden, sind von dieser Einschränkung nicht betroffen.

HINWEIS

Nur benutzerdefinierte Klassen, die von Ihrem Unternehmen definiert wurden, können vollständig bearbeitet und angepasst werden. Für von Adobe definierte Hauptklassen können nur die Anzeigenamen für ihre Felder im Kontext einzelner Schemas bearbeitet werden. Siehe Abschnitt zu Bearbeiten von Anzeigenamen für Schemafelder für Details.

Sobald eine benutzerdefinierte Klasse gespeichert und bei der Datenerfassung verwendet wurde, können danach nur noch additive Änderungen daran vorgenommen werden. Siehe Regeln der Schemaentwicklung für weitere Informationen.

Um eine vorhandene Klasse zu bearbeiten, wählen Sie die Durchsuchen und wählen Sie dann den Namen eines Schemas aus, das die zu bearbeitende Klasse verwendet.

TIPP

Sie können die Such- und Filterfunktionen des Arbeitsbereichs verwenden, um das Schema leichter zu finden. Siehe Handbuch unter Erkunden von XDM-Ressourcen für weitere Informationen.

Die Schema Editor angezeigt, wobei die Struktur des Schemas auf der Arbeitsfläche angezeigt wird. Sie können jetzt beginnen Hinzufügen von Feldern zur Klasse.

Felder zu einer Klasse hinzufügen

WICHTIG

Benutzerdefinierte Klassen, die nach dem 30. April 2022 erstellt wurden, können nicht direkt bearbeitet werden. Eine Korrektur befindet sich derzeit in der Entwicklung. Als Problemumgehung können Sie Erstellen einer benutzerdefinierten Feldergruppe und verwenden Sie es für jedes Schema erneut, das die benutzerdefinierte Klasse verwendet, die Sie erweitern möchten. Benutzerdefinierte Klassen, die vor dem 30. April 2022 erstellt wurden, sind von dieser Einschränkung nicht betroffen.

Sobald Sie über ein Schema verfügen, das eine benutzerdefinierte Klasse verwendet, öffnen Sie im Schema Editorkönnen Sie damit beginnen, der Klasse Felder hinzuzufügen. Um ein neues Feld hinzuzufügen, wählen Sie die plus (+) neben dem Namen des Schemas.

WICHTIG

Beachten Sie, dass alle Felder, die Sie zu einer Klasse hinzufügen, in allen Schemas verwendet werden, die diese Klasse verwenden. Daher sollten Sie sorgfältig überlegen, welche Felder in allen Anwendungsfällen des Schemas nützlich sein werden. Wenn Sie erwägen, ein Feld hinzuzufügen, das möglicherweise nur in einigen Schemas unter dieser Klasse verwendet wird, sollten Sie erwägen, es diesen Schemas hinzuzufügen, indem Sie Erstellen einer Feldergruppe anstatt.

A Neues Feld wird auf der Arbeitsfläche angezeigt und die rechte Leiste wird aktualisiert, um Steuerelemente zum Konfigurieren der Feldeigenschaften anzuzeigen. Siehe Handbuch unter Definieren von Feldern in der Benutzeroberfläche für spezifische Schritte zum Konfigurieren und Hinzufügen des Felds zur Klasse.

Fügen Sie der Klasse weiterhin beliebig viele Felder hinzu. Wenn Sie fertig sind, wählen Sie Speichern , um sowohl das Schema als auch die Klasse zu speichern.

Wenn Sie zuvor Schemas erstellt haben, die diese Klasse verwenden, werden die neu hinzugefügten Felder automatisch in diesen Schemata angezeigt.

Klasse eines Schemas ändern

Sie können die Klasse des Schemas jederzeit während des anfänglichen Erstellungsprozesses ändern, bevor es gespeichert wurde. Siehe Handbuch unter Erstellen und Bearbeiten von Schemata für weitere Informationen.

Nächste Schritte

In diesem Dokument wurde beschrieben, wie Klassen mithilfe der Platform-Benutzeroberfläche erstellt und bearbeitet werden. Weitere Informationen zu den Funktionen der Schemas Arbeitsbereich, siehe Schemas Arbeitsbereich - Übersicht.

Erfahren Sie, wie Sie Klassen mit dem Schema Registry API, siehe Endpunktleitfaden für Klassen.

Auf dieser Seite