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.
Enums 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, l'opzione Valori suggeriti consente di indicare un insieme di valori consigliati per un campo stringa che non vincola i valori che può acquisire. Al contrario, i valori suggeriti influiscono sui valori predefiniti disponibili nell'Interfaccia utente segmentazione quando si include il campo stringa come attributo.
Quando definisci un nuovo campo nell'interfaccia utente di Adobe Experience Platform e imposti il tipo su String, puoi definire un enum o valori suggeriti per quel campo.
Questo documento illustra come definire le enumerazioni e i valori suggeriti nell'area di lavoro dell'interfaccia utente Schemi. 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 Numeri e valori suggeriti, quindi seleziona Numeri. Vengono visualizzati controlli aggiuntivi che consentono di specificare i vincoli di valore per l'enum. Per aggiungere un vincolo, selezionare Aggiungi riga.
Nella colonna Valore è necessario specificare il valore esatto al quale si desidera vincolare il campo. Facoltativamente, puoi anche fornire un Nome visualizzato descrittivo 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 seleziona l'icona Elimina (
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 Numeri e valori suggeriti, quindi seleziona Valori suggeriti per visualizzare ulteriori controlli. Da qui, seleziona Aggiungi riga per iniziare ad aggiungere i valori suggeriti.
Nella colonna Nome visualizzato, specifica un nome descrittivo per il valore da visualizzare nell'interfaccia utente Segmentazione. Per aggiungere altri valori suggeriti, selezionare Aggiungi riga di nuovo e ripetere il processo in base alle esigenze. Per rimuovere una riga aggiunta in precedenza, selezionare
Al termine, selezionare Applica per applicare le modifiche allo schema.
Gestisci valori suggeriti per campi standard
Alcuni campi dei componenti XDM standard contengono i propri valori consigliati, ad esempio eventType della classe XDM ExperienceEvent. 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.
Per aggiungere nuovi valori suggeriti per un campo standard, selezionare Aggiungi riga. Per rimuovere un valore suggerito precedentemente aggiunto dall'organizzazione, selezionare
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 rendere il 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:
- È possibile aggiungere valori suggeriti per campi standard e personalizzati con valori suggeriti esistenti.
- È possibile rimuovere i valori suggeriti dai campi personalizzati con valori suggeriti esistenti.
- CAN aggiungi nuovi valori enum per un campo enum personalizzato esistente.
- È POSSIBILE convertire i valori enum di un campo personalizzato solo in valori suggeriti o convertirli in una stringa senza enum o valori suggeriti. Questa opzione non può essere annullata una volta applicata.
- IMPOSSIBILE rimuovere enum o valori suggeriti dai campi standard.
- IMPOSSIBILE aggiungere valori enum a un campo senza enum esistente.
- IMPOSSIBILE rimuovere meno di tutti i valori enum esistenti per un campo personalizzato.
- IMPOSSIBILE passare 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 dal fatto che gli schemi facciano riferimento allo stesso campo standard (come eventType) o allo stesso percorso di campo personalizzato in gruppi di campi diversi.
Se si fa riferimento allo stesso campo standard:
- Eventuali altri valori suggeriti sono APPENDED nell'unione.
- Gli aggiornamenti apportati ai valori suggeriti per la stessa chiave enum sono AGGIORNATI nell'unione.
Se si fa riferimento allo stesso percorso di campo personalizzato in gruppi di campi diversi:
- Eventuali altri valori suggeriti sono APPENDED nell'unione.
- Se lo stesso valore aggiuntivo suggerito è definito in più schemi, tali valori sono MERGED 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:
- L'enumerazione è definita in un campo matrice.
- 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 la seguente esercitazione.
Per informazioni su come definire altri tipi di campi XDM in Schema Editor, consulta la panoramica su definizione dei campi nell'interfaccia utente.