Definieren von Auflistungen und vorgeschlagenen Werten in der Benutzeroberfläche enums-and-suggested-values
Im Experience-Datenmodell (XDM) kann einem Zeichenfolgenfeld ein vordefinierter Satz von akzeptierten oder vorgeschlagenen Werten zugewiesen werden, um besser steuern zu können, welche Werte in dieses Feld aufgenommen werden oder wie es sich bei der Segmentierung verhalten wird.
Enums begrenzt die Werte, die für ein Zeichenfolgenfeld erfasst werden können, auf einen vordefinierten Satz. Wenn Sie versuchen, Daten in ein Enum-Feld zu erfassen und der Wert mit keinem der in der Konfiguration definierten Werte übereinstimmt, wird die Aufnahme verweigert.
Im Gegensatz zu Auflistungen ermöglicht die Option Vorgeschlagene Werte die Angabe eines Satzes empfohlener Werte für ein Zeichenfolgenfeld, das die Werte, die aufgenommen werden können, nicht einschränkt. Stattdessen wirken sich die vorgeschlagenen Werte darauf aus, welche vordefinierten Werte in der Segmentierungsbenutzeroberfläche verfügbar sind, wenn das Zeichenfolgenfeld als Attribut eingefügt wird.
Wenn ein neues Feldin der Adobe Experience Platform-Benutzeroberfläche definiert und der Typ auf String gesetzt wird, erhalten Sie die Möglichkeit, für dieses Feld die Werte enum oder empfohlen zu definieren.
In diesem Dokument wird beschrieben, wie Sie Auflistungen und vorgeschlagene Werte im Arbeitsbereich der Benutzeroberfläche von Schemas definieren. Ein kurzer Überblick über Auflistungen und empfohlene Werte, einschließlich ihrer Konfiguration in der Benutzeroberfläche und deren nachgelagerten Effekten, erhalten Sie im folgenden Video:
Definieren einer Enumeration enum
Wählen Sie Auflistungen und Vorgeschlagene Werte und dann Auflistungen aus. Es werden zusätzliche Steuerelemente angezeigt, mit denen Sie die Wertbegrenzungen für die Enumeration angeben können. Um eine Einschränkung hinzuzufügen, wählen Sie Zeile hinzufügen aus.
Unter der Spalte Wert müssen Sie den genauen Wert angeben, auf den Sie das Feld beschränken möchten. Sie können optional auch einen benutzerfreundlichen Anzeigenamen für die Begrenzung angeben, der sich auf die Darstellung des Werts in der Segmentierung auswirkt.
Verwenden Sie weiterhin "Zeile hinzufügen", um die gewünschten Einschränkungen und optionalen Beschriftungen zur Aufzählung hinzuzufügen, oder wählen Sie das Löschsymbol (
Die Arbeitsfläche wird entsprechend den Änderungen aktualisiert. Wenn Sie dieses Schema zukünftig untersuchen, können Sie die Begrenzungen für das Enum-Feld in der rechten Leiste anzeigen und bearbeiten.
Definieren empfohlener Werte suggested-values
Wählen Sie Auflistungen und Vorgeschlagene Werte und dann Vorgeschlagene Werte aus, um zusätzliche Steuerelemente anzuzeigen. Wählen Sie hier Zeile hinzufügen aus, um die vorgeschlagenen Werte hinzuzufügen.
Geben Sie unter der Spalte Anzeigename einen benutzerfreundlichen Namen für den Wert ein, wie er in der Segmentierungsbenutzeroberfläche angezeigt werden soll. Um weitere empfohlene Werte hinzuzufügen, wählen Sie erneut Zeile hinzufügen und wiederholen Sie den Vorgang nach Bedarf. Um eine zuvor hinzugefügte Zeile zu entfernen, wählen Sie
Wählen Sie abschließend Anwenden aus, um die Änderungen auf das Schema anzuwenden.
Verwalten von vorgeschlagenen Werten für Standardfelder
Einige Felder aus Standard-XDM-Komponenten enthalten ihre eigenen empfohlenen Werte, z. B. eventType aus der XDM ExperienceEvent-Klasse. Sie können zwar zusätzliche empfohlene Werte für ein Standardfeld erstellen, jedoch keine von Ihrem Unternehmen nicht definierten vorgeschlagenen Werte ändern oder entfernen. Bei der Anzeige eines Standardfelds in der Benutzeroberfläche werden die vorgeschlagenen Werte angezeigt, sind jedoch schreibgeschützt.
Um neue empfohlene Werte für ein Standardfeld hinzuzufügen, wählen Sie Zeile hinzufügen aus. Um einen vorgeschlagenen Wert zu entfernen, der zuvor von Ihrer Organisation hinzugefügt wurde, wählen Sie
Evolutionsregeln für Auflistungen und empfohlene Werte evolution
Nachdem ein Schema mit einem Enum-Feld verwendet wurde, um Daten in Platform aufzunehmen, müssen alle weiteren Änderungen an der Schemadefinition den bereits im System vorhandenen Daten entsprechen. Im Allgemeinen können Änderungen an einem vorhandenen Feld nur das Feld less einschränken. Ein Feld kann nicht restriktiver gestaltet werden als es bereits ist.
Bei Auflistungen und vorgeschlagenen Werten gelten die folgenden Regeln für die Nachaufnahme:
- Sie CAN können vorgeschlagene Werte für Standard- und benutzerdefinierte Felder mit vorhandenen vorgeschlagenen Werten hinzufügen.
- Sie CAN entfernen vorgeschlagene Werte aus benutzerdefinierten Feldern mit vorhandenen vorgeschlagenen Werten.
- Sie CAN können neue Enum-Werte für ein vorhandenes benutzerdefiniertes Enum-Feld hinzufügen.
- Sie können CAN die Enum-Werte eines benutzerdefinierten Felds in empfohlene Werte umschalten oder sie in eine Zeichenfolge ohne Enum oder vorgeschlagene Werte konvertieren. Dieser Schalter kann nicht rückgängig gemacht werden, sobald er angewendet wurde.
- Sie KÖNNEN NICHT Auflistungen oder vorgeschlagene Werte aus Standardfeldern entfernen.
- Sie KÖNNEN NICHT Enum-Werte zu einem Feld ohne vorhandene Enumeration hinzufügen.
- Sie KÖNNEN NICHT weniger als alle vorhandenen Enum-Werte für ein benutzerdefiniertes Feld entfernen.
- Sie KÖNNEN NICHT von vorgeschlagenen Werten zu einer Enumeration wechseln.
Zusammenführen von Regeln für Auflistungen und empfohlene Werte merging
Wenn mehrere Schemas dasselbe Enum-Feld mit unterschiedlichen Konfigurationen verwenden und diese Schemas in einer Vereinigung enthalten sind, gelten bestimmte Regeln für die Abstimmung von Enum-Unterschieden. Die genauen Regeln hängen davon ab, ob die Schemas, die auf dasselbe Standardfeld verweisen (z. B. eventType) oder ob sie in verschiedenen Feldgruppen auf denselben benutzerdefinierten Feldpfad verweisen.
Wenn auf dasselbe Standardfeld verwiesen wird:
- Alle weiteren vorgeschlagenen Werte sind ANGEHÄNGT in der Vereinigung.
- Aktualisierungen, die an den vorgeschlagenen Werten für denselben Enum-Schlüssel vorgenommen werden, sind UPDATED in der Vereinigung.
Wenn Sie in verschiedenen Feldgruppen auf denselben benutzerdefinierten Feldpfad verweisen:
- Alle weiteren vorgeschlagenen Werte sind ANGEHÄNGT in der Vereinigung.
- Wenn derselbe zusätzliche empfohlene Wert in mehr als einem Schema definiert ist, sind diese Werte ZUSAMMENGED in der Vereinigung. Mit anderen Worten, derselbe empfohlene Wert wird nach dem Zusammenführen nicht zweimal angezeigt.
Validierungsbeschränkungen
Aufgrund der aktuellen Systembeschränkungen gibt es zwei Fälle, in denen eine Enumeration vom System während der Erfassung nicht validiert wird:
- Der Enum wird in einem Array-Feld definiert.
- Der Enum ist in der Schemahierarchie auf mehr als einer Ebene definiert.
Nächste Schritte
In diesem Handbuch wurde beschrieben, wie Sie Auflistungen und empfohlene Werte für Zeichenfolgenfelder in der Benutzeroberfläche definieren. Informationen zum Verwalten von Auflistungen und vorgeschlagenen Werten mithilfe der Schema Registry-API finden Sie im folgenden Tutorial.
Informationen zum Definieren anderer XDM-Feldtypen in der Schema Editor finden Sie in der Übersicht zum Definieren von Feldern in der Benutzeroberfläche 2}.