Definieren von XDM-Feldern in der Benutzeroberfläche
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 select-resource
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.
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 define
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:
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
Hinweis: Wenn Sie den Datentyp Zuordnung auswählen, dann Map value type -Eigenschaft angezeigt.
Sie können auch Erweiterte Typsuche , um vorhandene Datentypen zu suchen und zu filtern und den gewünschten Typ leichter zu finden.
Weitere Informationen zu Typspezifische Feldeigenschaften, siehe Übersicht über Felder definieren .
Sie können auch für jedes Feld eine Beschreibung und Notizen angeben. Verwenden Sie die Beschreibung -Feld, 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. |
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.
Typspezifische Feldeigenschaften type-specific-properties
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:
Hinweis: Alle über die API erstellten Zuordnungs-Datentypen, die weder vom Typ String noch vom Typ Integer sind, werden alsKomplexDatentyp. ""kann nicht erstellt werdenKomplexDatentypen über die Benutzeroberfläche.
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.Wählen Sie aus einer Liste vordefinierter Formate für Zeichenfolgen aus, denen der Wert entsprechen muss. Zu den verfügbaren Formaten gehören:
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, 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.