Definieren von XDM-Feldern in der Benutzeroberfläche

Mit dem Wert "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 in 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.

Ressource auswählen, der Felder hinzugefügt werden sollen select-resource

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

Sobald Sie die Schema Editor geöffnet haben, werden Steuerelemente zum Hinzufügen 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.

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 das Feld definiert werden soll.

Je nachdem, ob Sie ein Feld direkt zu einem Schema oder seiner zugehörigen Klasse und Feldergruppen hinzufügen, variieren die erforderlichen Schritte zum Hinzufügen des Felds. Der Rest dieses Dokuments konzentriert sich auf die Konfiguration der Eigenschaften eines Felds, unabhängig davon, wo dieses Feld im Schema erscheint. Weiterführende Informationen zu den verschiedenen Methoden zum Hinzufügen von Feldern zu einem Schema finden Sie in den folgenden Abschnitten des Handbuchs zur Schemabenutzeroberfläche:

Definieren der Eigenschaften eines Felds define

Nach Auswahl des Symbols plus (+) wird auf der Arbeitsfläche ein Platzhalter für das Feld Unbenannt angezeigt.

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

Sie können auch für jedes Feld eine Beschreibung und Notizen angeben. Verwenden Sie das Feld Beschreibung , um Kontext hinzuzufügen und die Funktionalität des Zuordnungs-Datentyps zu beschreiben. Dies trägt zur Wartbarkeit und Lesbarkeit der Implementierung bei. Sie können auch Notizen hinzufügen, um die ursprüngliche Beschreibung zu ergänzen. Dies sollte detailliertere und spezifischere Informationen bieten, die Entwicklern dabei helfen, die Zuordnung im Kontext der Codebasis effektiv zu verstehen, zu verwalten und zu nutzen. |

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

Die Arbeitsfläche wird aktualisiert und zeigt das neu hinzugefügte Feld an, das sich in einem Objekt befindet, das mit Ihrer eindeutigen Mandanten-ID benannt ist (im Beispiel unten als _tenantId angezeigt). Alle benutzerdefinierten Felder, die einem Schema hinzugefügt werden, werden automatisch in diesen Namespace eingefügt, um Konflikte mit anderen Feldern von von Adobe-bereitgestellten Klassen und Feldergruppen zu vermeiden. 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.

Typspezifische Feldeigenschaften type-specific-properties

Beim Definieren eines neuen Felds werden in der rechten Leiste je nach dem für das Feld ausgewählten Typ zusätzliche Konfigurationsoptionen angezeigt. In der folgenden Tabelle sind diese zusätzlichen Feldeigenschaften zusammen mit den kompatiblen Typen aufgeführt:

Feldeigenschaft

Kompatible Typen

Beschreibung

Map value type

Landkarte

Die Eigenschaft Map value type wird nur dann in der Benutzeroberfläche angezeigt, wenn Sie den Wert Map aus den Dropdown-Optionen Typ auswählen. Sie können zwischen den Werttypen String und Integer für die Zuordnung auswählen.
{width="100" modal="regular"}
Hinweis: Alle über die API erstellten Zuordnungs-Datentypen, die weder vom Typ String noch vom Typ Integer sind, werden als Datentyp "Komplex"angezeigt. Über die Benutzeroberfläche können keine Datentypen vom Typ "Komplex"erstellt werden.

Muster

String

Ein regulärer Ausdruck , mit dem der Wert für dieses Feld übereinstimmen muss, damit er während der Aufnahme akzeptiert werden kann.

Format

String

Wählen Sie aus einer Liste vordefinierter Formate für Zeichenfolgen aus, denen der Wert entsprechen muss. Zu den verfügbaren Formaten gehören:

• date-time
• email
• hostname
• ipv4
• ipv6
• uri
• uri-reference
• url-template
• json-pointer

Mindestlänge

String

Die Mindestanzahl von Zeichen, die die Zeichenfolge enthalten muss, damit der Wert während der Aufnahme akzeptiert wird.

Maximale Länge

String

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 Beschränkung "Ausschließlicher 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 "Mindestwert" 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 "Maximaler Wert"(nicht exklusiv) Beschränkung leer gelassen werden.

Spezielle Feldtypen special

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, die Anleitung zum Definieren von Objekttypfeldern aufzurufen, 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 in der Übersicht über den Arbeitsbereich Schemas.