Erkunden von Schema-Ressourcen in der Benutzeroberfläche
In Adobe Experience Platform werden alle Schema-Ressourcen des Experience-Datenmodells (XDM) im Schema Library gespeichert, einschließlich der von Adobe bereitgestellten Standardressourcen und der von Ihrem Unternehmen definierten benutzerdefinierten Ressourcen. In der Experience Platform-Benutzeroberfläche können Sie die Struktur und die Felder jedes vorhandenen Schemas, jeder vorhandenen Klasse, jeder vorhandenen Feldergruppe oder jedes vorhandenen Datentyps in der Schema Library anzeigen. Dies ist besonders bei der Planung und Vorbereitung der Datenaufnahme nützlich, da die Benutzeroberfläche Informationen zu den erwarteten Datentypen und Anwendungsfällen jedes Felds bereitstellt, das von diesen XDM-Ressourcen bereitgestellt wird.
In diesem Tutorial werden die Schritte zum Untersuchen vorhandener Schemata, Klassen, Feldergruppen und Datentypen in der Experience Platform-Benutzeroberfläche beschrieben.
Suchen einer Schema-Ressource lookup
Wählen Sie in der Benutzeroberfläche von Experience Platform im linken Navigationsbereich Schemas aus. Der Arbeitsbereich Schemas bietet eine Browse Registerkarte, auf der alle Schemata in Ihrer Organisation untersucht werden können, sowie zusätzliche dedizierte Registerkarten zum Untersuchen von Classes, Field groups, Data types bzw. Relationships.
Das Filtersymbol (
Auf der Registerkarte Browse des Arbeitsbereichs Schemas können Sie Ihr Schema-Inventar filtern. Verwenden Sie den Umschalter Included in Profile , um nur Schemas anzuzeigen, die für die Verwendung im Echtzeit-Kundenprofil“ aktiviert . Verwenden Sie den Umschalter Show adhoc schemas , um die Liste der Schemata zu filtern, die mit Feldern erstellt wurden, die in einem Namespace enthalten sind und nur von einem einzigen Datensatz verwendet werden können.
Auf der Registerkarte Relationship des Arbeitsbereichs Schemas können Sie die Liste der Beziehungen nach vier Kriterien filtern. Zu den Filtern gehören Source schema, Destination schema, Source class und die Destination class. Die nachstehende Tabelle enthält eine Beschreibung der Filter.
Sie können die Suchleiste auch verwenden, um die Ergebnisse weiter einzugrenzen.
Die in den Suchergebnissen angezeigten Ressourcen werden zuerst nach Übereinstimmungen mit dem Titel und dann nach der Beschreibung sortiert. Je mehr Wörter in einer dieser Kategorien übereinstimmen, desto höher wird die Ressource in der Liste angezeigt.
Wenn Sie die Ressource gefunden haben, die Sie untersuchen möchten, wählen Sie ihren Namen aus der Liste aus, um ihre Struktur auf der Arbeitsfläche anzuzeigen.
Verwalten von Schemata, Klassen, Feldergruppen und Datentypen: Aktionen und Löschungen xdm-resource-actions
Verwenden Sie diesen Abschnitt, wenn Sie XDM-Ressourcen verwalten oder löschen müssen oder wenn eine Aktion (z. B. Löschen) nicht verfügbar ist und Sie verstehen müssen, warum.
Wo Sie Aktionen finden (Inline- vs. Detailseite) where-to-find-actions
Verwenden Sie einen der folgenden Einstiegspunkte, um Aktionen wie das Löschen, Exportieren oder Kopieren einer Ressource auszuführen:
Auf den Registerkarten Browse, Classes, Field groups und Data types sind Verwaltungsaktionen an zwei Stellen verfügbar:
- Inline in der Tabelle: Jede Ressourcenzeile enthält ein Aktionsmenü (z. B. …), das direkten Zugriff auf verfügbare Aktionen bietet.
- Ressourcendetailansicht: Um auf vollständige Aktionen in der Detailansicht zuzugreifen, müssen Sie eine benutzerdefinierte (vom Mandanten definierte) Ressource. Standardressourcen (von Adobe bereitgestellt) verfügen über eingeschränkte Aktionen und zeigen keine Optionen wie „Löschen“, „JSON-Struktur kopieren“ oder „Zum Paket hinzufügen“ an. Wählen Sie eine benutzerdefinierte Ressource aus dem Inventar aus, um ihre Detailansicht zu öffnen, und greifen Sie dann über das Menü More in der Seitenkopfzeile auf dieselben verfügbaren Aktionen zu.
Diese Aktionen sind über beide Einstiegspunkte für unterstützte Ressourcentypen (Schemata, Klassen, Feldergruppen und Datentypen) hinweg konsistent.
Verfügbare Aktionen available-actions
Je nach Ressourcentyp und Ihren Berechtigungen sind möglicherweise die folgenden Aktionen verfügbar:
- Delete - Eine benutzerdefinierte Ressource dauerhaft aus Ihrer Organisation entfernen (wenn Einschränkungen dies zulassen). Wenn der Löschvorgang blockiert ist, siehe Einschränkungen.
- Download sample file - Generieren Sie eine Beispieldatendatei basierend auf der Ressourcenstruktur. Schritt für Schritt: Generieren von Beispiel-XDM-.
- Copy JSON structure - Kopieren Sie die Ressourcendefinition im JSON-Format zur Wiederverwendung, zum Export oder zur Überprüfung. Schritt für Schritt: XDM-Schemata exportieren.
- Add to package - Die Ressource wird in ein Sandbox-Paket für den Export oder Import in mehrere Sandboxes aufgenommen. Schritt für Schritt: Objekte in ein Paket .
Folgendes gilt für verschiedene Ressourcentypen:
-
Für benutzerdefinierte (Mandanten-definierte Schemata, Klassen, Feldergruppen und Datentypen können alle oben genannten Aktionen verfügbar sein.
-
Für standardmäßige (Adobe-definierte) Klassen, Feldergruppen und Datentypen:
- Nur Download sample file ist verfügbar.
- Löschen, JSON-Struktur kopieren und Zum Paket hinzufügen sind nicht verfügbar.
Löschverhalten delete-behavior
Verwenden Sie die Aktion Delete , wenn Sie eine benutzerdefinierte Ressource entfernen möchten, die nicht mehr benötigt wird.
Löschen einer Ressource:
- Suchen Sie die Ressource in der Tabelle oder öffnen Sie die Detailansicht.
- Wählen Sie das Menü Aktionen (… oder More) aus.
- Wählen Sie Delete aus.
- Bestätigen Sie die Aktion im Dialogfeld, indem Sie erneut Delete auswählen.
Die Ressource wird nach der Bestätigung dauerhaft aus Ihrer Organisation entfernt.
Wenn für eine Ressource kein Löschen verfügbar ist, wird die Option mit einer QuickInfo deaktiviert, die erklärt, warum die Aktion nicht ausgeführt werden kann.
Einschränkungen (Datensatz, Profil, RBAC, Mandant vs. global) delete-constraints
Wenn eine Aktion wie Delete nicht verfügbar oder deaktiviert ist, liegt dies in der Regel an einer der folgenden Bedingungen:
-
Berechtigungen (RBAC): Sie müssen über die erforderlichen Berechtigungen (z. B. Manage Schemas) verfügen, um Verwaltungsaktionen durchzuführen. Wenn Berechtigungen fehlen, werden Aktionen mit QuickInfos deaktiviert angezeigt. Informationen zur Konfiguration von Berechtigungen finden Sie unter Übersicht über die Benutzeroberfläche der Zugriffssteuerung.
-
Datensatzverknüpfung: Ressourcen, die von einem oder mehreren Datensätzen verwendet werden (z. B. mit Datensätzen verknüpfte Schemata), können nicht gelöscht werden. Informationen zum Identifizieren und Entfernen von Datensatzabhängigkeiten finden Sie unter Datensatz löschen.
-
Profilaktivierung: Schemata, die für das Echtzeit-Kundenprofil aktiviert sind, können nicht gelöscht werden. Anleitungen dazu, wie sich die Profilaktivierung auf Ihr Schema auswirkt, finden Sie Planen der Aktivierung von Echtzeit-Kundenprofilen.
-
Mandanten- und globale Ressourcen: Mandantendefinierte (benutzerdefinierte) Ressourcen können (vorbehaltlich von Einschränkungen) gelöscht werden, während Standardklassen, Feldergruppen und Datentypen (von Adobe bereitgestellt) nicht gelöscht werden können.
Diese Einschränkungen spiegeln sich direkt in der Benutzeroberfläche wider. Wenn eine Aktion nicht verfügbar ist, wird sie deaktiviert angezeigt und enthält eine QuickInfo, die die spezifische Einschränkung erklärt.
Wenn Sie eine Ressource nicht löschen können, überprüfen Sie die oben genannten Bedingungen, um festzustellen, ob Sie Berechtigungen aktualisieren, Abhängigkeiten entfernen oder Ihr Datenmodell anpassen müssen.
Weitere Workflows zur Schemabearbeitung auf der Arbeitsfläche finden Sie unter Erstellen und Bearbeiten von Schemas in der Benutzeroberfläche.
Erkunden einer XDM-Ressource auf der Arbeitsfläche explore
Wenn Sie eine Ressource auswählen, wird ihre Struktur auf der Arbeitsfläche geöffnet.
Alle Felder vom Typ „Objekt“, die Untereigenschaften enthalten, werden standardmäßig reduziert, wenn sie zum ersten Mal auf der Arbeitsfläche erscheinen. Um die Untereigenschaften eines Felds anzuzeigen, klicken Sie auf das Symbol neben dem Namen des Felds.
Indikator für Standardklasse und Feldergruppe standard-class-and-field-group-indicator
Innerhalb des Schema-Editors werden Standardklassen (Adobe-generiert) und Feldergruppen mit dem Schlosssymbol (
Eine Anleitung Sie in der Dokumentation zum Hinzufügen benutzerdefinierter Felder Standardfeldgruppen . Eine Standardklasse kann nicht bearbeitet werden.
Systemgenerierte Felder system-fields
Einigen Feldnamen wird ein Unterstrich vorangestellt, z. B. _repo und _id. Diese stellen Platzhalter für Felder dar, die das System bei der Datenaufnahme automatisch generiert und zuweist.
Daher sollten die meisten dieser Felder bei der Aufnahme in Experience Platform aus der Datenstruktur ausgeschlossen werden. Die wichtigste Ausnahme von dieser Regel ist das _{TENANT_ID} Feld unter dem alle XDM-Felder, die unter Ihrer Organisation erstellt wurden, einen Namespace erhalten müssen.
Datentypen data-types
Für jedes auf der Arbeitsfläche angezeigte Feld wird der entsprechende Datentyp neben dem Namen angezeigt, was auf einen Blick den Datentyp angibt, den das Feld für die Aufnahme erwartet.
Jeder Datentyp, der mit eckigen Klammern ([]) angehängt wird, stellt ein Array dieses bestimmten Datentyps dar. Beispielsweise gibt ein Datentyp von String[] an, dass das Feld ein Array von Zeichenfolgenwerten erwartet. Der Datentyp Payment Item[] gibt ein Array von Objekten an, die dem Payment Item Datentyp entsprechen.
Wenn ein Array-Feld auf einem Objekttyp basiert, können Sie auf der Arbeitsfläche auf sein Symbol klicken, um die erwarteten Attribute für jedes Array-Element anzuzeigen.
Field properties field-properties
Wenn Sie den Namen eines Felds auf der Arbeitsfläche auswählen, wird die rechte Leiste aktualisiert, um Details zu diesem Feld unter Field properties anzuzeigen. Dies kann eine Beschreibung des vorgesehenen Anwendungsfalls des Felds, Standardwerte, Muster, Formate, unabhängig davon, ob das Feld erforderlich ist oder nicht, und mehr umfassen.
Wenn es sich bei dem überprüften Feld um ein Aufzählungsfeld handelt, zeigt die rechte Leiste auch die akzeptablen Werte an, die das Feld erwartet.
Identitätsfelder identity
Beim Überprüfen von Schemata, die Identitätsfelder enthalten, werden diese Felder in der linken Leiste unter der Klasse oder Feldergruppe aufgeführt, die sie für das Schema bereitstellt. Wählen Sie den Namen des Identitätsfelds in der linken Leiste aus, um das Feld auf der Arbeitsfläche anzuzeigen, unabhängig davon, wie tief es verschachtelt ist.
Identitätsfelder werden auf der Arbeitsfläche mit einem Fingerabdrucksymbol (
Beziehungsfelder relationship
Wenn Sie ein Schema überprüfen, das ein Beziehungsfeld enthält, wird das Feld in der linken Leiste unter Relationships aufgeführt. Wählen Sie den Namen des Beziehungsfelds in der linken Leiste aus, um das Feld auf der Arbeitsfläche anzuzeigen, unabhängig davon, wie tief es verschachtelt ist. Beziehungsfelder werden auch auf der Arbeitsfläche eindeutig hervorgehoben, sodass der Name des Referenzschemas angezeigt wird, auf das das Feld verweist. Für Organisationen mit B2B-Funktionen können benutzerdefinierte Beziehungsnamen geschrieben werden, die in diesen Fällen auf der Arbeitsfläche angezeigt werden.
Um den Identity-Namespace der primären Identität des Referenzschemas anzuzeigen, wählen Sie das Beziehungsfeld aus und Edit relationship Sie dann in der Field properties Seitenleiste. Die Parameter für die Beziehung werden im angezeigten Edit relationship-Dialogfeld angezeigt.
Weitere Informationen zur Verwendung von in XDM-Schemata finden Sie Tutorial zum Erstellen einer Beziehung in der Benutzeroberfläche .
Nächste Schritte
In diesem Dokument wurde beschrieben, wie Sie vorhandene XDM-Ressourcen in der Experience Platform-Benutzeroberfläche erkunden. Weitere Informationen zu den verschiedenen Funktionen von Schemas Workspace und Schema Editor finden Sie in der Übersicht über Schemas Workspace.