Definire enum e valori consigliati nell’interfaccia utente

In Experience Data Model (XDM), è possibile assegnare a un campo stringa un set predefinito di valori accettati o consigliati per controllare meglio quali valori vengono acquisiti in quel campo o come si comporterà nella segmentazione.

Enum vincolare 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 degli enum, il Valori consigliati consente di indicare un set di valori consigliati per un campo stringa che non vincola i valori che è possibile acquisire. Al contrario, i valori suggeriti influenzano i 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 l’impostazione del tipo su Stringa, ti viene offerta l’opzione di definire un enum o valori consigliati per quel campo.

Questo documento illustra come definire enum e valori suggeriti nel Schemi Area di lavoro dell’interfaccia utente. Per una rapida panoramica degli enum e dei valori suggeriti, tra cui come configurarli nell’interfaccia utente e i relativi effetti a valle, guarda il video seguente:

Definire un enum

Seleziona Enum e valori consigliati, quindi seleziona Enum. Vengono visualizzati altri controlli che consentono di specificare i vincoli di valore per l’enum. Per aggiungere un vincolo, seleziona Aggiungi riga.

Sotto la Valore È necessario specificare il valore esatto a cui si desidera vincolare il campo. Facoltativamente, puoi fornire un Nome visualizzato anche per il vincolo, che influisce sul modo in cui 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 () accanto a una riga aggiunta in precedenza per rimuoverla. Al termine, seleziona Applica per applicare le modifiche allo schema.

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

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

Sotto la Nome visualizzato fornisci un nome descrittivo per il valore come desideri che appaia nell’interfaccia utente Segmentazione. Per aggiungere altri valori consigliati, seleziona Aggiungi riga e ripetere il processo in base alle esigenze. Per rimuovere una riga aggiunta in precedenza, seleziona accanto alla riga in questione.

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

Gestione dei valori consigliati per i campi standard

Alcuni campi dei componenti XDM standard contengono i valori consigliati, ad esempio eventType dal ExperienceEvent XDM Classe. Mentre è possibile creare valori aggiuntivi consigliati per un campo standard, non è possibile modificare o rimuovere i valori suggeriti non definiti dall’organizzazione. Quando visualizzi un campo standard nell’interfaccia utente, i valori suggeriti vengono visualizzati ma sono di sola lettura.

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

Regole di evoluzione per gli enum e i valori consigliati

Dopo aver utilizzato uno schema con un campo enum per acquisire dati in Platform, qualsiasi ulteriore modifica apportata alla definizione dello schema deve essere conforme ai dati già presenti nel sistema. In generale, le modifiche apportate a un campo esistente possono solo rendere tale campo less restrittivo. Un campo non può essere reso più restrittivo di quanto non sia già.

Quando si tratta di enum e valori suggeriti, le seguenti regole si applicano dopo l’acquisizione:

• You PUÒ aggiungi valori consigliati per i campi standard e personalizzati con valori consigliati esistenti.
• You PUÒ rimuovi i valori consigliati dai campi personalizzati con valori consigliati esistenti.
• You PUÒ aggiungi nuovi valori enum per un campo enum personalizzato esistente.
• You PUÒ cambia i valori enum di un campo personalizzato solo in valori consigliati o li converte in una stringa senza enum o valori consigliati. Questa opzione non può essere annullata dopo l'applicazione.
• You IMPOSSIBILE rimuovi enum o valori consigliati dai campi standard.
• You IMPOSSIBILE aggiungi valori enum a un campo senza enum esistente.
• You IMPOSSIBILE rimuovi meno di tutti i valori enum esistenti per un campo personalizzato.
• You IMPOSSIBILE passa da valori consigliati a un enum.

Unione di regole per enum e valori consigliati

Se più schemi utilizzano lo stesso campo enum con diverse configurazioni e tali schemi sono inclusi in un’unione, alcune regole si applicano quando si tratta di riconciliare le differenze enum. Le regole esatte dipendono dal fatto che gli schemi facciano 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 valori suggeriti aggiuntivi sono AGGIUNTO nell'unione.
• Gli aggiornamenti apportati ai valori suggeriti per la stessa chiave enum sono AGGIORNATO nell'unione.

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

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

Limiti di convalida

A causa delle attuali limitazioni del sistema, ci sono due casi in cui un enum non viene convalidato dal sistema durante l'acquisizione:

1. L'enum è definito su un campo matrice.
2. L'enum è definito a più livelli nella gerarchia dello schema.

Passaggi successivi

Questa guida illustra come definire enum e valori consigliati per i campi stringa nell’interfaccia utente di . Per informazioni su come gestire gli enum e i valori consigliati utilizzando l’API del Registro di sistema dello schema, consulta quanto segue tutorial.

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

Risorse Business.Adobe.com