Erstellen und Bearbeiten von Schemata in der Benutzeroberfläche create-edit-schemas-in-ui
Dieses Handbuch bietet einen Überblick darüber, wie Sie Experience-Datenmodell(XDM)-Schemas für Ihr Unternehmen in der Adobe Experience Platform-Benutzeroberfläche erstellen, bearbeiten und verwalten.
Voraussetzungen prerequisites
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 unter Grundlagen der Schemakomposition finden Sie einen Überblick über die Erstellung von Schemas.
Erstellen eines neuen Schemas create
Wählen Arbeitsbereich Schemata oben rechts die Option Schema erstellen“ aus.
Das Erstellen eines Schemas wird angezeigt. In diesem Dialogfeld können Sie entweder manuell ein Schema erstellen, indem Sie Felder und Feldergruppen hinzufügen, oder Sie können eine CSV-Datei hochladen und ML-Algorithmen verwenden, um ein Schema zu generieren. Wählen Sie im Dialogfeld einen Workflow zur Schemaerstellung aus.
[Beta]{class="badge informative"} Manuelle oder ML-unterstützte Schemaerstellung manual-or-assisted
Informationen dazu, wie Sie einen ML-Algorithmus verwenden können, um eine Schemastruktur basierend auf einer CSV-Datei zu empfehlen, finden Sie Handbuch zur Erstellung von Schemata durch maschinelles Lernen. Dieses Handbuch für die Benutzeroberfläche konzentriert sich auf den Workflow zur manuellen Erstellung.
Manuelle Schemaerstellung manual-creation
Der Schema erstellen wird angezeigt. Sie können eine Basisklasse für das Schema auswählen, indem Sie entweder Individuelles Profil, Erlebnisereignis oder Andere und dann Weiter auswählen. Weitere Informationen zu diesen Klassen finden Sie in Dokumentation XDM Individual Profile🔗 und XDM ExperienceEvent .
Bei Auswahl Sonstige wird eine Liste der verfügbaren Klassen angezeigt. Hier können Sie bereits vorhandene Klassen durchsuchen und filtern.
Wählen Sie ein Optionsfeld aus, um die Klassen danach zu filtern, ob es sich um benutzerdefinierte oder Standardklassen handelt. Sie können die verfügbaren Ergebnisse auch nach ihrer Branche filtern oder mithilfe des Suchfelds nach einer bestimmten Klasse suchen.
Um Ihnen bei der Entscheidung über die entsprechende Klasse zu helfen, gibt es Informations- und Vorschausymbole für jede Klasse. Das Infosymbol (
Das Vorschausymbol (
Wählen Sie eine beliebige Zeile aus, um eine Klasse auszuwählen, und klicken Sie dann Weiter, um Ihre Auswahl zu bestätigen.
Nachdem Sie eine Klasse ausgewählt haben, wird der Abschnitt Name und Überprüfung angezeigt. In diesem Abschnitt geben Sie einen Namen und eine Beschreibung ein, um Ihr Schema zu identifizieren. Die Basisstruktur des Schemas (bereitgestellt von der -Klasse) wird auf der Arbeitsfläche angezeigt, damit Sie Ihre ausgewählte Klassen- und Schemastruktur überprüfen und überprüfen können.
Geben Sie im Textfeld einen benutzerfreundlichen Anzeigenamen Schemas“ ein. Geben Sie als Nächstes eine geeignete Beschreibung ein, um Ihr Schema zu identifizieren. Wenn Sie Ihre Schemastruktur überprüft haben und mit Ihren Einstellungen zufrieden sind, wählen Sie Beenden aus, um Ihr Schema zu erstellen.
Der Schema-Editor wird angezeigt, wobei die Schemastruktur auf der Arbeitsfläche angezeigt wird. Falls gewünscht, können Sie jetzt Felder zur Klasse hinzufügen.
Bearbeiten eines vorhandenen Schemas edit
Um ein vorhandenes Schema zu bearbeiten, klicken Sie auf Registerkarte Durchsuchen“ und wählen Sie dann den Namen des Schemas aus, das Sie bearbeiten möchten. Sie können auch die Suchleiste verwenden, um die Liste der verfügbaren Optionen einzugrenzen.
Nachdem Sie ein Schema ausgewählt haben, wird das Schema Editor mit der Schemastruktur auf der Arbeitsfläche angezeigt. Sie können jetzt Feldergruppen hinzufügen zum Schema (oder einzelne Felder hinzufügen aus diesen Gruppen), Anzeigenamen von Feldern bearbeiten oder vorhandene benutzerdefinierte Feldergruppen bearbeiten wenn das Schema eine verwendet.
Mehr Aktionen more
Im Schema-Editor können Sie auch Schnellaktionen durchführen, um die JSON-Struktur des Schemas zu kopieren oder das Schema zu löschen, wenn es nicht für das Echtzeit-Kundenprofil aktiviert wurde oder über verknüpfte Datensätze verfügt. Wählen Sie Mehr oben in der Ansicht aus, um eine Dropdown-Liste mit Schnellaktionen anzuzeigen.
Mit der Funktion JSON-Struktur kopieren können Sie sehen, wie eine Beispiel-Payload aussehen würde, während Sie noch das Schema und Ihre Daten-Pipelines erstellen. Dies ist besonders hilfreich in Situationen, in denen es komplexe Objektzuordnungsstrukturen im Schema gibt, z. B. eine Identitätszuordnung.
Umschalten zwischen Anzeigenamen display-name-toggle
Der Einfachheit halber bietet der Schema-Editor einen Umschalter zum Wechseln zwischen den ursprünglichen Feldnamen und den für Menschen besser lesbaren Anzeigenamen. Diese Flexibilität ermöglicht eine verbesserte Erkennung und Bearbeitung von Feldern Ihrer Schemata. Der Umschalter befindet sich oben rechts in der Ansicht des Schema-Editors.
Die Anzeigenamen für Standardfeldgruppen werden vom System generiert, können jedoch angepasst werden, wie im Abschnitt Anzeigenamen beschrieben. Anzeigenamen werden in mehreren Benutzeroberflächenansichten angezeigt, einschließlich Zuordnungs- und Datensatzvorschauen. Die Standardeinstellung ist deaktiviert und zeigt Feldnamen anhand ihrer ursprünglichen Werte an.
Hinzufügen von Feldergruppen zu einem Schema add-field-groups
Nachdem Sie ein Schema in der Schema Editor geöffnet haben, können Sie dem Schema mithilfe von Feldergruppen Felder hinzufügen. Wählen Sie zunächst Hinzufügen neben Feldergruppen in der linken Leiste.
Es wird ein Dialogfeld mit einer Liste von Feldergruppen angezeigt, die Sie für das Schema auswählen können. Da Feldergruppen nur mit einer Klasse kompatibel sind, werden nur die Feldergruppen aufgelistet, die mit der ausgewählten Klasse des Schemas verknüpft sind. Standardmäßig werden die aufgelisteten Feldergruppen nach ihrer Verwendungspopularität in Ihrer Organisation sortiert.
Wenn Sie den allgemeinen Aktivitäts- oder Geschäftsbereich der Felder kennen, die Sie hinzufügen möchten, wählen Sie in der linken Leiste mindestens eine der branchenvertikalen Kategorien aus, um die angezeigte Liste der Feldergruppen zu filtern.
Sie können auch die Suchleiste verwenden, um Ihre gewünschte Feldergruppe zu finden. Feldergruppen, deren Name mit der Abfrage übereinstimmt, werden oben in der Liste angezeigt. Unter Standardfelder werden Feldergruppen angezeigt, die Felder enthalten, die die gewünschten Datenattribute beschreiben.
Aktivieren Sie das Kontrollkästchen neben dem Namen der Feldergruppe, die Sie dem Schema hinzufügen möchten. Sie können mehrere Feldergruppen aus der Liste auswählen, wobei jede ausgewählte Feldergruppe in der rechten Leiste angezeigt wird.
Nachdem Sie Ihre Feldergruppen ausgewählt haben, wählen Sie Feldergruppen hinzufügen aus, um sie zum Schema hinzuzufügen.
Der Schema Editor wird erneut mit den von den Feldergruppen bereitgestellten Feldern angezeigt, die auf der Arbeitsfläche dargestellt werden.
Nachdem Sie eine Feldergruppe zu einem Schema hinzugefügt haben, können Sie optional vorhandene Felder entfernen oder neue benutzerdefinierte Felder hinzufügen zu diesen Gruppen hinzufügen, je nach Ihren Anforderungen.
Entfernen hinzugefügter Felder aus Feldergruppen remove-fields
Nachdem Sie eine Feldergruppe zu einem Schema hinzugefügt haben, können Sie alle Felder entfernen, die Sie nicht benötigen.
Im folgenden Beispiel wurde die Standardfeldgruppe Demografische Details zu einem Schema hinzugefügt. Um ein einzelnes Feld, z. B. taxId, zu entfernen, wählen Sie das Feld auf der Arbeitsfläche und dann Entfernen in der rechten Leiste aus.
Wenn mehrere Felder entfernt werden sollen, können Sie die Feldergruppe als Ganzes verwalten. Wählen Sie auf der Arbeitsfläche ein Feld aus, das zur Gruppe gehört, und wählen Sie dann Verknüpfte Felder verwalten in der rechten Leiste aus.
Es wird ein Dialogfeld mit der Struktur der betreffenden Feldergruppe angezeigt. Von hier aus können Sie die bereitgestellten Kontrollkästchen verwenden, um die erforderlichen Felder zu aktivieren oder die Auswahl aufzuheben. Wenn Sie fertig sind, wählen Sie Bestätigen aus.
Die Arbeitsfläche wird erneut angezeigt, wobei nur die ausgewählten Felder in der Schemastruktur vorhanden sind.
Hinzufügen benutzerdefinierter Felder zu Feldergruppen add-fields
Nachdem Sie eine Feldergruppe zu einem Schema hinzugefügt haben, können Sie zusätzliche Felder für diese Gruppe definieren. Alle Felder, die einer Feldergruppe in einem Schema hinzugefügt wurden, werden jedoch auch in allen anderen Schemata angezeigt, die dieselbe Feldergruppe verwenden.
Wenn ein benutzerdefiniertes Feld zu einer Standardfeldgruppe hinzugefügt wird, wird diese Feldgruppe außerdem in eine benutzerdefinierte Feldgruppe konvertiert, und die ursprüngliche Standardfeldgruppe ist nicht mehr verfügbar.
Wenn Sie ein benutzerdefiniertes Feld zu einer Standardfeldgruppe hinzufügen möchten, finden Sie im Abschnitt untenspezifische Anweisungen. Wenn Sie Felder zu einer benutzerdefinierten Feldergruppe hinzufügen, lesen Sie den Abschnitt Bearbeiten benutzerdefinierter Feldergruppen im Handbuch zur Benutzeroberfläche für Feldergruppen.
Wenn Sie keine vorhandenen Feldergruppen ändern möchten, können Sie stattdessen neue benutzerdefinierte Feldergruppe erstellen um zusätzliche Felder zu definieren.
Hinzufügen einzelner Felder zu einem Schema add-individual-fields
Mit dem Schema-Editor können Sie einzelne Felder direkt zu einem Schema hinzufügen, wenn Sie nicht eine ganze Feldergruppe für einen bestimmten Anwendungsfall hinzufügen möchten. Sie können stattdessen einzelne Felder aus Standardfeldgruppen hinzufügen oder eigene benutzerdefinierte Felder hinzufügen.
Standardfelder hinzufügen add-standard-fields
Sie können Felder aus Standardfeldgruppen direkt zu einem Schema hinzufügen, ohne die entsprechende Feldgruppe zuvor kennen zu müssen. Um ein Standardfeld zu einem Schema hinzuzufügen, klicken Sie auf das Pluszeichen (+) neben dem Namen des Schemas auf der Arbeitsfläche. Ein Platzhalter Nicht benanntes Feld wird in der Schemastruktur angezeigt, und die rechte Leiste wird aktualisiert, um Steuerelemente zum Konfigurieren des Felds anzuzeigen.
Geben unter den Namen des Felds ein, das Sie hinzufügen möchten. Das System sucht automatisch nach Standardfeldern, die mit der Abfrage übereinstimmen, und listet sie unter Empfohlene Standardfelder auf, einschließlich der Feldergruppen, zu denen sie gehören.
Während einige Standardfelder denselben Namen haben, kann ihre Struktur je nach der Feldergruppe, aus der sie stammen, variieren. Wenn ein Standardfeld in einem übergeordneten Objekt in der Feldergruppenstruktur verschachtelt ist, wird das übergeordnete Feld ebenfalls in das Schema aufgenommen, wenn das untergeordnete Feld hinzugefügt wird.
Wählen Sie das Vorschausymbol (
Die Arbeitsfläche wird aktualisiert und zeigt das zum Schema hinzugefügte Standardfeld an, einschließlich aller übergeordneten Felder, unter denen es in der Feldergruppenstruktur verschachtelt ist. Der Name der Feldergruppe wird auch unter Feldergruppen in der linken Leiste aufgeführt. Wenn Sie mehr Felder aus derselben Feldergruppe hinzufügen möchten, wählen Sie Verwandte Felder verwalten in der rechten Leiste aus.
Benutzerdefinierte Felder hinzufügen add-custom-fields
Ähnlich wie beim Workflow für Standardfelder können Sie auch Ihre eigenen benutzerdefinierten Felder direkt zu einem Schema hinzufügen.
Um Felder zur Stammebene eines Schemas hinzuzufügen, klicken Sie auf das Pluszeichen (+) neben dem Namen des Schemas auf der Arbeitsfläche. Ein Platzhalter Nicht benanntes Feld wird in der Schemastruktur angezeigt, und die rechte Leiste wird aktualisiert, um Steuerelemente zum Konfigurieren des Felds anzuzeigen.
Beginnen Sie mit der Eingabe des Namens des Felds, das Sie hinzufügen möchten, und das System beginnt automatisch mit der Suche nach übereinstimmenden Standardfeldern. Um stattdessen ein neues benutzerdefiniertes Feld zu erstellen, wählen Sie die obere Option aus, an die angehängt ist (Neues Feld).
Nach Angabe eines Anzeigenamens und Datentyps for Im -Feld besteht der nächste Schritt darin, das Feld einer übergeordneten XDM-Ressource zuzuweisen. Wenn Ihr Schema eine benutzerdefinierte Klasse verwendet, können Sie stattdessen das Feld zur zugewiesenen Klasse hinzufügen oder eine Feldergruppe auswählen. Wenn Ihr Schema jedoch eine Standardklasse verwendet, können Sie das benutzerdefinierte Feld nur einer Feldergruppe zuweisen.
Zuweisen des Felds zu einer benutzerdefinierten Feldergruppe add-to-field-group
Wählen unter „Zuweisen zu die Option Feldergruppe. Wenn Ihr Schema eine Standardklasse verwendet, ist dies die einzige verfügbare Option und ist standardmäßig ausgewählt.
Als Nächstes müssen Sie eine Feldergruppe auswählen, mit der das neue Feld verknüpft werden soll. Beginnen Sie, den Namen der Feldergruppe in die bereitgestellte Texteingabe einzugeben. Wenn Sie über benutzerdefinierte Feldergruppen verfügen, die mit der Eingabe übereinstimmen, werden diese in der Dropdown-Liste angezeigt. Sie können auch Folgendes eingeben a Eindeutiger Name, um stattdessen eine neue Feldergruppe zu erstellen.
Wählen Sie nach Auswahl der Feldergruppe aus der Liste die Option Anwenden aus.
Das neue Feld wird der Arbeitsfläche hinzugefügt und erhält einen Namespace unter Ihrer Mandanten-ID, um Konflikte mit standardmäßigen XDM-Feldern zu vermeiden. Die Feldergruppe, mit der Sie das neue Feld verknüpft haben, wird auch unter Feldergruppen in der linken Leiste angezeigt.
Zuweisen des Felds zu einer benutzerdefinierten Klasse add-to-class
Wählen unter „Zuweisen zu die Option Klasse aus. Das Eingabefeld unten wird durch den Namen der benutzerdefinierten Klasse des aktuellen Schemas ersetzt, was angibt, dass das neue Feld dieser Klasse zugewiesen wird.
Fahren Sie mit der Konfiguration des Felds wie gewünscht fort und wählen Sie Anwenden, wenn Sie fertig sind.
Das neue Feld wird der Arbeitsfläche hinzugefügt und erhält einen Namespace unter Ihrer Mandanten-ID, um Konflikte mit standardmäßigen XDM-Feldern zu vermeiden. Wenn Sie den Klassennamen in der linken Leiste auswählen, wird das neue Feld als Teil der Klassenstruktur angezeigt.
Hinzufügen benutzerdefinierter Felder zur Struktur von Standardfeldgruppen custom-fields-for-standard-groups
Wenn das Schema, an dem Sie arbeiten, einen Objekttyp hat field Sie werden von einer Standardfeldergruppe bereitgestellt und können diesem Standardobjekt eigene benutzerdefinierte Felder hinzufügen.
Wählen Sie zunächst das Pluszeichen (+) neben dem Stamm des -Objekts aus, das von der Standardfeldgruppe bereitgestellt wird.
Es wird eine Warnmeldung angezeigt, in der Sie aufgefordert werden zu bestätigen, ob Sie die Standardfeldgruppe konvertieren möchten. Wählen Sie Feldergruppe weiter erstellen um fortzufahren.
Die Arbeitsfläche wird erneut mit einem unbenannten Platzhalter für das neue Feld angezeigt. Beachten Sie, dass an den Namen der Standardfeldgruppe „(Extended)“ angehängt wurde, um anzugeben, dass sie von der Originalversion geändert wurde. Verwenden Sie von hier aus die Steuerelemente in der rechten Leiste, um die Eigenschaften des Felds zu definieren.
Nachdem Sie Ihre Änderungen angewendet haben, wird das neue Feld unter dem Namespace Ihrer Mandanten-ID im Standardobjekt angezeigt. Dieser verschachtelte Namespace verhindert Konflikte mit Feldnamen innerhalb der Feldergruppe selbst, um Unterbrechungen von Änderungen in anderen Schemas zu vermeiden, die dieselbe Feldergruppe verwenden.
Aktivieren eines Schemas für das Echtzeit-Kundenprofil profile
Echtzeit-Kundenprofil führt Daten aus unterschiedlichen Quellen zusammen, um eine vollständige Ansicht jedes einzelnen Kunden zu erstellen. Wenn Sie möchten, dass die von einem Schema erfassten Daten in diesen Prozess einbezogen werden, müssen Sie das Schema für die Verwendung in Profile aktivieren.
Um das Schema zu aktivieren, wählen Sie zunächst den Namen des Schemas in der linken Leiste und dann den Profil in der rechten Leiste aus.
Es wird ein Pop-up mit einer Warnung angezeigt, dass ein Schema nach dem Aktivieren und Speichern nicht mehr deaktiviert werden kann. Wählen Sie Aktivieren aus, um fortzufahren.
Die Arbeitsfläche wird erneut mit aktiviertem Umschalter Profil angezeigt.
Um den Vorgang abzuschließen, klicken Sie auf Speichern, um das Schema zu speichern.
Das Schema ist jetzt für die Verwendung im Echtzeit-Kundenprofil aktiviert. Wenn Platform Daten in Datensätze aufnimmt, die auf diesem Schema basieren, werden diese Daten in Ihre zusammengefassten Profildaten integriert.
Anzeigenamen für Schemafelder bearbeiten display-names
Nachdem Sie eine Klasse zugewiesen und einem Schema Feldergruppen hinzugefügt haben, können Sie die Anzeigenamen der Felder des Schemas bearbeiten, unabhängig davon, ob diese Felder von standardmäßigen oder benutzerdefinierten XDM-Ressourcen bereitgestellt wurden.
Ändern Sie die Feldnamen in die Anzeigenamen, indem Sie die Option Anzeigenamen für Felder anzeigen aktivieren. Um den Anzeigenamen eines Schemafelds zu bearbeiten, wählen Sie das Feld auf der Arbeitsfläche aus. Geben Sie in der rechten Leiste den neuen Namen unter Anzeigename ein.
Wählen Anwenden in der rechten Leiste aus. Die Arbeitsfläche wird aktualisiert, um den neuen Anzeigenamen des Felds anzuzeigen. Wählen Speichern, um die Änderungen auf das Schema anzuwenden.
Ändern der Klasse eines Schemas change-class
Sie können die Klasse eines Schemas während des anfänglichen Kompositionsprozesses jederzeit ändern, bevor das Schema gespeichert wurde.
Um eine Klasse neu zuzuweisen, wählen auf linken Seite der Arbeitsfläche die Option „Zuweisen“ aus.
Es wird ein Dialogfeld mit einer Liste aller verfügbaren Klassen angezeigt, einschließlich der von Ihrem Unternehmen definierten Klassen (der Eigentümer ist "Kunde) sowie der von Adobe definierten Standardklassen.
Wählen Sie eine Klasse aus der Liste aus, um ihre Beschreibung auf der rechten Seite des Dialogfelds anzuzeigen. Sie können auch Vorschau der Klassenstruktur auswählen, um die mit der Klasse verknüpften Felder und Metadaten anzuzeigen. Wählen Sie Klasse zuweisen aus, um fortzufahren.
Ein neues Dialogfeld wird geöffnet, in dem Sie bestätigen müssen, dass Sie eine neue Klasse zuweisen möchten. Wählen Sie Zuweisen aus, um zu bestätigen.
Nach Bestätigung der Klassenänderung wird die Arbeitsfläche zurückgesetzt und der gesamte Kompositionsfortschritt geht verloren.
Nächste Schritte next-steps
In diesem Dokument wurden die Grundlagen zum Erstellen und Bearbeiten von Schemas in der Platform-Benutzeroberfläche behandelt. Es wird dringend empfohlen, das Tutorial zur Schemaerstellung durchzugehen, um einen umfassenden Workflow zum Erstellen eines vollständigen Schemas in der Benutzeroberfläche zu erhalten, einschließlich der Erstellung benutzerdefinierter Feldergruppen und Datentypen for Eindeutige Anwendungsfälle.
Weitere Informationen zu den Funktionen des Arbeitsbereichs Schemata finden Sie unter Schemata Arbeitsbereich - Übersicht.
Informationen zum Verwalten von Schemas in der Schema Registry-API finden Sie im Handbuch zu Schemas-Endpunkten.