Creare uno schema utilizzando la variabile Schema Editor

L'interfaccia utente di Adobe Experience Platform consente di creare e gestire gli schemi Experience Data Model (XDM) in un'area di lavoro visiva interattiva denominata Schema Editor. Questa esercitazione illustra come creare uno schema utilizzando Schema Editor.

NOTA

A scopo dimostrativo, i passaggi di questa esercitazione includono la creazione di uno schema di esempio che descrive i membri di un programma di fidelizzazione dei clienti. Sebbene sia possibile utilizzare questi passaggi per creare uno schema diverso per scopi propri, è consigliabile seguire la creazione dello schema di esempio per apprendere le funzionalità di Schema Editor.

Se invece si preferisce comporre uno schema utilizzando l'API Schema Registry, iniziare leggendo la Schema Registry guida allo sviluppatore prima di provare l'esercitazione su creazione di uno schema mediante l'API.

Introduzione

Questa esercitazione richiede una conoscenza approfondita dei vari aspetti di Adobe Experience Platform coinvolti nella creazione dello schema. Prima di iniziare questa esercitazione, consulta la documentazione relativa ai seguenti concetti:

Aprire l'area di lavoro Schemas

L'area di lavoro di Schemas nell'interfaccia di Platform fornisce una visualizzazione di Schema Library, consentendo di visualizzare la gestione degli schemi disponibili per la propria organizzazione. L'area di lavoro include anche il Schema Editor, il quadro su cui è possibile comporre uno schema durante l'esercitazione.

Dopo aver eseguito l'accesso a Experience Platform, selezionare Schemas nella barra di navigazione a sinistra per aprire l'area di lavoro Schemas. Nella scheda Browse è visualizzato un elenco di schemi (una rappresentazione di Schema Library) che è possibile visualizzare e personalizzare. L'elenco include il nome, il tipo, la classe e il comportamento (record o serie temporali) su cui si basa lo schema, nonché la data e l'ora dell'ultima modifica dello schema.

Per ulteriori informazioni, consulta la guida Esplora risorse XDM esistenti nell'interfaccia utente.

Creare e assegnare un nome a uno schema

Per iniziare a comporre uno schema, selezionare Create schema nell'angolo superiore destro dell'area di lavoro Schemas. Viene visualizzato un menu a discesa che consente di scegliere tra le classi XDM Individual Profile e XDM ExperienceEvent di base. Se queste classi non sono adatte alle vostre esigenze, potete anche selezionare Browse per scegliere tra le altre classi disponibili o creare una nuova classe.

Ai fini di questa esercitazione, selezionare XDM Individual Profile.

Viene visualizzato il simbolo Schema Editor. Questo è il quadro su cui si compone lo schema. Poiché è stata scelta una classe XDM standard su cui basare lo schema, quando si arriva nell'editor viene automaticamente creato uno schema senza titolo nella sezione Structure del quadro, insieme ai campi standard inclusi in tutti gli schemi basati su tale classe. La classe assegnata per lo schema è elencata anche in Class nella sezione Composition.

NOTA

È possibile modificare la classe di uno schema in qualsiasi momento durante il processo di composizione iniziale prima che lo schema sia stato salvato, ma questo deve essere fatto con estrema cautela. I mixin sono compatibili solo con determinate classi, pertanto la modifica della classe reimposterà il quadro e tutti i campi aggiunti.

Utilizzare i campi a destra dell'editor per fornire un nome visualizzato e una descrizione facoltativa per lo schema. Una volta inserito un nome, il quadro si aggiorna per riflettere il nuovo nome dello schema.

Quando si decide un nome per lo schema, è necessario tenere presenti diverse considerazioni importanti:

  • I nomi dello schema devono essere brevi e descrittivi in modo che lo schema possa essere facilmente trovato in un secondo momento.
  • I nomi degli schemi devono essere univoci, il che significa che devono essere sufficientemente specifici da non essere riutilizzati in futuro. Se, ad esempio, l'organizzazione dispone di programmi di fedeltà separati per marchi diversi, sarebbe opportuno assegnare al proprio schema il nome "Marca A Fedeltà Members", in modo da distinguere facilmente gli altri schemi di fedeltà definiti in seguito.
  • È inoltre possibile utilizzare la descrizione dello schema per fornire eventuali informazioni contestuali aggiuntive relative allo schema.

Questa esercitazione costituisce uno schema per l'acquisizione di dati relativi ai membri di un programma fedeltà, pertanto lo schema è denominato "Membri fedeltà".

Aggiungere un mixin

È ora possibile iniziare ad aggiungere campi allo schema aggiungendo mixin. Un mixin è un gruppo di uno o più campi spesso utilizzati insieme per descrivere un concetto particolare. Questa esercitazione utilizza i mixin per descrivere i membri del programma fedeltà e acquisire informazioni chiave come nome, compleanno, numero di telefono, indirizzo e molto altro.

Per aggiungere un mixin, selezionare Add nella sottosezione Mixins.

Viene visualizzata una nuova finestra di dialogo con un elenco dei mixin disponibili. Ciascun mixin è destinato solo a una classe specifica, pertanto nella finestra di dialogo sono elencati solo i mixin compatibili con la classe selezionata (in questo caso, la classe XDM Individual Profile). Se si utilizza una classe XDM standard, l'elenco dei mixin verrà ordinato in modo intelligente in base alla popolarità dell'utilizzo.

Selezionando un mixin dall’elenco, questo viene visualizzato nella barra a destra. Potete selezionare più mixin, se lo desiderate, aggiungendo ognuno all'elenco nella barra a destra prima di confermare. Inoltre, sul lato destro del mixin attualmente selezionato viene visualizzata un’icona che consente di visualizzare in anteprima la struttura dei campi disponibili.

Quando visualizzate l'anteprima di un mixin, nella barra a destra viene fornita una descrizione dettagliata dello schema del mixin. Potete anche scorrere i campi del mixin nel quadro fornito. Selezionando campi diversi, la barra laterale destra si aggiorna per visualizzare i dettagli relativi al campo in questione. Selezionate Back al termine dell'anteprima per tornare alla finestra di dialogo di selezione del mixin.

Per questa esercitazione, selezionate il mixin Demographic Details, quindi selezionate Add mixin.

Lo schema quadro viene nuovamente visualizzato. La sezione Mixins ora elenca "Demographic Details" e la sezione Structure include i campi forniti dal mixin. Potete selezionare il nome del mixin nella sezione Mixins per evidenziare i campi specifici che fornisce all'interno del quadro.

Questo mixin fornisce diversi campi sotto il nome di livello principale person con il tipo di dati "Person". Questo gruppo di campi descrive informazioni su un individuo, quali nome, data di nascita e genere.

NOTA

Tenere presente che i campi possono utilizzare tipi scalari (ad esempio stringa, integer, array o data), nonché qualsiasi tipo di dati (un gruppo di campi che rappresenta un concetto comune) definito all'interno di Schema Registry.

Tenere presente che il campo name ha un tipo di dati "Person name", il che significa che descrive anche un concetto comune e contiene campi secondari relativi al nome come nome, cognome, titolo di cortesia e suffisso.

Selezionare i diversi campi all'interno dell'area di lavoro per visualizzare eventuali altri campi che contribuiscono alla struttura dello schema.

Aggiungere un altro mixin

Ora potete ripetere gli stessi passaggi per aggiungere un altro mixin. Quando visualizzate la finestra di dialogo Add mixin, il mixin "Demographic Details" è stato disattivato e non è possibile selezionare la casella di controllo accanto. Ciò impedisce la duplicazione accidentale di mixin già inclusi nello schema corrente.

Per questa esercitazione, selezionate il mixin "Personal Contact Details" dalla finestra di dialogo, quindi selezionate Add mixin per aggiungerlo allo schema.

Una volta aggiunto, il quadro viene nuovamente visualizzato. "Personal Contact Details" è ora elencato in Mixins nella sezione Composition e i campi per l'indirizzo della casa, il telefono cellulare e altro ancora sono stati aggiunti in Structure.

Analogamente al campo name, i campi appena aggiunti rappresentano concetti relativi a più campi. Ad esempio, homeAddress ha un tipo di dati "Postal address" e mobilePhone ha un tipo di dati "Phone number". È possibile selezionare ciascuno di questi campi per espanderli e visualizzare i campi aggiuntivi inclusi nel tipo di dati.

Definire un nuovo mixin

Lo schema "Loyalty Members" è concepito per acquisire dati relativi ai membri di un programma fedeltà, pertanto richiederà alcuni campi specifici relativi alla fedeltà. Non sono disponibili mixin standard che contengono i campi necessari, pertanto sarà necessario definire un nuovo mixin.

Questa volta, quando si apre la finestra di dialogo Add Mixin, selezionare Create New Mixin. Vi verrà quindi chiesto di fornire un nome visualizzato e una descrizione per il mixin.

Come per i nomi delle classi, il nome del mixin deve essere breve e semplice, descrivendo il contributo del mixin allo schema. Anche questi sono univoci, quindi non sarà possibile riutilizzare il nome e quindi dovrà essere sicuro che sia sufficientemente specifico.

Per questa esercitazione, denominate il nuovo mixin "Dettagli fedeltà".

Selezionare Add mixin per tornare alla cartella Schema Editor. "Loyalty Details" dovrebbe ora apparire sotto Mixins sul lato sinistro del quadro, ma non ci sono ancora campi associati ad esso e quindi non ci sono nuovi campi sotto Structure.

Aggiungere campi al mixin

Dopo aver creato il mixin "Dettagli fedeltà", è ora di definire i campi che il mixin contribuirà allo schema.

Per iniziare, selezionate il nome del mixin nella sezione Mixins. A questo punto, le proprietà del mixin vengono visualizzate sul lato destro dell'editor e accanto al nome dello schema in Structure viene visualizzata un'icona più (+).

Selezionare l'icona più (+) accanto a "Loyalty Members" per creare un nuovo nodo nella struttura. Questo nodo (denominato _tenantId in questo esempio) rappresenta l'ID tenant dell'organizzazione IMS, preceduto da un carattere di sottolineatura. La presenza dell'ID tenant indica che i campi che si sta aggiungendo sono contenuti nello spazio dei nomi dell'organizzazione.

In altre parole, i campi che state aggiungendo sono univoci per la vostra organizzazione e verranno salvati in Schema Registry in un'area specifica accessibile solo dalla vostra organizzazione. I campi definiti devono sempre essere aggiunti allo spazio nomi tenant per evitare conflitti con nomi di altre classi, mixin, tipi di dati e campi standard.

All'interno di tale nodo con nome è presente un "New Field". Questo è l'inizio del mixin "Loyalty Details".

Utilizzando i controlli a destra dell'editor, si crea innanzitutto un campo loyalty con il tipo "Object" che verrà utilizzato per contenere i campi relativi alla fedeltà. Al termine, selezionare Apply.

Le modifiche vengono applicate e viene visualizzato l'oggetto loyalty appena creato. Selezionate l'icona più (+) accanto all'oggetto per aggiungere altri campi relativi alla fedeltà. Viene visualizzato un "New Field" e la sezione Field properties è visibile sul lato destro del quadro.

Ogni campo richiede le seguenti informazioni:

  • Field Name: Il nome del campo, scritto in cammello. Esempio: loyaltyLevel
  • Display Name: Il nome del campo, scritto nel caso del titolo. Esempio: Livello fedeltà
  • Type: Il tipo di dati del campo. Ciò include tipi scalari di base e qualsiasi tipo di dati definito in Schema Registry. Esempi: String, Integer, Boolean, Person, Address, Phone number ecc.
  • Description: Una descrizione facoltativa del campo deve essere inclusa, scritta in caso di frase, con un massimo di 200 caratteri.

Il primo campo per l'oggetto Loyalty sarà una stringa denominata loyaltyId. Quando si imposta il tipo di nuovo campo su "String", la sezione Field properties viene compilata con diverse opzioni per l'applicazione di vincoli, tra cui valori predefiniti, formato e lunghezza massima.

Sono disponibili diverse opzioni di vincolo a seconda del tipo di dati selezionato. Poiché loyaltyId sarà un indirizzo e-mail, selezionare "email" dal menu a discesa Format. Selezionare Apply per applicare le modifiche.

Aggiungete altri campi al mixin

Dopo aver aggiunto il campo loyaltyId, potete aggiungere altri campi per acquisire informazioni relative alla fedeltà, ad esempio:

  • Points (integer)
  • Member-from (data)

Per aggiungere ciascun campo allo schema, selezionare l'icona più (+) accanto all'oggetto loyalty e compilare le informazioni richieste.

Una volta completato, l'oggetto Fedeltà conterrà campi per ID fedeltà, punti e membro da.

Aggiungere un campo enum al mixin

Durante la definizione dei campi in Schema Editor, è possibile applicare alcune opzioni aggiuntive ai tipi di campo di base al fine di fornire ulteriori limitazioni ai dati che il campo può contenere. I casi di utilizzo di questi vincoli sono illustrati nella tabella seguente:

Vincolo Descrizione
Required Indica che il campo è obbligatorio per l'inserimento dei dati. Eventuali dati caricati in un dataset basato su questo schema che non contiene questo campo avranno esito negativo al momento dell'inserimento.
Array Indica che il campo contiene un array di valori, ciascuno con il tipo di dati specificato. Ad esempio, se si utilizza questo vincolo su un campo con un tipo di dati "String", il campo conterrà un array di stringhe.
Enum Indica che questo campo deve contenere uno dei valori di un elenco enumerato di possibili valori.
Identity Indica che questo campo è un campo identità. Ulteriori informazioni sui campi di identità sono fornite più avanti in questa esercitazione.
Relationship Sebbene sia possibile dedurre le relazioni dello schema utilizzando lo schema unione e Real-time Customer Profile, ciò vale solo per gli schemi che condividono la stessa classe. Il vincolo Relationship indica che questo campo fa riferimento all'identità primaria di uno schema basato su una classe diversa, implicando una relazione tra i due schemi. Per ulteriori informazioni, vedere l'esercitazione su definizione di una relazione.
NOTA

Tutti i campi obbligatori, di identità o di relazione sono visualizzati nella barra a sinistra, consentendo di individuare facilmente tali campi indipendentemente dalla complessità dello schema.

Per questa esercitazione, l’oggetto “loyalty” nello schema richiede un nuovo campo enum che descrive il “livello di fedeltà” di un cliente, dove il valore può essere solo una delle quattro opzioni possibili. Per aggiungere questo campo allo schema, selezionare l’icona plus (+) accanto all’oggetto loyalty e compilare i campi obbligatori per Field name e Display name. Per Type, seleziona “String”.

Dopo che è stato selezionato il tipo, vengono visualizzate ulteriori caselle di controllo per il campo, comprese le caselle di controllo per Array, Enum e Identity.

Selezionare la casella di controllo Enum per aprire la sezione Enum values sottostante. Qui è possibile inserire i valori Value (in camelCase) e Label (un nome facoltativo e intuitivo per il lettore in Title Case) per ogni livello di fedeltà accettabile.

Dopo aver completato tutte le proprietà del campo, selezionare Apply per aggiungere il campo "loyaltyLevel" all'oggetto loyalty.

Conversione di un oggetto multicampo in un tipo di dati

L'oggetto loyalty ora contiene diversi campi specifici per la fedeltà e rappresenta una struttura dati comune che potrebbe essere utile in altri schemi. Schema Editor consente di applicare facilmente oggetti multicampo riutilizzabili convertendo la struttura di tali oggetti in tipi di dati.

I tipi di dati consentono l'uso coerente di strutture con più campi e offrono maggiore flessibilità rispetto a un mixin, perché possono essere utilizzati ovunque all'interno di uno schema. A tal fine, è possibile impostare il valore Type del campo su quello di qualsiasi tipo di dati definito in Schema Registry.

Per convertire l'oggetto loyalty in un tipo di dati, selezionare il campo loyalty in Structure, quindi selezionare Convert to new data type a destra dell'editor in Field properties. Viene visualizzato un puntatore verde che conferma la corretta conversione dell’oggetto.

Ora, quando si guarda in Structure, è possibile vedere che il campo loyalty ha un tipo di dati "Loyalty" e i campi sono dotati di icone di blocco piccole, a indicare che non sono più campi singoli ma fanno parte di un tipo di dati multicampo.

In uno schema futuro, ora è possibile assegnare un campo come tipo "Loyalty" e includere automaticamente campi per ID, livello fedeltà, membro da e punti.

NOTA

È inoltre possibile creare e modificare tipi di dati personalizzati indipendentemente dalla modifica degli schemi. Per ulteriori informazioni, consultare la guida relativa alla creazione e modifica di tipi di dati.

Ricerca e filtro di campi dello schema

Lo schema ora contiene diversi mixin oltre ai campi forniti dalla relativa classe base. Quando lavorate con schemi più grandi, potete selezionare le caselle accanto ai nomi dei mixin nella barra a sinistra per filtrare i campi visualizzati solo in base a quelli forniti dai mixin questione.

Se si sta cercando un campo specifico nello schema, è possibile utilizzare la barra di ricerca anche per filtrare i campi visualizzati per nome, indipendentemente dal mixin cui sono forniti.

IMPORTANTE

La funzione di ricerca prende in considerazione tutti i filtri mixin selezionati quando vengono visualizzati i campi corrispondenti. Se una query di ricerca non visualizza i risultati previsti, potrebbe essere necessario verificare due volte che non state filtrando i mixin rilevanti.

Impostare un campo dello schema come campo di identità

La struttura di dati standard fornita dagli schemi può essere sfruttata per identificare i dati appartenenti allo stesso individuo tra più origini, consentendo l'utilizzo di diversi casi a valle, come segmentazione, reporting, analisi della scienza dei dati e altro ancora. Per unire i dati in base alle singole identità, i campi chiave devono essere contrassegnati come campi Identity all'interno degli schemi applicabili.

Experience Platform consente di identificare facilmente un campo identità mediante l'uso di una Identity casella di controllo nell' Schema Editor. Tuttavia, è necessario determinare quale campo è il candidato migliore per utilizzare come identità, in base alla natura dei dati.

Ad esempio, ci possono essere migliaia di membri del programma fedeltà appartenenti allo stesso "livello fedeltà", ma ogni membro del programma fedeltà ha un loyaltyId univoco (che in questo caso è l'indirizzo e-mail del singolo membro). Il fatto che loyaltyId sia un identificatore univoco per ciascun membro lo rende un valido candidato per un campo di identità, mentre loyaltyLevel non lo è.

IMPORTANTE

I passaggi descritti di seguito descrivono come aggiungere un descrittore di identità a un campo dello schema esistente. In alternativa alla definizione dei campi di identità all'interno della struttura dello schema stesso, è anche possibile utilizzare un campo identityMap per contenere le informazioni di identità.

Se si prevede di utilizzare identityMap, tenere presente che sostituirà l'identità primaria aggiunta direttamente allo schema. Per ulteriori informazioni, vedere la sezione relativa a identityMap nella guida di base alla composizione dello schema.

Nella sezione Structure dell'editor, selezionare il campo loyaltyId e la casella di controllo Identity viene visualizzata sotto Field properties. Selezionare la casella e l'opzione per impostare questo valore come Primary identity viene visualizzata. Selezionate anche questa casella.

NOTA

Ogni schema può contenere un solo campo identità principale. Una volta impostato un campo dello schema come identità principale, si riceverà un messaggio di errore se si tenta in seguito di impostare come principale un altro campo dell'identità nello schema.

Successivamente, è necessario fornire un Identity namespace dall'elenco degli spazi dei nomi predefiniti nel menu a discesa. Poiché loyaltyId è l'indirizzo e-mail del cliente, selezionate "Email" dal menu a discesa. Selezionare Apply per confermare gli aggiornamenti al campo loyaltyId.

NOTA

Per un elenco degli spazi dei nomi standard e delle relative definizioni, consultare la Identity Service documentazione.

Dopo aver applicato la modifica, l'icona relativa a loyaltyId mostra un simbolo di impronta digitale, a indicare che si tratta ora di un campo di identità.

Ora tutti i dati acquisiti nel campo loyaltyId verranno utilizzati per identificare l'individuo e unire una singola vista del cliente. Per ulteriori informazioni sull'utilizzo delle identità in Experience Platform, consultare la documentazione di Identity Service.

Abilitare lo schema da utilizzare in Real-time Customer Profile

Real-time Customer Profile sfrutta i dati di identità Experience Platform per fornire una visione olistica di ciascun cliente. Il servizio crea solidi profili a 360° degli attributi del cliente e conti con marca temporale di ogni interazione che i clienti hanno avuto in tutti i sistemi integrati con Experience Platform.

Affinché uno schema sia abilitato per l'uso con Real-time Customer Profile, è necessario che sia definita un'identità primaria. Se si tenta di abilitare uno schema senza prima definire un'identità primaria, verrà visualizzato un messaggio di errore.


Per attivare lo schema "Membri fedeltà" da utilizzare in Profile, iniziare selezionando "Loyalty Members" nella sezione Structure dell'editor.

Sul lato destro dell'editor, vengono visualizzate informazioni sullo schema, incluso il nome visualizzato, la descrizione e il tipo. Oltre a queste informazioni, è presente un Profile pulsante di attivazione/disattivazione.

Selezionare Profile e viene visualizzato un puntatore che richiede di confermare l'abilitazione dello schema per Profile.


AVVERTENZA

Una volta che uno schema è stato abilitato per Real-time Customer Profile e salvato, non può essere disabilitato.

Selezionare Enable per confermare la scelta. È possibile selezionare di nuovo l'interruttore Profile per disabilitare lo schema, se lo si desidera, ma una volta che lo schema è stato salvato mentre Profile è abilitato, non può più essere disabilitato.

Passaggi successivi e risorse aggiuntive

Dopo aver completato la composizione dello schema, è possibile visualizzare lo schema completo nell'area di lavoro. Selezionare Save e lo schema verrà salvato nella Schema Library, rendendolo accessibile dalla Schema Registry.

È ora possibile utilizzare il nuovo schema per assimilare i dati in Platform. Tenere presente che una volta che lo schema è stato utilizzato per acquisire i dati, è possibile apportare solo modifiche aggiuntive. Per ulteriori informazioni sul controllo delle versioni dello schema, vedere le nozioni di base della composizione dello schema.

È ora possibile seguire l'esercitazione su definizione di una relazione di schema nell'interfaccia utente per aggiungere un nuovo campo di relazione allo schema "Membri fedeltà".

Lo schema "Membri fedeltà" è disponibile anche per la visualizzazione e la gestione tramite l'API Schema Registry. Per iniziare a lavorare con l'API, leggete la Schema Registry API guida per gli sviluppatori.

Risorse video

AVVERTENZA

L'interfaccia Platform mostrata nei video seguenti non è aggiornata. Per informazioni sulle ultime funzionalità e videate dell’interfaccia, consulta la documentazione precedente.

Il video seguente mostra come creare uno schema semplice nell'interfaccia utente Platform.

Il seguente video è pensato per comprendere meglio come utilizzare mixin e classi.

Appendice

Le sezioni seguenti forniscono informazioni aggiuntive relative all'utilizzo di Schema Editor.

Creare una nuova classe

Experience Platform consente di definire uno schema basato su una classe univoca per l'organizzazione. Per informazioni su come creare una nuova classe, consultare la guida relativa alla creazione e modifica di classi nell'interfaccia utente.

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 informazioni su come modificare la classe di uno schema, vedere la guida sulla gestione degli schemi nell'interfaccia utente.

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