Creare e modificare schemi nell’interfaccia utente

Questa guida fornisce una panoramica su come creare, modificare e gestire schemi di Experience Data Model (XDM) per la tua organizzazione nell'interfaccia utente di Adobe Experience Platform.

IMPORTANTE

Gli schemi XDM sono estremamente personalizzabili e pertanto i passaggi necessari per creare uno schema possono variare a seconda del tipo di dati che si desidera acquisire dallo schema. Di conseguenza, questo documento copre solo le interazioni di base che è possibile eseguire con gli schemi nell'interfaccia utente ed esclude i passaggi correlati quali la personalizzazione di classi, mixin, tipi di dati e campi.

Per una panoramica completa del processo di creazione dello schema, seguire l'esercitazione sulla creazione dello schema per creare uno schema di esempio completo e acquisire dimestichezza con le numerose funzionalità della Schema Editor.

Prerequisiti

Questa guida richiede una buona conoscenza del sistema XDM. Per un'introduzione al ruolo di XDM all'interno dell'ecosistema Experience Platform, fare riferimento alla panoramica XDM e alle nozioni di base della composizione dello schema per una panoramica della struttura degli schemi.

Creare un nuovo schema

Nell'area di lavoro Schemas, selezionare Create schema nell'angolo superiore destro. Nel menu a discesa visualizzato, è possibile scegliere tra XDM Individual Profile e XDM ExperienceEvent come classe base per lo schema. In alternativa, è possibile selezionare Browse per selezionare dall'elenco completo delle classi disponibili oppure creare una nuova classe personalizzata.

Dopo aver selezionato una classe, viene visualizzato il simbolo Schema Editor e la struttura di base dello schema (fornita dalla classe) viene visualizzata nell'area di lavoro. Da qui, è possibile utilizzare la barra a destra per aggiungere un Display name e Description per lo schema.

È ora possibile iniziare a creare la struttura dello schema aggiungendo mixin.

Modificare uno schema esistente

NOTA

Una volta che uno schema è stato salvato e utilizzato per l'inserimento dei dati, è possibile apportare solo modifiche aggiuntive. Per ulteriori informazioni, vedere le regole dell'evoluzione dello schema.

Per modificare uno schema esistente, selezionare la scheda Browse, quindi selezionare il nome dello schema da modificare.

SUGGERIMENTO

È possibile utilizzare le funzionalità di ricerca e filtro dell'area di lavoro per facilitare la ricerca dello schema. Per ulteriori informazioni, consulta la guida Esplora risorse XDM.

Dopo aver selezionato uno schema, il simbolo Schema Editor viene visualizzato con la struttura dello schema visualizzata nel quadro. Ora è possibile aggiungere mixin allo schema, modificare i nomi visualizzati dei campi oppure modificare i mixin personalizzati esistenti se lo schema ne utilizza uno.

Aggiunta di mixaggi a uno schema

NOTA

In questa sezione viene illustrato come aggiungere mixin esistenti a uno schema. Se desiderate creare un nuovo mixin personalizzato, consultate la guida alla creazione e modifica di mixin.

Dopo aver aperto uno schema all'interno di Schema Editor, è possibile aggiungere campi allo schema tramite l'uso di mixin. Per iniziare, selezionare Add accanto a Mixins nella barra a sinistra.

Viene visualizzata una finestra di dialogo con un elenco di mixin selezionabili per lo schema. Poiché i mixin sono compatibili con una sola classe, saranno elencati solo i mixin associati alla classe selezionata dello schema. Per impostazione predefinita, i mixin elencati vengono ordinati in base alla loro popolarità di utilizzo all'interno dell'organizzazione.

Potete usare la barra di ricerca per individuare il mixin desiderato. Le miscele il cui nome corrisponde alla query vengono visualizzate in cima all’elenco. In Standard Fields vengono visualizzati i mixin contenenti campi che descrivono gli attributi di dati desiderati.

Selezionate la casella di controllo accanto al nome del mixin che desiderate aggiungere allo schema. Potete selezionare più mixin dall’elenco, con ciascun mixin selezionato che appare nella barra a destra.

SUGGERIMENTO

Per qualsiasi mixin elencato, potete passare il puntatore del mouse sull'icona delle informazioni () per visualizzare una breve descrizione del tipo di dati acquisito dal mixin. È inoltre possibile selezionare l'icona di anteprima () per visualizzare la struttura dei campi forniti dal mixin prima di decidere di aggiungerlo allo schema.

Dopo aver selezionato i mixin, selezionare Add mixin per aggiungerli allo schema.

La Schema Editor viene visualizzata di nuovo con i campi forniti dal mixin rappresentati nel quadro.

Abilita uno schema per il profilo cliente in tempo reale

I profili cliente in tempo reale consentono di acquisire dati da fonti diverse per creare una visione completa di ogni singolo cliente. Se si desidera che i dati acquisiti da uno schema partecipino a questo processo, è necessario abilitare lo schema per l'utilizzo in Profile.

IMPORTANTE

Per abilitare uno schema per Profile, è necessario che sia definito un campo di identità principale. Per ulteriori informazioni, vedere la guida relativa alla definizione dei campi identità.

Per abilitare lo schema, iniziare selezionando il nome dello schema nella barra a sinistra, quindi selezionare l'opzione Profile nella barra a destra.

Viene visualizzato un messaggio di avviso che avvisa che, una volta attivato e salvato, uno schema non può essere disabilitato. Selezionare Enable per continuare.

Il quadro viene nuovamente visualizzato con l'attivazione dell'opzione Profile.

IMPORTANTE

Poiché lo schema non è ancora salvato, questo è il punto di non ritorno se si cambia idea di consentire allo schema di partecipare al profilo cliente in tempo reale: dopo aver salvato uno schema abilitato, non sarà più possibile disattivarlo. Selezionare di nuovo l'opzione Profile per disabilitare lo schema.

Per completare il processo, selezionare Save per salvare lo schema.

Lo schema ora è abilitato per l'uso in Real-time Customer Profile (Profilo cliente in tempo reale). Quando Platform (Piattaforma) trasferisce i dati in set di dati basati su questo schema, questi verranno incorporati nei dati del profilo amalgamato.

Modificare i nomi visualizzati per i campi dello schema

Dopo aver assegnato una classe e aggiunto mixin a uno schema, è possibile modificare i nomi visualizzati di qualsiasi campo dello schema, indipendentemente dal fatto che tali campi siano stati forniti da risorse XDM standard o personalizzate.

NOTA

Tenere presente che i nomi visualizzati dei campi appartenenti a classi o mixin standard possono essere modificati solo nel contesto di uno schema specifico. In altre parole, la modifica del nome visualizzato di un campo standard in uno schema non ha effetto sugli altri schemi che utilizzano la stessa classe o lo stesso mixin associato.

Per modificare il nome visualizzato di un campo dello schema, selezionare il campo nell'area di lavoro. Nella barra a destra, immettete il nuovo nome in Display name.

Selezionate Apply nella barra a destra e gli aggiornamenti del quadro mostrano il nuovo nome visualizzato del campo. Selezionare Save per applicare le modifiche allo schema.

Modificare la classe di uno schema

È possibile modificare la classe di uno schema in qualsiasi punto del processo di composizione iniziale prima che lo schema sia stato salvato.

AVVERTENZA

La riassegnazione della classe per uno schema deve essere eseguita con estrema cautela. I mixin sono compatibili solo con determinate classi, pertanto la modifica della classe reimposterà il quadro e tutti i campi aggiunti.

Per riassegnare una classe, selezionate Assign nella parte sinistra del quadro.

Viene visualizzata una finestra di dialogo in cui sono elencate tutte le classi disponibili, incluse quelle definite dall'organizzazione (il proprietario è "Customer"), nonché le classi standard definite dal Adobe .

Selezionate una classe dall’elenco per visualizzarne la descrizione sul lato destro della finestra di dialogo. Potete anche selezionare Preview class structure per visualizzare i campi e i metadati associati alla classe. Selezionare Assign class per continuare.

Viene visualizzata una nuova finestra di dialogo in cui viene richiesto di confermare l'assegnazione di una nuova classe. Selezionare Assign per confermare.

Dopo aver confermato la modifica della classe, il quadro verrà reimpostato e tutti i progressi della composizione andranno persi.

Passaggi successivi

In questo documento sono state illustrate le nozioni di base per la creazione e la modifica degli schemi nell’interfaccia utente della piattaforma. È vivamente consigliato di consultare l'esercitazione sulla creazione di schemi per un flusso di lavoro completo per la creazione di uno schema completo nell'interfaccia utente, inclusa la creazione di mixin personalizzati e di tipi di dati per casi di utilizzo univoci.

Per ulteriori informazioni sulle funzionalità dell'area di lavoro Schemas, vedere la panoramica dell'area di lavoro Schemas.

Per informazioni su come gestire gli schemi nell'API Schema Registry, consulta la guida dell'endpoint degli schemi.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free