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 empfohlenen Werten zugewiesen werden, um besser steuern zu können, welche Werte in dieses Feld aufgenommen werden oder wie es sich bei der Segmentierung verhält.
Auflistungen beschränken die Werte, die für ein Zeichenfolgenfeld aufgenommen werden können, auf einen vordefinierten Satz. Wenn Sie versuchen, Daten in ein Aufzählungsfeld aufzunehmen, und der Wert mit keinem der in der Konfiguration definierten übereinstimmt, wird die Aufnahme verweigert.
Im Gegensatz zu Auflistungen ermöglicht die Option Vorgeschlagene Werte, einen Satz empfohlener Werte für ein Zeichenfolgenfeld zu kennzeichnen, die die Werte, die es aufnehmen kann, nicht einschränken. Stattdessen beeinflussen vorgeschlagene Werte, welche vordefinierten Werte in der Segmentierungsbenutzeroberfläche) verfügbar sind wenn das Zeichenfolgenfeld als Attribut einbezogen wird.
Beim Definieren eines neuen Felds in der Benutzeroberfläche von Adobe Experience Platform und Festlegen des Typs auf Zeichenfolge haben Sie die Möglichkeit, für dieses Feld Aufzählung oder empfohlene Werte zu definieren.
In diesem Dokument wird beschrieben, wie Sie Aufzählungen und empfohlene Werte im Arbeitsbereich Schemata der Benutzeroberfläche definieren. Sehen Sie sich das folgende Video an, um einen schnellen Überblick über Auflistungen und empfohlene Werte zu erhalten, einschließlich ihrer Konfiguration in der Benutzeroberfläche und ihrer Auswirkungen auf nachgelagerte Bereiche:
Aufzählung definieren enum
Wählen Sie Auflistungen und empfohlene Werte und dann Auflistungen aus. Es werden zusätzliche Steuerelemente angezeigt, mit denen Sie die Werteeinschränkungen für die Aufzählung 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. Optional können Sie auch einen benutzerfreundlichen Anzeigenamen für die Einschränkung angeben, der sich darauf auswirkt, wie der Wert in der Segmentierung dargestellt wird.
Verwenden Sie weiterhin Zeile hinzufügen, um der Aufzählung die gewünschten Einschränkungen und optionalen Beschriftungen hinzuzufügen, oder wählen Sie das Löschsymbol (
Die Arbeitsfläche wird mit den Änderungen aktualisiert. Wenn Sie dieses Schema in Zukunft untersuchen, können Sie die Einschränkungen für das Aufzählungsfeld in der rechten Leiste anzeigen und bearbeiten.
Vorgeschlagene Werte definieren suggested-values
Wählen Sie Aufzählungen und vorgeschlagene Werte und dann Vorgeschlagene Werte aus, um zusätzliche Steuerelemente anzuzeigen. Wählen Sie hier Zeile hinzufügen, um vorgeschlagene Werte hinzuzufügen.
Geben in der „Anzeigename“ einen benutzerfreundlichen Namen für den Wert ein, wie er in der Segmentierungs-Benutzeroberfläche angezeigt werden soll. Um weitere vorgeschlagene Werte hinzuzufügen, wählen Sie Zeile hinzufügen erneut aus und wiederholen Sie den Vorgang nach Bedarf. Um eine zuvor hinzugefügte Zeile zu entfernen, klicken Sie
Wenn Sie fertig sind, wählen Anwenden aus, um die Änderungen auf das Schema anzuwenden.
Vorgeschlagene Werte für Standardfelder verwalten
Einige Felder aus standardmäßigen XDM-Komponenten enthalten eigene vorgeschlagene Werte, z. B. eventType
aus der Klasse XDM ExperienceEvent. Sie können zwar zusätzliche vorgeschlagene Werte für ein Standardfeld erstellen, Sie können jedoch keine vorgeschlagenen Werte, die nicht von Ihrem Unternehmen definiert wurden, ändern oder entfernen. Beim Anzeigen eines Standardfelds in der Benutzeroberfläche werden die vorgeschlagenen Werte angezeigt, sind aber schreibgeschützt.
Um neue vorgeschlagene 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 Aufzählungen und empfohlene Werte evolution
Nachdem ein Schema mit einem Aufzählungsfeld verwendet wurde, um Daten in Experience 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, dieses Feld nur weniger einschränkend machen. Ein Feld kann nicht restriktiver gestaltet werden, als es bereits ist.
Bei Auflistungen und empfohlenen Werten gelten nach der Aufnahme die folgenden Regeln:
- Sie vorgeschlagene für standardmäßige und benutzerdefinierte Felder mit vorhandenen vorgeschlagenen Werten hinzufügen (KÖNNEN).
- Sie vorgeschlagene aus benutzerdefinierten Feldern mit vorhandenen vorgeschlagenen Werten entfernen (KANN).
- Sie KÖNNEN neue Aufzählungswerte für ein vorhandenes benutzerdefiniertes Aufzählungsfeld hinzufügen.
- Sie die Aufzählungswerte eines benutzerdefinierten Felds nur auf vorgeschlagene Werte umschalten oder es in eine Zeichenfolge ohne Aufzählung oder vorgeschlagene Werte konvertieren. Dieser Schalter kann nach der Anwendung nicht mehr rückgängig gemacht werden.
- Aufzählungen empfohlene Werte können aus Standardfeldern entfernt werden.
- Sie AUFZÄHLUNGSWERTE NICHT einem Feld ohne vorhandene AUFZÄHLUNG hinzufügen.
- Sie KÖNNEN weniger als alle vorhandenen Aufzählungswerte für ein benutzerdefiniertes Feld entfernen.
- Sie NICHT von vorgeschlagenen Werten zu einer Aufzählung wechseln.
Zusammenführungsregeln für Auflistungen und empfohlene Werte merging
Wenn mehrere Schemata dasselbe Aufzählungsfeld mit unterschiedlichen Konfigurationen verwenden und diese Schemata in einer Vereinigung enthalten sind, gelten bestimmte Regeln für die Abstimmung der Aufzählungsunterschiede. Die genauen Regeln hängen davon ab, ob die Schemas dasselbe Standardfeld referenzieren (z. B. eventType
) oder ob sie in verschiedenen Feldergruppen auf denselben benutzerdefinierten Feldpfad verweisen.
Wenn auf dasselbe Standardfeld verwiesen wird:
- Alle weiteren vorgeschlagenen Werte sind ANGEHÄNGT in der Vereinigung.
- Aktualisierungen der vorgeschlagenen Werte für denselben Aufzählungsschlüssel werden in Vereinigung AKTUALISIERT).
Wenn in verschiedenen Feldergruppen auf denselben benutzerdefinierten Feldpfad verwiesen wird:
- Alle weiteren vorgeschlagenen Werte sind ANGEHÄNGT in der Vereinigung.
- Wenn derselbe zusätzliche vorgeschlagene Wert in mehr als einem Schema definiert ist, werden diese Werte ZUSAMMENGEFÜHRT in der Vereinigung gespeichert. Mit anderen Worten, derselbe vorgeschlagene Wert wird nach der Zusammenführung nicht zweimal angezeigt.
Validierungsbeschränkungen
Aufgrund der aktuellen Systembeschränkungen gibt es zwei Fälle, in denen eine Aufzählung vom System während der Aufnahme nicht validiert wird:
- Die Aufzählung wird in einem „ArrayFeld“.
- Die Aufzählung ist mehr als eine Ebene tief in der Schemahierarchie definiert.
Nächste Schritte
In diesem Handbuch wurde beschrieben, wie Sie Aufzählungen 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 im folgenden Tutorial.
Informationen zum Definieren anderer XDM-Feldtypen in der Schema Editor finden Sie in der Übersicht unter Definieren von Feldern in der Benutzeroberfläche.