Definieren von XDM-Feldern in der Benutzeroberfläche

Letzte Aktualisierung: 2023-11-14
  • Themen:
  • Schemas
    Weitere Informationen zu diesem Thema
  • Erstellt für:
  • Developer
    User
    Admin
    Leader

Die Schema Editor In der Benutzeroberfläche von Adobe Experience Platform 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. Siehe Abschnitt XDM-Übersicht für eine Einführung in die Rolle von XDM im Experience Platform-Ökosystem und Grundlagen der Schemakomposition um zu erfahren, wie Klassen und Feldergruppen Felder 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.

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

Um neue XDM-Felder in der Benutzeroberfläche zu definieren, müssen Sie zunächst ein Schema innerhalb der Schema Editor. Je nachdem, welche Schemas Ihnen derzeit im Schema Library, können Sie Erstellen eines neuen Schemas oder ein vorhandenes Schema zur Bearbeitung auswählen.

Sobald Sie Schema Editor geöffnet, 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.

WARNUNG

Wenn Sie versuchen, ein Feld zu einem Objekt hinzuzufügen, das von einer Standardfeldgruppe bereitgestellt wird, wird diese Feldergruppe in eine benutzerdefinierte Feldergruppe konvertiert und die ursprüngliche Feldergruppe ist nicht mehr verfügbar. Siehe Abschnitt zu Felder zu Standardfeldgruppen hinzufügen Weitere Informationen finden Sie im Handbuch zur Schemabenutzeroberfläche .

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

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

Nach Auswahl der plus (+) -Symbol, ein Unbenanntes Feld Platzhalter wird in der Arbeitsfläche angezeigt.

Rechts unter Feldeigenschaften können Sie die Details des neuen Felds 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. Dieser Wert dient zur Identifizierung und Referenzierung des Felds im Code und in anderen nachgelagerten Anwendungen

Der Name sollte idealerweise in camelCase geschrieben werden. Sie kann alphanumerische Zeichen, Bindestriche oder Unterstriche enthalten, sie enthält jedoch darf nicht Beginnen Sie mit einem Unterstrich.
  • Richtig: fieldName
  • Zulässig: field_name2, Field-Name, field-name_3
  • Falsch: _fieldName
Anzeigename Ein Anzeigename für das Feld. Dies ist der Name, mit dem das Feld auf der Arbeitsfläche des Schema-Editors dargestellt wird. Der Feldname kann mithilfe der Umschalter für Anzeigenamen.
Typ Der Datentyp, den das Feld enthalten soll. In diesem Dropdown-Menü können Sie eine der Standard-Skalartypen unterstützt von XDM oder einem der Mehrfachfelder Datentypen die zuvor in der Schema Registry.

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

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

HINWEIS

Je nach Typ Wenn Sie für das Feld ausgewählt haben, werden in der rechten Leiste möglicherweise zusätzliche Konfigurationssteuerelemente angezeigt. Siehe Abschnitt zu Typspezifische Feldeigenschaften für weitere Informationen zu diesen Steuerelementen.

Die rechte Leiste bietet außerdem Kontrollkästchen für die Bezeichnung spezieller Feldtypen. Siehe Abschnitt zu spezielle Feldtypen für weitere Informationen.

Wählen Sie nach der Konfiguration des Felds Anwenden.

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 (angezeigt als _tenantId im Beispiel unten). 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.

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 je nach der Typ wählen Sie für das Feld aus. In der folgenden Tabelle sind diese zusätzlichen Feldeigenschaften zusammen mit den kompatiblen Typen aufgeführt:

Feldeigenschaft Kompatible Typen Beschreibung
Standardwert Zeichenfolge, Double, Lang, Ganzzahl, Short, Byte, Boolesch Ein Standardwert, der diesem Feld zugewiesen wird, wenn während der Erfassung kein anderer Wert angegeben wird. Dieser Wert muss dem ausgewählten Feldtyp entsprechen.

Die Standardwerte werden zum Zeitpunkt der Aufnahme nicht im Datensatz gespeichert, da sie sich im Laufe der Zeit ändern können. Die im Schema festgelegten Standardwerte werden von nachgelagerten Platform-Diensten und -Anwendungen abgeleitet, wenn sie die Daten aus dem Datensatz lesen. Wenn das Attribut beispielsweise bei der Abfrage der Daten mit Query Service einen NULL-Wert hat, der Standardwert jedoch auf 5 auf Schemaebene wird erwartet, dass Query Service 5 anstelle von NULL. Beachten Sie, dass dieses Verhalten derzeit nicht für alle AEP-Dienste einheitlich ist.
Muster String A regulärer Ausdruck dass 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:
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 wird der WertAusschließlicher Mindestwert"Beschränkung muss 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 wird der WertExklusiver Maximalwert"Beschränkung muss 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 Beschränkung wird der WertMindestwert"(Nicht-exklusive) Beschränkung muss 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 Beschränkung wird der WertHöchstwert"(Nicht-exklusive) Beschränkung muss 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 zu Definieren von Objekttypfeldern , 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 classes und Feldergruppen.

Weitere Informationen zu den Funktionen der Schemas Arbeitsbereich, siehe Schemas Arbeitsbereich - Übersicht.

Auf dieser Seite