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 Verständnis des XDM-Systems voraus. Eine Einführung in die Rolle von XDM im Experience Platform-Ökosystem finden Sie in der XDM-Übersicht und in den Grundlagen der Schemakomposition , um einen Überblick darüber zu erhalten, wie Schemas erstellt werden.
Erstellen eines neuen Schemas create
Wählen Sie im Arbeitsbereich Schemas oben rechts die Option Schema erstellen aus.
Der Workflow Schema erstellen wird angezeigt. Sie können eine Basisklasse für das Schema auswählen, indem Sie entweder Individuelles Profil, Erlebnisereignis oder Sonstige und anschließend Weiter auswählen, um Ihre Auswahl zu bestätigen. Weitere Informationen zu diesen Klassen finden Sie in der Dokumentation zu XDM-individuellen Profilen und XDM ExperienceEvent .
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 (von der Klasse bereitgestellte) Basisstruktur des Schemas wird auf der Arbeitsfläche angezeigt, damit Sie Ihre ausgewählte Klasse und Schemastruktur überprüfen und überprüfen können.
Geben Sie einen benutzerfreundlichen Anzeigenamen des Schemas in das Textfeld ein. Geben Sie anschließend eine Beschreibung ein, die die Identifizierung Ihres Schemas erleichtert. Wenn Sie Ihre Schemastruktur überprüft haben und mit Ihren Einstellungen zufrieden sind, wählen Sie Beenden aus, um Ihr Schema zu erstellen.
Die Registerkarte Schema Durchsuchen wird angezeigt. Ihr kürzlich erstelltes Schema ist jetzt in der Schema Library aufgeführt und kann im Schema Editor bearbeitet werden.
Vorhandenes Schema bearbeiten edit
Um ein vorhandenes Schema zu bearbeiten, wählen Sie die Registerkarte Durchsuchen aus 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 einzuschränken.
Nachdem Sie ein Schema ausgewählt haben, wird der Schema Editor mit der Struktur des Schemas auf der Arbeitsfläche angezeigt. Sie können jetzt Feldergruppen zum Schema hinzufügen (oder einzelne Felder aus diesen Gruppen hinzufügen), Anzeigenamen von Feldern bearbeiten oder vorhandene benutzerdefinierte Feldergruppen bearbeiten , wenn das Schema beliebige 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 oben in der Ansicht Mehr 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 das Schema und Ihre Daten-Pipelines noch erstellen. Dies ist besonders hilfreich in Situationen, in denen komplexe Objektzuordnungsstrukturen im Schema vorhanden sind, z. B. bei einer Identitätszuordnung.
Umschalter für Anzeigename display-name-toggle
Der Schema Editor bietet einen Umschalter zum Ändern zwischen den ursprünglichen Feldnamen und den für Menschen lesbareren Anzeigenamen. Diese Flexibilität ermöglicht eine verbesserte Erkennung und Bearbeitung von Feldern Ihrer Schemata. Der Umschalter befindet sich oben rechts in der Ansicht Schema Editor .
Die Anzeigenamen für Standardfeldgruppen werden vom System generiert, können jedoch angepasst werden, wie im Abschnitt Anzeigenamen beschrieben. Anzeigenamen werden in mehreren Ansichten der Benutzeroberfläche angezeigt, einschließlich der Zuordnung und Datensatzvorschau. Die Standardeinstellung ist deaktiviert und zeigt die Feldnamen anhand ihrer ursprünglichen Werte an.
Hinzufügen von Feldergruppen zu einem Schema add-field-groups
Nachdem Sie ein Schema innerhalb von Schema Editor geöffnet haben, können Sie dem Schema mithilfe von Feldergruppen Felder hinzufügen. Wählen Sie zunächst in der linken Leiste Hinzufügen neben Feldergruppen aus.
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 Nutzungspersönlichkeit in Ihrem Unternehmen sortiert.
Wenn Sie die allgemeine Aktivität oder den Geschäftsbereich der Felder kennen, die Sie hinzufügen möchten, wählen Sie in der linken Leiste mindestens eine der vertikalen Branchen-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 zum 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 dem Schema hinzuzufügen.
Die Schema Editor wird mit den von der Feldergruppe bereitgestellten Feldern wieder 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, um diese Gruppen hinzuzufügen, je nach Ihren Anforderungen.
Felder, die zu Feldergruppen hinzugefügt wurden, entfernen remove-fields
Nachdem Sie einem Schema eine Feldergruppe hinzugefügt haben, können Sie alle Felder entfernen, die Sie nicht benötigen.
Im folgenden Beispiel wurde dem Schema die Standardfeldgruppe Demografische Details hinzugefügt. Um ein einzelnes Feld wie taxId zu entfernen, wählen Sie das Feld auf der Arbeitsfläche aus und klicken Sie dann in der rechten Leiste auf Entfernen .
Wenn Sie mehrere Felder entfernen möchten, 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 in der rechten Leiste Zugehörige Felder verwalten aus.
Es wird ein Dialogfeld mit der Struktur der betreffenden Feldergruppe angezeigt. Hier können Sie die Kontrollkästchen verwenden, um die erforderlichen Felder auszuwählen oder die Auswahl aufzuheben. Wenn Sie zufrieden sind, wählen Sie Bestätigen aus.
Die Arbeitsfläche wird nur mit den in der Schemastruktur ausgewählten Feldern wieder angezeigt.
Hinzufügen benutzerdefinierter Felder zu Feldergruppen add-fields
Nachdem Sie einem Schema eine Feldergruppe hinzugefügt haben, können Sie zusätzliche Felder für diese Gruppe definieren. Alle Felder, die einer Feldergruppe in einem Schema hinzugefügt werden, werden jedoch auch in allen anderen Schemas angezeigt, die dieselbe Feldergruppe verwenden.
Wenn ein benutzerdefiniertes Feld zu einer Standardfeldgruppe hinzugefügt wird, wird diese Feldergruppe in eine benutzerdefinierte Feldergruppe 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 bestimmte Anweisungen im Abschnitt unter. Wenn Sie Felder zu einer benutzerdefinierten Feldergruppe hinzufügen, lesen Sie den Abschnitt über das Bearbeiten benutzerdefinierter Feldergruppen🔗 im Handbuch zur Feldergruppen-Benutzeroberfläche.
Wenn Sie keine vorhandenen Feldergruppen ändern möchten, können Sie eine neue benutzerdefinierte Feldergruppeerstellen, um stattdessen 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 vermeiden möchten, eine ganze Feldergruppe für einen bestimmten Anwendungsfall hinzuzufügen. 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 zuvor die entsprechende Feldergruppe kennen zu müssen. Um einem Schema ein Standardfeld hinzuzufügen, wählen Sie auf der Arbeitsfläche das Pluszeichen (+) neben dem Namen des Schemas aus. Ein Platzhalter Unbenanntes Feld wird in der Schemastruktur angezeigt und die rechte Leiste wird aktualisiert, um Steuerelemente zum Konfigurieren des Felds anzuzeigen.
Geben Sie unter Feldname 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.
Einige Standardfelder weisen denselben Namen auf, ihre Struktur kann jedoch von der Feldergruppe abhängen, aus der sie stammen. Wenn ein Standardfeld innerhalb eines übergeordneten Objekts in der Feldergruppenstruktur verschachtelt ist, wird das übergeordnete Feld auch im Schema enthalten sein, wenn das untergeordnete Feld hinzugefügt wird.
Wählen Sie das Vorschausymbol (
Die Arbeitsfläche wird aktualisiert und zeigt das Standardfeld an, das dem Schema hinzugefügt wurde, einschließlich der übergeordneten Felder, unter denen es innerhalb der Feldergruppenstruktur verschachtelt ist. Der Name der Feldergruppe wird auch in der linken Leiste unter Feldergruppen aufgeführt. Wenn Sie weitere Felder aus derselben Feldergruppe hinzufügen möchten, wählen Sie in der rechten Leiste Zugehörige Felder verwalten aus.
Benutzerdefinierte Felder hinzufügen add-custom-fields
Ähnlich wie beim Workflow für Standardfelder können Sie auch eigene benutzerdefinierte Felder direkt zu einem Schema hinzufügen.
Um Felder zur Stammebene eines Schemas hinzuzufügen, wählen Sie auf der Arbeitsfläche das Pluszeichen (+) neben dem Namen des Schemas aus. Ein Platzhalter Unbenanntes 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 entsprechenden Standardfeldern. Um stattdessen ein neues benutzerdefiniertes Feld zu erstellen, wählen Sie die obere Option aus, die an (Neues Feld) angehängt ist.
Nachdem Sie einen Anzeigenamen und einen Datentyp für das Feld bereitgestellt haben, 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 oder einer Feldergruppe hinzufügen. Wenn Ihr Schema jedoch eine Standardklasse verwendet, können Sie das benutzerdefinierte Feld nur einer Feldergruppe zuweisen.
Weisen Sie das Feld einer benutzerdefinierten Feldergruppe zu add-to-field-group
Wählen Sie unter "Zuweisen zu"die Option "Feldergruppe". Wenn Ihr Schema eine Standardklasse verwendet, ist dies die einzige verfügbare Option und 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 mit der Eingabe des Namens der Feldergruppe in der bereitgestellten Texteingabe. Wenn bereits benutzerdefinierte Feldergruppen vorhanden sind, die mit der Eingabe übereinstimmen, werden diese in der Dropdown-Liste angezeigt. Alternativ können Sie einen eindeutigen Namen eingeben, um stattdessen eine neue Feldergruppe zu erstellen.
Nachdem Sie die Feldergruppe aus der Liste ausgewählt haben, wählen Sie Anwenden.
Das neue Feld wird der Arbeitsfläche hinzugefügt und unter Ihrer Mandanten-ID als Namespace angegeben, um Konflikte mit Standard-XDM-Feldern zu vermeiden. Die Feldergruppe, mit der Sie das neue Feld verknüpft haben, wird auch in der linken Leiste unter Feldergruppen angezeigt.
Weisen Sie das Feld einer benutzerdefinierten Klasse zu add-to-class
Wählen Sie unter "Zuweisen zu"die Option "Klasse". Das nachstehende Eingabefeld wird durch den Namen der benutzerdefinierten Klasse des aktuellen Schemas ersetzt und gibt an, dass das neue Feld dieser Klasse zugewiesen wird.
Fahren Sie mit der Konfiguration des Felds fort und wählen Sie Anwenden , wenn Sie fertig sind.
Das neue Feld wird der Arbeitsfläche hinzugefügt und unter Ihrer Mandanten-ID als Namespace angegeben, um Konflikte mit Standard-XDM-Feldern zu vermeiden. Wenn Sie den Klassennamen in der linken Leiste auswählen, wird das neue Feld als Teil der Klassenstruktur angezeigt.
Fügen Sie benutzerdefinierte Felder zur Struktur von Standardfeldgruppen hinzu custom-fields-for-standard-groups
Wenn das Schema, mit dem Sie arbeiten, ein Objekt enthält, das von einer Standardfeldgruppe bereitgestellt wird, können Sie diesem Standardobjekt eigene benutzerdefinierte Felder hinzufügen.
Wählen Sie zunächst das Pluszeichen (+) neben dem Stamm des von der Standardfeldgruppe bereitgestellten Objekts aus.
Es wird eine Warnmeldung angezeigt, in der Sie aufgefordert werden zu bestätigen, ob Sie die Standardfeldgruppe konvertieren möchten. Wählen Sie Fahren Sie mit der Erstellung der Feldergruppe fort, um fortzufahren.
Die Arbeitsfläche wird mit einem unbenannten Platzhalter für das neue Feld erneut angezeigt. Beachten Sie, dass der Name der Standardfeldgruppe mit "(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 Ihrem Mandanten-ID-Namespace innerhalb des Standardobjekts angezeigt. Dieser verschachtelte Namespace verhindert Konflikte mit Feldnamen innerhalb der Feldergruppe selbst, um Ä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 die von einem Schema erfassten Daten an diesem Prozess teilnehmen sollen, müssen Sie das Schema zur Verwendung in Profile aktivieren.
Um das Schema zu aktivieren, wählen Sie zunächst den Namen des Schemas in der linken Leiste aus und wählen Sie dann in der rechten Leiste den Umschalter Profil aus.
Es wird ein Popup angezeigt, in dem Sie darauf hingewiesen werden, dass ein Schema nach seiner Aktivierung und Speicherung nicht mehr deaktiviert werden kann. Wählen Sie Aktivieren aus, um fortzufahren.
Die Arbeitsfläche wird mit aktiviertem Umschalter Profil wieder angezeigt.
Um den Prozess abzuschließen, wählen Sie Speichern aus, um das Schema zu speichern.
Das Schema ist jetzt für die Verwendung im Echtzeit-Kundenprofil aktiviert. Wenn Platform Daten in Datensätze erfasst, die auf diesem Schema basieren, werden diese Daten in Ihre aggregierten Profildaten integriert.
Anzeigenamen für Schemafelder bearbeiten display-names
Nachdem Sie einem Schema eine Klasse zugewiesen und 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.
Um den Anzeigenamen eines Schemafelds zu bearbeiten, wählen Sie das Feld auf der Arbeitsfläche aus. Geben Sie in der rechten Leiste unter Anzeigename den neuen Namen ein.
Wählen Sie in der rechten Leiste Anwenden und die Arbeitsfläche wird aktualisiert, um den neuen Anzeigenamen des Felds anzuzeigen. Wählen Sie Speichern aus, um die Änderungen auf das Schema anzuwenden.
Klasse eines Schemas ändern 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 Sie auf der linken Seite der Arbeitsfläche Zuweisen aus.
Es wird ein Dialogfeld angezeigt, in dem eine Liste aller verfügbaren Klassen angezeigt wird, einschließlich aller von Ihrem Unternehmen definierten Klassen (der Inhaber 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 Klassenstruktur in der Vorschau anzeigen auswählen, um die mit der Klasse verknüpften Felder und Metadaten anzuzeigen. Wählen Sie Klasse zuweisen aus, um fortzufahren.
Es wird ein neues Dialogfeld geöffnet, in dem Sie aufgefordert werden zu bestätigen, dass Sie eine neue Klasse zuweisen möchten. Wählen Sie zur Bestätigung Zuweisen aus.
Nach Bestätigung der Klassenänderung wird die Arbeitsfläche zurückgesetzt und der gesamte Kompositionsprozess geht verloren.
Nächste Schritte next-steps
In diesem Dokument wurden die Grundlagen zum Erstellen und Bearbeiten von Schemas in der Platform-Benutzeroberfläche beschrieben. Es wird dringend empfohlen, das Tutorial zur Schemaerstellung für einen umfassenden Workflow zum Erstellen eines vollständigen Schemas in der Benutzeroberfläche zu lesen, einschließlich der Erstellung benutzerdefinierter Feldergruppen und Datentypen für eindeutige Anwendungsfälle.
Weitere Informationen zu den Funktionen des Arbeitsbereichs Schemas finden Sie in der Übersicht über den Arbeitsbereich Schemas.
Informationen zum Verwalten von Schemas in der Schema Registry-API finden Sie im Schemas-Endpunkthandbuch.