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, die Angabe, ob das Feld erforderlich ist, und mehr umfassen. Wenn Sie eine Feldergruppe untersuchen, können auch hier beschriftungsbezogene Details für das ausgewählte Feld angezeigt werden. Siehe Beschriftungen in der Strukturansicht.
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 .
Erkunden von Feldergruppen: Verwendung und Metadaten explore-field-groups
Navigieren Sie zu Schemas > Field groups , um Feldergruppen zu untersuchen. Auf der Registerkarte "Field groups" helfen Ihnen zusätzliche Funktionen dabei zu verstehen, wo eine Feldergruppe schemaübergreifend verwendet wird und was sie enthält, z. B. Kompatibilität, erforderliche Felder (die Aufnahmeanforderungen erzwingen) und Governance-Signale.
Mithilfe dieser Funktionen können Sie die Auswirkungen bewerten, bevor Sie Änderungen vornehmen, und relevante Feldergruppen beim Schema-Design effizienter identifizieren.
Anzeigen der Schemanutzung für Feldergruppen view-schema-usage-for-field-groups
Wählen Sie in der Field groups eine Feldergruppe aus, um ihre Detailansicht zu öffnen. Die Arbeitsfläche wird aktualisiert und zeigt die Feldergruppenstruktur an. Die Eigenschaftenleiste zeigt zusätzliche Informationen zur ausgewählten Ressource an.
Schemata, die diese Feldergruppe verwenden
In der rechten Leiste Eigenschaften werden im Abschnitt Schemas using this field group Schemata aufgelistet, die derzeit die -Feldgruppe enthalten.
- Wenn die Feldergruppe von drei oder weniger Schemata verwendet wird, werden alle Schemanamen angezeigt.
- Wenn es von mehr als drei Schemata verwendet wird, werden nur einige Namen angezeigt, zusammen mit einer Option zum Anzeigen der vollständigen Liste.
Wählen Sie einen Schemanamen aus, um seine Detailansicht in einer neuen Registerkarte zu öffnen, und überprüfen Sie, wie die Feldergruppe in diesem Schema implementiert ist.
Weitere und vollständige Schemalliste anzeigen
Wenn mehr Schemata vorhanden sind, als inline angezeigt werden können, wählen Sie View more aus, um das vollständige Dialogfeld zu öffnen.
Das Dialogfeld Schemas using this field group wird mit der vollständigen Liste der Schemata angezeigt, die die -Feldgruppe verwenden.
Im Dialogfeld Schemas using this field group haben Sie folgende Möglichkeiten:
- Durchsuchen aller Schemata, die die Feldergruppe verwenden
- Seiten durch große Ergebnismengen
- Schema auswählen, um seine Detailansicht in einer neuen Registerkarte zu öffnen
Sie können Schemadetails wie Schemaname, Klasse und andere Attribute anzeigen.
Dieser Workflow ist nur für Auswirkungsanalyse und -erkundung vorgesehen. Schemata oder Feldergruppen werden nicht geändert. Informationen zum Ändern der Schemastruktur finden Sie unter Erstellen und Bearbeiten von Schemas in der Benutzeroberfläche.
Feldergruppen-Metadaten und -Filter field-group-metadata-and-filtering
Die Registerkarte Field groups enthält Metadaten und Filterwerkzeuge, mit denen Sie Feldergruppen vor der Auswahl finden und auswerten können.
Tabelle und Filter durchsuchen
Die Inventartabelle der Feldergruppen enthält zusätzliche Spalten, die Metadaten direkt in der Listenansicht bereitstellen, z. B. Compatible classes, die angibt, auf welche Klassen eine Feldergruppe angewendet werden kann. Feldergruppen können nur zu Schemata hinzugefügt werden, die eine der aufgelisteten kompatiblen Klassen verwenden, basierend auf dem Verhalten der Daten, die sie darstellen (z. B. datensatzbasierte oder Zeitreihendaten). Die Tabelle kann All anzeigen, wenn die Feldergruppe mit allen Klassen kompatibel ist. Industry tags helfen bei der Kategorisierung von Feldergruppen für die Erkennung.
Um die Liste zu verfeinern, wählen Sie das Filtersymbol (
Im Filterbedienfeld haben Sie folgende Möglichkeiten:
- Compatible classes - Verwenden Sie das Dropdown, um Feldergruppen nach Klassenkompatibilität zu filtern.
- Industry tags - Verwenden Sie Kontrollkästchen, um nach einer oder mehreren Branchenkategorien zu filtern
Wählen Sie beim Durchsuchen eine Zeile in der Tabelle aus, um die Informationsleiste zu aktualisieren. Die Informationsleiste zeigt Metadaten wie kompatible Klassen und Branchen-Tags an, damit Sie wichtige Details überprüfen können, ohne die Feldergruppe zu öffnen.
Metadaten der Feldergruppen-Details
Wenn Sie eine Feldergruppe öffnen, zeigt die Eigenschaftenleiste zusätzliche Metadaten an, die mit der Ressource verknüpft sind.
Die Eigenschaftenleiste kann die folgenden Metadaten anzeigen:
- Compatible classes - Klassen, die die Feldergruppe erweitern kann
- Required attributes - Attribute, die gültige Werte aufweisen müssen, wenn sie von der Feldergruppe während der Datenaufnahme benötigt werden. Die Anforderungen hängen von der Datenstruktur ab, und Datensätze mit fehlenden oder ungültigen erforderlichen Werten schlagen bei der Validierung fehl
- Labels - Kennzeichnungen werden nicht auf der Feldergruppenebene angezeigt. Ein Feld auswählen, um Beschriftungsdetails in der Field properties Leiste anzuzeigen
Diese Informationen helfen Ihnen, Einschränkungen und Anforderungen zu verstehen, bevor Sie die Feldergruppe verwenden oder ändern.
Beschriftungen in der Strukturansicht
Wenn eine Feldergruppe auf der Arbeitsfläche geöffnet ist, können Sie Beschriftungsinformationen direkt in der Struktur anzeigen. Wählen Sie das Einstellungssymbol (
Wählen Sie ein Feld auf der Arbeitsfläche aus, um Beschriftungsdetails in der Field properties Leiste anzuzeigen, einschließlich der auf dieses Feld angewendeten Beschriftungen.
Kennzeichnungen werden nach Kategorie gruppiert (z. B. Identitäts- und Vertraulichkeitskennzeichnungen) und bieten Einblick in die Governance oder die Zugriffsbeschränkungen, die auf die Daten angewendet werden.
Diese Indikatoren dienen nur der Sichtbarkeit und ändern die Schemastruktur nicht. Weitere Informationen finden Sie unter Verwalten von Datennutzungsbeschriftungen für ein Schema.
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.