Definire enumerazioni e valori suggeriti nell’interfaccia utente enums-and-suggested-values

In Experience Data Model (XDM), a un campo stringa può essere assegnato un set predefinito di valori accettati o suggeriti per controllare meglio quali valori vengono acquisiti in tale campo o come si comporterà nella segmentazione.

Enumerazioni vincola i valori che possono essere acquisiti per un campo stringa a un set predefinito. Se tenti di acquisire dati in un campo enum e il valore non corrisponde a nessuno di quelli definiti nella relativa configurazione, l’acquisizione verrà negata.

A differenza delle enumerazioni, Valori consigliati L’opzione consente a di denotare un insieme di valori consigliati per un campo stringa che non vincolano i valori che può acquisire. I valori suggeriti influiscono invece sui valori predefiniti disponibili nel Interfaccia utente di segmentazione quando si include il campo stringa come attributo.

Quando definizione di un nuovo campo nell’interfaccia utente di Adobe Experience Platform e impostando il tipo su Stringa, è possibile definire un’ enum o valori suggeriti per quel campo.

Immagine che mostra l’opzione Enum e valori suggeriti abilitata per un campo stringa nell’interfaccia utente

Questo documento illustra come definire le enumerazioni e i valori suggeriti nella Schemi Workspace dell’interfaccia utente. Per una rapida panoramica sulle enumerazioni e sui valori suggeriti, tra cui come configurarle nell’interfaccia utente e i relativi effetti a valle, guarda il video seguente:

Definire un'enumerazione enum

Seleziona Enumerazioni e valori suggeriti, quindi seleziona Enumerazioni. Vengono visualizzati controlli aggiuntivi che consentono di specificare i vincoli di valore per l'enum. Per aggiungere un vincolo, selezionate Aggiungi riga.

Immagine che mostra l’opzione Enumerazioni selezionata nell’interfaccia utente

Sotto Valore , è necessario fornire il valore esatto al quale si desidera vincolare il campo. Facoltativamente, puoi fornire una soluzione Nome visualizzato anche per il vincolo, che influisce su come il valore verrà rappresentato nella segmentazione.

Continua a utilizzare Aggiungi riga per aggiungere i vincoli desiderati e le etichette facoltative all'enum, oppure selezionare l'icona elimina ( Immagine dell’icona Elimina ) accanto a una riga aggiunta in precedenza per rimuoverla. Al termine, seleziona Applica per applicare le modifiche allo schema.

Immagine che mostra i valori enum e i nomi visualizzati compilati per il campo stringa nell’interfaccia utente

L’area di lavoro viene aggiornata per riflettere le modifiche. Quando esplori questo schema in futuro, puoi visualizzare e modificare i vincoli per il campo enum nella barra a destra.

Definire i valori suggeriti suggested-values

Seleziona Enumerazioni e valori suggeriti, quindi seleziona Valori consigliati per visualizzare controlli aggiuntivi. Da qui, seleziona Aggiungi riga per iniziare ad aggiungere i valori suggeriti.

Immagine che mostra l’opzione Valori consigliati selezionata nell’interfaccia utente

Sotto Nome visualizzato , fornisci un nome descrittivo per il valore da visualizzare nell’interfaccia utente Segmentazione. Per aggiungere altri valori suggeriti, seleziona Aggiungi riga e ripetere il processo in base alle esigenze. Per rimuovere una riga aggiunta in precedenza, seleziona l’icona elimina accanto alla riga in questione.

Al termine, seleziona Applica per applicare le modifiche allo schema.

Immagine che mostra i valori enum e i nomi visualizzati compilati per il campo stringa nell’interfaccia utente

NOTE
Nell’interfaccia utente di segmentazione viene rilevato un ritardo di circa cinque minuti rispetto ai valori consigliati aggiornati di un campo.

Gestisci valori suggeriti per campi standard

Alcuni campi dei componenti XDM standard contengono i propri valori consigliati, ad esempio eventType dal XDM ExperienceEvent classe. Sebbene sia possibile creare ulteriori valori suggeriti per un campo standard, non è possibile modificare o rimuovere i valori suggeriti non definiti dall'organizzazione. Quando si visualizza un campo standard nell’interfaccia utente, i relativi valori consigliati vengono visualizzati ma sono di sola lettura.

Immagine che mostra i valori enum e i nomi visualizzati compilati per il campo stringa nell’interfaccia utente

Per aggiungere nuovi valori suggeriti per un campo standard, seleziona Aggiungi riga. Per rimuovere un valore suggerito precedentemente aggiunto dall’organizzazione, seleziona l’icona elimina accanto alla riga in questione.

Immagine che mostra i valori enum e i nomi visualizzati compilati per il campo stringa nell’interfaccia utente

Regole di evoluzione per enum e valori suggeriti evolution

Dopo aver utilizzato uno schema con un campo enum per acquisire i dati in Platform, eventuali ulteriori modifiche apportate alla definizione dello schema devono essere conformi ai dati già presenti nel sistema. In generale, le modifiche apportate a un campo esistente possono solo creare tale campo meno restrittivo. Un campo non può essere reso più restrittivo di quanto non lo sia già.

Per quanto riguarda le enumerazioni e i valori suggeriti, dopo l’acquisizione si applicano le seguenti regole:

  • Tu CAN aggiungi i valori consigliati per i campi standard e personalizzati con i valori suggeriti esistenti.
  • Tu CAN rimuovi i valori suggeriti dai campi personalizzati con i valori suggeriti esistenti.
  • Tu CAN aggiungere nuovi valori enum per un campo enum personalizzato esistente.
  • Tu CAN modifica i valori enum di un campo personalizzato in valori consigliati o convertiscili in una stringa senza enum o valori suggeriti. Questa opzione non può essere annullata una volta applicata.
  • Tu NON PUÒ rimuovere le enumerazioni o i valori suggeriti dai campi standard.
  • Tu NON PUÒ aggiungere valori enum a un campo senza enum esistente.
  • Tu NON PUÒ rimuovere meno di tutti i valori enum esistenti per un campo personalizzato.
  • Tu NON PUÒ passa dai valori suggeriti a un'enumerazione.

Unione di regole per enum e valori suggeriti merging

Se più schemi utilizzano lo stesso campo enum con configurazioni diverse e tali schemi sono inclusi in un'unione, si applicano determinate regole per riconciliare le differenze enum. Le regole esatte dipendono dallo schema che fa riferimento allo stesso campo standard (come eventType) o se fanno riferimento allo stesso percorso di campo personalizzato in gruppi di campi diversi.

Se si fa riferimento allo stesso campo standard:

  • Eventuali altri valori suggeriti sono AGGIUNTO nell'unione.
  • Gli aggiornamenti apportati ai valori suggeriti per la stessa chiave enumerazione sono AGGIORNATO nell'unione.

Se si fa riferimento allo stesso percorso di campo personalizzato in gruppi di campi diversi:

  • Eventuali altri valori suggeriti sono AGGIUNTO nell'unione.
  • Se lo stesso valore aggiuntivo suggerito è definito in più schemi, tali valori sono UNITO nell'unione. In altre parole, lo stesso valore suggerito non verrà visualizzato due volte dopo l’unione.

Limitazioni della convalida

A causa delle attuali limitazioni del sistema, ci sono due casi in cui un’enumerazione non viene convalidata dal sistema durante l’acquisizione:

  1. L'enumerazione è definita su un campo array.
  2. L'enum è definita a più di un livello di profondità nella gerarchia dello schema.

Passaggi successivi

Questa guida illustra come definire le enumerazioni e i valori consigliati per i campi stringa nell’interfaccia utente. Per informazioni su come gestire le enumerazioni e i valori suggeriti utilizzando l’API Schema Registry, consulta quanto segue esercitazione.

Per scoprire come definire altri tipi di campi XDM in Schema Editor, consulta la panoramica su definizione dei campi nell’interfaccia utente.

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