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 der Arbeitsfläche ein Untitled field Platzhalter angezeigt.
In der rechten Leiste unter Field properties können Sie die Details des neuen Felds konfigurieren. Für jedes Feld sind die folgenden Informationen erforderlich:
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. Es kann alphanumerische Zeichen oder Unterstriche enthalten, es jedoch mit einem Unterstrich beginnen.
- Richtig:
fieldName - Akzeptiert:
field_name2,fieldName_3 - Falsch:
_fieldName
Hinweis: Wenn Sie den Datentyp Zuordnung auswählen, wird Map value type Eigenschaft angezeigt.
Sie können auch Advanced type search auswählen, um vorhandene Datentypen zu durchsuchen und zu filtern und den gewünschten Typ leichter zu finden.
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 das Description Feld, 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 Apply 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 je nach dem Type, den Sie für das Feld auswählen, zusätzliche Konfigurationsoptionen angezeigt werden. In der folgenden Tabelle sind diese zusätzlichen Feldeigenschaften zusammen mit ihren kompatiblen Typen aufgeführt.
Eigenschaften wie Pattern, Format und Längen- oder numerische Grenzen werden bei der Aufnahme erzwungen, wenn sie konfiguriert sind. Default value ist anders: Es werden Metadaten des Informationsschemas aufgezeichnet und die aufgenommenen Daten werden nicht validiert oder befüllt. Siehe die Default value Zeile unten und den Hinweis, der der Tabelle folgt.
Hinweis: Alle über die API erstellten Zuordnungsdatentypen, die weder vom Typ „Zeichenfolge“ noch vom Typ „Ganzzahl“ sind, werden als Datentyp “Complex” angezeigt. Datentypen ‘Complex’ können nicht über die Benutzeroberfläche erstellt werden.
Wählen Sie aus einer Liste vordefinierter Formate für Zeichenfolgen, denen der Wert entsprechen muss. Zu den verfügbaren Formaten gehören:
default unterstützen (z. B. String und Boolean)default und in der Schemadefinition gespeichert sind. Der konfigurierte Wert wird während der Aufnahme oder der Datenvorbereitung nicht automatisch angewendet. Ausgelassene Felder bleiben fehlen, es sei denn, sie werden in Ihrem Datenfluss explizit zugeordnet oder transformiert. Siehe Definieren erforderlicher Felder.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 Experience 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.
Weiterführende Informationen zu den Funktionen von Schemas Workspace finden Sie in der Übersicht zu Schemas Workspace .