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 beschränken Sie 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 wird die Vorgeschlagene Werte -Option ermöglicht es, einen Satz empfohlener Werte für ein Zeichenfolgenfeld zu kennzeichnen, das die erfassten Werte nicht einschränkt. Stattdessen wirken sich die vorgeschlagenen Werte darauf aus, welche vordefinierten Werte im Segmentierungsbenutzeroberfläche , wenn das Zeichenfolgenfeld als Attribut eingefügt wird.
Wann Definieren eines neuen Felds in der Adobe Experience Platform-Benutzeroberfläche und legen Sie den Typ auf Zeichenfolge, erhalten Sie die Möglichkeit, eine enum oder empfohlene Werte für dieses Feld.
In diesem Dokument wird beschrieben, wie Sie Auflistungen und empfohlene Werte im Schemas UI-Arbeitsbereich. 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
Auswählen Auflistungen und empfohlene Werte, wählen Sie Enums. 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.
Unter dem Wert -Spalte müssen Sie den genauen Wert angeben, auf den Sie das Feld beschränken möchten. Sie können optional eine benutzerfreundliche Anzeigename auch für die Beschränkung, was sich auf die Darstellung des Werts in der Segmentierung auswirkt.
Weitere Verwendung Zeile hinzufügen , um die gewünschten Einschränkungen und optionalen Beschriftungen zur Enumeration 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
Auswählen Auflistungen und empfohlene Werte, wählen Sie Vorgeschlagene Werte um zusätzliche Steuerelemente anzuzeigen. Wählen Sie von hier aus Zeile hinzufügen , um die vorgeschlagenen Werte hinzuzufügen.
Unter dem Anzeigename geben Sie 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 Zeile hinzufügen und wiederholen Sie den Vorgang nach Bedarf. Um eine zuvor hinzugefügte Zeile zu entfernen, wählen Sie
Wählen Sie zum Abschluss Anwenden , 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 dem XDM ExperienceEvent class. 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. 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, die an einem vorhandenen Feld vorgenommen werden, nur dieses Feld erstellen less restriktiv sein. Ein Feld kann nicht restriktiver gestaltet werden als es bereits ist.
Bei Auflistungen und vorgeschlagenen Werten gelten die folgenden Regeln für die Nachaufnahme:
- You CAN Fügen Sie empfohlene Werte für Standard- und benutzerdefinierte Felder mit vorhandenen vorgeschlagenen Werten hinzu.
- You CAN Entfernen Sie vorgeschlagene Werte aus benutzerdefinierten Feldern mit vorhandenen vorgeschlagenen Werten.
- You CAN neue Enum-Werte für ein vorhandenes benutzerdefiniertes Enum-Feld hinzufügen.
- You CAN Ändern Sie die Enum-Werte eines benutzerdefinierten Felds in empfohlene Werte oder konvertieren Sie sie in eine Zeichenfolge ohne Enum oder vorgeschlagene Werte. Dieser Schalter kann nach der Anwendung nicht mehr rückgängig gemacht werden.
- You CANNOT Entfernen Sie Auflistungen oder vorgeschlagene Werte aus Standardfeldern.
- You CANNOT Fügen Sie Enum-Werte zu einem Feld ohne vorhandene Enumeration hinzu.
- You CANNOT weniger als alle vorhandenen Enum-Werte für ein benutzerdefiniertes Feld entfernen.
- You CANNOT Wechsel von vorgeschlagenen Werten zu einer Enumeration.
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 (wie eventType) oder wenn sie in verschiedenen Feldergruppen auf denselben benutzerdefinierten Feldpfad verweisen.
Wenn auf dasselbe Standardfeld verwiesen wird:
- Alle weiteren empfohlenen Werte sind ANGEHALTEN in der Vereinigung.
- Aktualisierungen an den vorgeschlagenen Werten für denselben Enum-Schlüssel sind AKTUALISIERT in der Vereinigung.
Wenn Sie in verschiedenen Feldgruppen auf denselben benutzerdefinierten Feldpfad verweisen:
- Alle weiteren empfohlenen Werte sind ANGEHALTEN in der Vereinigung.
- Wenn derselbe zusätzliche empfohlene Wert in mehr als einem Schema definiert ist, werden 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:
- Die Enumeration wird auf einer Array-Feld.
- 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 empfohlenen Werten mithilfe der Schema Registry-API finden Sie in den folgenden Tutorial.
Erfahren Sie, wie Sie andere XDM-Feldtypen im Schema Editor, siehe Übersicht unter Definieren von Feldern in der Benutzeroberfläche.