Definieren von Aufzählungen 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.

Enums 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 Suggested values die Kennzeichnung eines Satzes empfohlener Werte für ein Zeichenfolgenfeld, durch die die Werte, die es aufnehmen kann, nicht beschränkt werden. 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 ​ in der Benutzeroberfläche von Adobe Experience Platform und Festlegen des Typs auf String haben Sie die Möglichkeit, für dieses Feld einen Aufzählungs oder empfohlene Werte zu definieren.

Bild, das die Option Aufzählung und empfohlene Werte zeigt, die für ein Zeichenfolgenfeld in der Benutzeroberfläche aktiviert ist

In diesem Dokument wird beschrieben, wie Sie Aufzählungen und empfohlene Werte im Arbeitsbereich der Schemas-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 Enums and Suggested Values und dann Enums 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 Add row aus.

Bild mit der in der Benutzeroberfläche ausgewählten Option „Aufzählungen“

Unter der Spalte Value müssen Sie den genauen Wert angeben, auf den Sie das Feld beschränken möchten. Optional können Sie auch eine benutzerfreundliche Display Name für die Einschränkung angeben, die sich darauf auswirkt, wie der Wert in der Segmentierung dargestellt wird.

Verwenden Sie Add row weiterhin, um der Aufzählung die gewünschten Einschränkungen und optionalen Beschriftungen hinzuzufügen, oder wählen Sie das Löschsymbol ( Bild des Löschsymbols ) neben einer zuvor hinzugefügten Zeile aus, um sie zu entfernen. Wenn Sie fertig sind, wählen Sie Apply aus, um die Änderungen auf das Schema anzuwenden.

Bild mit den Aufzählungswerten und Anzeigenamen, die für das Zeichenfolgenfeld in der Benutzeroberfläche ausgefüllt sind

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 Enums and Suggested Values und dann Suggested Values aus, damit zusätzliche Steuerelemente angezeigt werden. Wählen Sie hier Add row , um mit dem Hinzufügen vorgeschlagener Werte zu beginnen.

Bild mit der in der Benutzeroberfläche ausgewählten Option „Vorgeschlagene Werte“

Geben Sie in der Spalte Display Name 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 erneut Add row und wiederholen Sie den Vorgang nach Bedarf. Um eine zuvor hinzugefügte Zeile zu entfernen, klicken Sie das Löschsymbol neben der betreffenden Zeile.

Wenn Sie fertig sind, wählen Sie Apply aus, um die Änderungen auf das Schema anzuwenden.

Bild mit den Aufzählungswerten und Anzeigenamen, die für das Zeichenfolgenfeld in der Benutzeroberfläche ausgefüllt sind

NOTE
Die aktualisierten empfohlenen Werte eines Felds, die in der Segmentierungs-Benutzeroberfläche angezeigt werden sollen, vergehen ungefähr fünf Minuten.

Vorgeschlagene Werte für Standardfelder verwalten

Einige Felder aus standardmäßigen XDM-Komponenten enthalten eigene vorgeschlagene Werte, z. B. eventType aus der XDM ExperienceEvent-Klasse. 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.

Bild mit den Aufzählungswerten und Anzeigenamen, die für das Zeichenfolgenfeld in der Benutzeroberfläche ausgefüllt sind

Um neue vorgeschlagene Werte für ein Standardfeld hinzuzufügen, wählen Sie Add row aus. Um einen vorgeschlagenen Wert zu entfernen, der zuvor von Ihrer Organisation hinzugefügt wurde, wählen Sie das Löschsymbol neben der betreffenden Zeile aus.

Bild mit den Aufzählungswerten und Anzeigenamen, die für das Zeichenfolgenfeld in der Benutzeroberfläche ausgefüllt sind

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:

  1. Die Aufzählung wird in einem „ArrayFeld“ ​.
  2. 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.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07