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.

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 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.

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

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 ( Bild des Löschsymbols ) neben einer zuvor hinzugefügten Zeile aus, um sie zu entfernen. Wenn Sie fertig sind, wählen Anwenden 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 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.

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

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 das Löschsymbol neben der betreffenden Zeile.

Wenn Sie fertig sind, wählen Anwenden 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 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.

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 Zeile hinzufügen 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