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.

Der Schema-Editor mit den hervorgehobenen Symbolen zum Hinzufügen.

WARNING
Wenn Sie versuchen, ein Feld zu einem Objekt hinzuzufügen, das von einer Standardfeldgruppe bereitgestellt wird, wird diese Feldgruppe in eine benutzerdefinierte Feldgruppe konvertiert und die ursprüngliche Feldgruppe ist nicht mehr verfügbar. Weitere Informationen finden Sie Abschnitt zum Hinzufügen von Feldern zu StandardfeldgruppenHandbuch zur Benutzeroberfläche von Schemata .

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.

Der Schema-Editor mit einem hervorgehobenen Hinzufügen-Symbol.

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.

Der Schema-Editor mit einem neuen, nicht benannten Feld wurde hervorgehoben.

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

Feldeigenschaft
Beschreibung
Feldname

Ein eindeutiger, beschreibender Name für das Feld. Beachten Sie, dass der Name des Felds nach dem Speichern des Schemas nicht mehr geändert werden kann. Dieser Wert wird verwendet, um das Feld im Code und in anderen nachgelagerten Anwendungen zu identifizieren und darauf

verweisen. Der Name sollte idealerweise in Binnenmajuskel-Schreibweise geschrieben werden. Sie kann alphanumerische Zeichen, Bindestriche oder Unterstriche enthalten, darf jedoch nicht mit einem Unterstrich beginnen.

  • Richtig: fieldName
  • Akzeptiert: field_name2, Field-Name, field-name_3
  • Falsch: _fieldName
Anzeigename
Ein Anzeigename für das Feld. Dies ist der Name, der zur Darstellung des Felds auf der Arbeitsfläche des Schema-Editors verwendet wird. Der Feldname kann mithilfe des Umschalters für den Anzeigenamen in Anzeigenamen geändert.
Typ
Der Typ der Daten, die das Feld enthalten soll. Aus diesem Dropdown-Menü können Sie einen der standardmäßigen Skalartypen die von XDM unterstützt werden, oder einen der Mehrfeld-Datentypen auswählen, die zuvor in der Schema Registry definiert wurden.
Hinweis: Wenn Sie den Datentyp Zuordnung auswählen, wird ​ Eigenschaft "" angezeigt.

Sie können auch Erweiterte Typsuche auswählen, um vorhandene Datentypen zu suchen und zu filtern und den gewünschten Typ leichter zu finden.
Zuordnungs-Werttyp
Dieser Wert ist erforderlich, wenn Sie Zuordnung als Datentyp für das Feld auswählen. Verfügbare Werte für die Zuordnung sind Zeichenfolge und Ganzzahl. Wählen Sie einen Wert aus der Dropdown-Liste der verfügbaren Optionen aus.
Weitere Informationen zu typspezifischen Feldeigenschaften finden Sie in der Übersicht zum Definieren von Feldern .

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. |

NOTE
Je nach dem Feld Typ“ werden in der rechten Leiste möglicherweise zusätzliche Konfigurationssteuerelemente angezeigt. Weitere Informationen zu Steuerelementen finden Sie im AbschnittTypspezifische Feldeigenschaften“.
Die rechte Leiste enthält auch Kontrollkästchen zum Festlegen spezieller Feldtypen. Weitere Informationen finden Sie AbschnittSpezielle Feldtypen“.

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

Der Feldeigenschaften im Schema-Editor ist hervorgehoben.

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.

Ein neues Feld im Schemadiagramm und der entsprechende Pfad im Abschnitt Feldeigenschaften ist hervorgehoben.

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.

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

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.
Der Schemaeditor mit den hervorgehobenen Feldern Typ und Zuordnungswerttyp. {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:

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.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07