Definieren von XDM-Feldern in der Benutzeroberfläche

Mit Schema Editor in der Adobe Experience Platform-Benutzeroberfläche können Sie Ihre eigenen Felder in benutzerdefinierten Experience-Datenmodell (XDM)-Klassen und Schemafeldgruppen definieren. In diesem Handbuch werden die Schritte zum Definieren von XDM-Feldern in der Benutzeroberfläche beschrieben, einschließlich der verfügbaren Konfigurationsoptionen für jeden Feldtyp.

Voraussetzungen

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 den Grundlagen der Schemakomposition , um zu erfahren, wie Klassen und Feldgruppen Felder 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.

Wählen Sie eine Ressource aus, um Felder zu hinzuzufügen.

Um neue XDM-Felder in der Benutzeroberfläche zu definieren, müssen Sie zunächst ein Schema innerhalb von Schema Editor öffnen. Je nachdem, welche Schemas Ihnen derzeit im Schema Library zur Verfügung stehen, können Sie ein neues Schema oder erstellen und ein vorhandenes Schema auswählen, um zu bearbeiten.

Sobald Sie Schema Editor geöffnet haben, wählen Sie in der linken Leiste die Klasse oder Feldergruppe aus, für die Sie Felder definieren möchten. Wenn es sich bei der Ressource um eine von Ihrer Organisation definierte benutzerdefinierte Ressource handelt, werden Steuerelemente zum Hinzufügen oder Bearbeiten von Feldern auf der Arbeitsfläche angezeigt. Diese Steuerelemente werden neben dem Namen des Schemas sowie allen Feldern vom Typ Objekt angezeigt, die unter der ausgewählten Klasse oder Feldergruppe definiert wurden.

HINWEIS

Wenn es sich bei der ausgewählten Klasse oder Feldergruppe um eine von Adobe bereitgestellte Kernressource handelt, kann sie nicht bearbeitet werden. Daher werden die oben gezeigten Steuerelemente nicht angezeigt. Wenn das Schema, dem Sie Felder hinzufügen möchten, auf einer Kern-XDM-Klasse basiert und keine benutzerdefinierten Feldergruppen enthält, können Sie eine neue Feldergruppe erstellen, um sie stattdessen dem Schema hinzuzufügen.

Um der Ressource ein neues Feld hinzuzufügen, wählen Sie auf der Arbeitsfläche das Symbol plus (+) neben dem Namen des Schemas oder neben dem Feld vom Typ Objekt, unter dem Sie das Feld definieren möchten.

Feld für eine Ressource definieren

Nach Auswahl des Symbols plus (+) erscheint auf der Arbeitsfläche ein Neues Feld, das sich in einem Objekt auf der Stammebene befindet, das mit Ihrer eindeutigen Mandanten-ID benannt ist (im Beispiel unten unter _tenantId dargestellt). Alle Felder, die über benutzerdefinierte Klassen und Feldergruppen zu einem Schema hinzugefügt werden, werden automatisch in diesen Namespace eingefügt, um Konflikte mit anderen Feldern aus von der Adobe bereitgestellten Klassen und Feldergruppen zu vermeiden.

In der rechten Leiste unter Feldeigenschaften können Sie die Details der neuen Felder konfigurieren. Für jedes Feld sind folgende Informationen erforderlich:

Feldeigenschaft Beschreibung
Feldname Ein eindeutiger, beschreibender Name für das Feld. Beachten Sie, dass der Feldname nach dem Speichern des Schemas nicht mehr geändert werden kann.

Der Name sollte idealerweise in camelCase geschrieben werden. Es kann alphanumerische Zeichen, Bindestriche oder Unterstriche enthalten, darf jedoch nicht mit einem Unterstrich beginnen.
  • Richtig: fieldName
  • Zulässig: field_name2, Field-Name, field-name_3
  • Falsch: _fieldName
Anzeigename Ein benutzerfreundlicher Name für das Feld.
Typ Der Datentyp, den das Feld enthalten soll. In diesem Dropdown-Menü können Sie einen der standardmäßigen Skalartypen auswählen, die von XDM unterstützt werden, oder einen der mehrfeldigen Datentypen, die zuvor in Schema Registry definiert wurden.

Sie können auch Erweiterte Typsuche auswählen, um vorhandene Datentypen zu suchen und zu filtern und den gewünschten Typ leichter zu finden.

Sie können dem Feld auch eine optionale, für Menschen lesbare Beschreibung bereitstellen, um mehr Kontext für den vorgesehenen Anwendungsfall des Felds bereitzustellen.

HINWEIS

Je nachdem, welchen Typ Sie für das Feld ausgewählt haben, werden in der rechten Leiste möglicherweise zusätzliche Konfigurationssteuerelemente angezeigt. Weitere Informationen zu diesen Steuerelementen finden Sie im Abschnitt Typspezifische Feldeigenschaften .

Die rechte Leiste bietet außerdem Kontrollkästchen für die Bezeichnung spezieller Feldtypen. Weitere Informationen finden Sie im Abschnitt Spezielle Feldtypen .

Nachdem Sie die Konfiguration des Felds abgeschlossen haben, wählen Sie Anwenden aus.

Die Arbeitsfläche wird aktualisiert, um den Namen und Typ des Felds anzuzeigen. In der rechten Leiste wird jetzt der Pfad des Felds zusätzlich zu den anderen Eigenschaften aufgelistet.

Sie können die oben beschriebenen Schritte fortsetzen, um dem Schema weitere Felder hinzuzufügen. Nach dem Speichern des Schemas werden seine Basisklasse und Feldgruppen auch dann gespeichert, wenn Änderungen an ihnen vorgenommen wurden.

HINWEIS

Alle Änderungen, die Sie an den Feldergruppen oder der Klasse eines Schemas vornehmen, werden in allen anderen Schemas übernommen, die sie anwenden.

Typspezifische Feldeigenschaften

Bei der Definition eines neuen Felds werden in der rechten Leiste je nach Typ, den Sie für das Feld auswählen, möglicherweise zusätzliche Konfigurationsoptionen angezeigt. In der folgenden Tabelle sind diese zusätzlichen Feldeigenschaften zusammen mit den kompatiblen Typen aufgeführt:

Feldeigenschaft Kompatible Typen Beschreibung
Standardwert String, Double, Long, Integer, Short, Byte, Boolean Ein Standardwert, der diesem Feld zugewiesen wird, wenn während der Aufnahme kein anderer Wert angegeben wird. Dieser Wert muss dem ausgewählten Feldtyp entsprechen.
Muster Zeichenfolge Ein regulärer Ausdruck , dem der Wert für dieses Feld entsprechen muss, damit er während der Aufnahme akzeptiert werden kann.
Format Zeichenfolge Wählen Sie aus einer Liste vordefinierter Formate für Zeichenfolgen aus, denen der Wert entsprechen muss. Zu den verfügbaren Formaten gehören:
Mindestlänge Zeichenfolge Die Mindestanzahl von Zeichen, die die Zeichenfolge enthalten muss, damit der Wert während der Aufnahme akzeptiert wird.
Maximale Länge Zeichenfolge Die maximale Zeichenanzahl, die die Zeichenfolge enthalten muss, damit der Wert während der Aufnahme akzeptiert werden kann.
Mindestwert Double Der Mindestwert für das Double, das bei der Aufnahme akzeptiert werden soll. Wenn der erfasste Wert exakt mit dem hier eingegebenen Wert übereinstimmt, wird der Wert akzeptiert. Bei Verwendung dieser Beschränkung muss die Beschränkung "Ausschließlicher Mindestwert"leer gelassen werden.
Höchstwert Double Der Maximalwert für das Double, das bei der Erfassung akzeptiert werden soll. Wenn der erfasste Wert exakt mit dem hier eingegebenen Wert übereinstimmt, wird der Wert akzeptiert. Bei Verwendung dieser Beschränkung muss die Begrenzung "Exklusiver Maximalwert"leer gelassen werden.
Ausschließlicher Mindestwert Double Der Maximalwert für das Double, das bei der Erfassung akzeptiert werden soll. Wenn der erfasste Wert exakt mit dem hier eingegebenen Wert übereinstimmt, wird der Wert zurückgewiesen. Bei Verwendung dieser Einschränkung muss die (nicht exklusive) Beschränkung "Minimaler Wert"leer gelassen werden.
Exklusiver Maximalwert Double Der Maximalwert für das Double, das bei der Erfassung akzeptiert werden soll. Wenn der erfasste Wert exakt mit dem hier eingegebenen Wert übereinstimmt, wird der Wert zurückgewiesen. Bei Verwendung dieser Einschränkung muss die (nicht exklusive) Beschränkung "Maximaler Wert"leer gelassen werden.

Spezielle Feldtypen

Die rechte Leiste enthält mehrere Kontrollkästchen, mit denen Sie spezielle Rollen für das ausgewählte Feld festlegen können. Die Anwendungsfälle für einige dieser Optionen beinhalten wichtige Aspekte in Bezug auf Ihre Datenmodellierungsstrategie und die beabsichtigte Verwendung nachgelagerter Platform-Dienste.

Weitere Informationen zu diesen speziellen Typen finden Sie in der folgenden Dokumentation:

Obwohl es sich technisch nicht um einen speziellen Feldtyp handelt, wird empfohlen, das Handbuch Definieren von Objekttypfeldern zu besuchen, um mehr über das Definieren verschachtelter Unterfelder zu erfahren, wenn Ihre Schemastrukturen vorhanden sind.

Nächste Schritte

Dieses Handbuch bietet einen Überblick darüber, wie XDM-Felder in der Benutzeroberfläche definiert werden. Beachten Sie, dass Felder nur mithilfe von Klassen und Feldergruppen zu Schemas hinzugefügt werden können. Weitere Informationen zum Verwalten dieser Ressourcen in der Benutzeroberfläche finden Sie in den Handbüchern zum Erstellen und Bearbeiten von Klassen und Feldergruppen.

Weitere Informationen zu den Funktionen des Arbeitsbereichs Schemas finden Sie unter Schemas Workspace - Übersicht.

Auf dieser Seite