Definieren von XDM-Feldern in der Benutzeroberfläche

Mit der 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 Grundverständnis des XDM-Systems voraus. Unter XDM-Übersicht finden Sie eine Einführung in die Rolle von XDM im Experience Platform-Ökosystem und die Grundlagen der Schemakomposition um zu erfahren, wie Klassen und Feldergruppen Felder 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.

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 in der Schema Editor öffnen. Je nachdem, welche Schemata Ihnen derzeit im Schema Library zur Verfügung stehen, können Sie wählen, ein neues Schema erstellen oder ein vorhandenes Schema zur Bearbeitung auswählen.

Sobald die Schema Editor geöffnet ist, werden die 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“ aus, unter dem Sie das Feld definieren möchten.

Je nachdem, ob Sie ein Feld direkt zu einem Schema oder seinen konstituierenden Klassen- 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 angezeigt wird. Weitere Informationen zu den verschiedenen Möglichkeiten, wie Felder zu einem Schema hinzugefügt werden können, finden Sie in den folgenden Abschnitten im Handbuch zur Benutzeroberfläche für Schemata:

Definieren der Eigenschaften eines Felds define

Nach Auswahl des Symbols plus (+) wird auf Arbeitsfläche Platzhalter „Nicht benanntes Feld“ angezeigt.

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

Sie können auch eine Beschreibung und Anmerkungen für jedes Feld angeben. Verwenden Sie Feld Beschreibung“, um Kontext hinzuzufügen und die Funktionalität des Zuordnungsdatentyps zu beschreiben. Dies trägt zur Wartbarkeit und Lesbarkeit der Implementierung bei. Sie können auch Anmerkungen hinzufügen, um die ursprüngliche Beschreibung zu ergänzen. Dies sollte detailliertere und spezifischere Informationen bieten, die Entwicklern beim Verstehen, Pflegen und effektiven Nutzen der Zuordnung im Kontext der Codebasis helfen. |

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 gemäß Ihrer eindeutigen Mandanten-ID mit einem Namespace versehen ist (wie im _tenantId Beispiel unten gezeigt). Alle benutzerdefinierten Felder, die einem Schema hinzugefügt werden, werden automatisch in diesem Namespace platziert, um Konflikte mit anderen Feldern aus von Adobe bereitgestellten Klassen und Feldergruppen zu verhindern. In der rechten Leiste wird nun der Pfad des Felds zusätzlich zu seinen anderen Eigenschaften aufgeführt.

Sie können mit den oben genannten Schritten fortfahren, um dem Schema weitere Felder hinzuzufügen. Nach dem Speichern des Schemas werden auch dessen Basisklasse und Feldergruppen gespeichert, sofern Änderungen daran vorgenommen wurden.

Typspezifische Feldeigenschaften type-specific-properties

Beim Definieren eines neuen Felds können in der rechten Leiste zusätzliche Konfigurationsoptionen angezeigt werden, je nachdem, Sie Feld „Typ“ ausgewählt haben. In der folgenden Tabelle sind diese zusätzlichen Feldeigenschaften zusammen mit ihren kompatiblen Typen aufgeführt:

Feldeigenschaft

Kompatible Typen

Beschreibung

Zuordnungs-Werttyp

Landkarte

Die Eigenschaft ZuordnungsWerttyp wird nur in der Benutzeroberfläche angezeigt, wenn Sie den Zuordnungswert aus den Typ auswählen. Sie können für die Zuordnung zwischen den Werttypen „Zeichenfolge“ und „Ganzzahl“ wählen.
{width="100" modal="regular"}
Hinweis: Alle über die API erstellten Zuordnungsdatentypen, die weder vom Typ Zeichenfolge noch Ganzzahl sind, werden als Datentyp Komplex angezeigt. Datentypen vom Typ Komplex können nicht über die Benutzeroberfläche erstellt werden.

Muster

String

Ein regulärer Ausdruck dem der Wert für dieses Feld entsprechen muss, damit er bei der Aufnahme akzeptiert wird.

Format

String

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

• Datum-Uhrzeit
• email
• hostname
• IPv4
• IPv6
• URI
• URI-Referenz
• 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 Anzahl von Zeichen, die die Zeichenfolge enthalten muss, damit der Wert während der Aufnahme akzeptiert wird.

Mindestwert

Double

Der Mindestwert für den Double-Wert, der bei der Aufnahme akzeptiert werden soll. Wenn der aufgenommene Wert genau mit dem hier eingegebenen übereinstimmt, wird der Wert akzeptiert. Bei Verwendung dieser Einschränkung muss die Beschränkung Ohne Mindestwert leer bleiben.

Höchstwert

Double

Der Höchstwert für den Double-Wert, der bei der Aufnahme akzeptiert wird. Wenn der aufgenommene Wert genau mit dem hier eingegebenen übereinstimmt, wird der Wert akzeptiert. Bei Verwendung dieser Einschränkung muss die Beschränkung Ohne Maximalwert leer gelassen werden.

Ohne Mindestwert

Double

Der Höchstwert für den Double-Wert, der bei der Aufnahme akzeptiert wird. Wenn der aufgenommene Wert genau mit dem hier eingegebenen übereinstimmt, wird der Wert zurückgewiesen. Bei Verwendung dieser Einschränkung muss die Beschränkung Mindestwert (nicht ausschließlich) leer gelassen werden.

Ohne Maximalwert

Double

Der Höchstwert für den Double-Wert, der bei der Aufnahme akzeptiert wird. Wenn der aufgenommene Wert genau mit dem hier eingegebenen übereinstimmt, wird der Wert zurückgewiesen. Bei Verwendung dieser Einschränkung muss die Beschränkung Maximalwert (nicht exklusiv) leer gelassen werden.

Spezielle Feldtypen special

Die rechte Leiste enthält mehrere Kontrollkästchen zum Festlegen spezieller Rollen für das ausgewählte Feld. Die Anwendungsfälle für einige dieser Optionen beinhalten wichtige Überlegungen bezüglich Ihrer Datenmodellierungsstrategie und der Art und Weise, wie Sie nachgelagerte Platform-Services verwenden möchten.

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

Obwohl es sich technisch gesehen nicht um einen speziellen Feldtyp handelt, wird auch empfohlen, das Handbuch unter Definieren von Feldern vom Typ „Objekt zu lesen, um mehr über das Definieren verschachtelter Unterfelder Ihrer Schemastrukturen zu erfahren.

Nächste Schritte

Dieses Handbuch bietet einen Überblick darüber, wie XDM-Felder in der Benutzeroberfläche definiert werden. Denken Sie daran, dass Felder nur mithilfe von Klassen und Feldergruppen zu Schemata 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 Klassen und Feldergruppen.

Weitere Informationen zu den Funktionen des Arbeitsbereichs Schemata finden Sie unter Schemata Arbeitsbereich - Übersicht.