Creare e modificare schemi nell’interfaccia utente

Questa guida fornisce una panoramica su come creare, modificare e gestire gli schemi 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 come la personalizzazione di classi, gruppi di campi dello schema, tipi di dati e campi.

Per una panoramica completa del processo di creazione dello schema, segui insieme alla esercitazione sulla creazione dello schema per creare uno schema di esempio completo e acquisire familiarità con le numerose funzionalità di Schema Editor.

Prerequisiti

Questa guida richiede una buona comprensione del sistema XDM. Fai riferimento a Panoramica di XDM introduzione al ruolo di XDM nell'ecosistema Experience Platform e nozioni di base sulla composizione dello schema per una panoramica della creazione degli schemi.

Creare un nuovo schema

In Schemi area di lavoro, seleziona Creare uno schema nell'angolo in alto a destra. Nel menu a discesa visualizzato, puoi scegliere tra Profilo individuale XDM e ExperienceEvent XDM come classe base per lo schema. In alternativa, è possibile selezionare Sfoglia per selezionare dall’elenco completo delle classi disponibili, oppure creare una nuova classe personalizzata invece.

Dopo aver selezionato una classe, la Schema Editor e la struttura di base dello schema (fornita dalla classe) viene visualizzata nell'area di lavoro. Da qui, puoi utilizzare la barra a destra per aggiungere un Nome visualizzato e Descrizione per lo schema.

Ora puoi iniziare a creare la struttura dello schema tramite aggiunta di gruppi di campi schema.

Modificare uno schema esistente

NOTA

Una volta salvato e utilizzato lo schema nell’inserimento dei dati, è possibile apportare solo modifiche aggiuntive. Consulta la sezione regole di evoluzione dello schema per ulteriori informazioni.

Per modificare uno schema esistente, seleziona Sfoglia quindi selezionare il nome dello schema da modificare.

SUGGERIMENTO

È possibile utilizzare le funzionalità di ricerca e filtro dell'area di lavoro per facilitare lo schema. Consulta la guida su esplorazione delle risorse XDM per ulteriori informazioni.

Una volta selezionato uno schema, la Schema Editor viene visualizzata con la struttura dello schema mostrata nell'area di lavoro. Ora puoi aggiungere gruppi di campi allo schema (o aggiungere campi singoli da tali gruppi), modificare i nomi visualizzati dei campioppure modifica gruppi di campi personalizzati esistenti se lo schema ne utilizza uno.

Aggiunta di gruppi di campi a uno schema

NOTA

Questa sezione illustra come aggiungere gruppi di campi esistenti a uno schema. Per creare un nuovo gruppo di campi personalizzato, consulta la guida creazione e modifica di gruppi di campi invece.

Una volta aperto uno schema all'interno di Schema Editor, è possibile aggiungere campi allo schema utilizzando gruppi di campi. Per iniziare, seleziona Aggiungi accanto a Gruppi di campi nella barra a sinistra.

Viene visualizzata una finestra di dialogo in cui viene visualizzato un elenco di gruppi di campi selezionabili per lo schema. Poiché i gruppi di campi sono compatibili solo con una classe, verranno elencati solo i gruppi di campi associati alla classe selezionata dello schema. Per impostazione predefinita, i gruppi di campi elencati sono ordinati in base alla loro popolarità d’uso all’interno dell’organizzazione.

Se si conosce l’attività o l’area business generale dei campi che si desidera aggiungere, selezionare una o più categorie settore-verticale nella barra a sinistra per filtrare l’elenco visualizzato dei gruppi di campi.

NOTA

Per ulteriori informazioni sulle best practice per la modellazione di dati specifici per il settore in XDM, consulta la documentazione su modelli di dati del settore.

Puoi anche utilizzare la barra di ricerca per individuare il gruppo di campi desiderato. I gruppi di campi il cui nome corrisponde alla query vengono visualizzati nella parte superiore dell’elenco. Sotto Campi standard, vengono visualizzati i gruppi di campi contenenti i campi che descrivono gli attributi di dati desiderati.

Selezionare la casella di controllo accanto al nome del gruppo di campi che si desidera aggiungere allo schema. È possibile selezionare più gruppi di campi dall’elenco, ciascuno dei quali è visualizzato nella barra a destra.

SUGGERIMENTO

Per qualsiasi gruppo di campi elencato, puoi passare il cursore sull’icona delle informazioni () per visualizzare una breve descrizione del tipo di dati acquisiti dal gruppo di campi. Puoi anche selezionare l’icona di anteprima () per visualizzare la struttura dei campi forniti dal gruppo di campi prima di decidere di aggiungerlo allo schema.

Dopo aver selezionato i gruppi di campi, seleziona Aggiungi gruppi di campi per aggiungerli allo schema.

La Schema Editor viene visualizzata nuovamente con i campi forniti dal gruppo di campi rappresentati nell’area di lavoro.

Dopo aver aggiunto un gruppo di campi a uno schema, puoi facoltativamente rimuovere i campi esistenti o aggiungi nuovi campi personalizzati a tali gruppi, a seconda delle tue esigenze.

Rimuovi campi aggiunti dai gruppi di campi

Dopo aver aggiunto un gruppo di campi a uno schema, è possibile rimuovere tutti i campi non necessari.

NOTA

La rimozione dei campi da un gruppo di campi influisce solo sullo schema su cui si lavora e non influisce sul gruppo di campi stesso. Se rimuovi i campi in uno schema, tali campi sono ancora disponibili in tutti gli altri schemi che utilizzano lo stesso gruppo di campi.

Nell’esempio seguente, il gruppo di campi standard Dettagli demografici è stato aggiunto a uno schema. Per rimuovere un singolo campo, ad esempio taxId, seleziona il campo nell’area di lavoro, quindi seleziona Rimuovi nella barra a destra.

Rimuovi campo singolo

Se si desidera rimuovere più campi, è possibile gestire il gruppo di campi nel suo complesso. Seleziona un campo appartenente al gruppo nell’area di lavoro, quindi seleziona Gestire i campi correlati nella barra a destra.

Gestire i campi correlati

Viene visualizzata una finestra di dialogo che mostra la struttura del gruppo di campi in questione. Da qui è possibile utilizzare le caselle di controllo fornite per selezionare o deselezionare i campi necessari. Quando sei soddisfatto, seleziona Conferma.

Seleziona campi dal gruppo di campi

L'area di lavoro viene visualizzata nuovamente con solo i campi selezionati presenti nella struttura dello schema.

Campi aggiunti

Aggiungi campi personalizzati ai gruppi di campi

Dopo aver aggiunto un gruppo di campi a uno schema, puoi definire campi aggiuntivi per tale gruppo. Tuttavia, tutti i campi aggiunti a un gruppo di campi in uno schema verranno visualizzati anche in tutti gli altri schemi che utilizzano lo stesso gruppo di campi.

Inoltre, se un campo personalizzato viene aggiunto a un gruppo di campi standard, questo verrà convertito in un gruppo di campi personalizzato e il gruppo di campi standard originale non sarà più disponibile.

Se desideri aggiungere un campo personalizzato a un gruppo di campi standard, consulta sezione sottostante per istruzioni specifiche. Se si aggiungono campi a un gruppo di campi personalizzato, fare riferimento alla sezione modifica di gruppi di campi personalizzati nella guida dell’interfaccia utente dei gruppi di campi.

Se non desideri modificare gruppi di campi esistenti, puoi creare un nuovo gruppo di campi personalizzato per definire campi aggiuntivi.

Aggiunta di singoli campi a uno schema

L’Editor schema consente di aggiungere singoli campi direttamente a uno schema, se si desidera evitare di aggiungere un intero gruppo di campi per un caso d’uso specifico. È possibile aggiungere singoli campi dai gruppi di campi standard o aggiungere campi personalizzati invece.

IMPORTANTE

Anche se l’Editor di schema consente di aggiungere i singoli campi direttamente a uno schema, questo non cambia il fatto che tutti i campi di uno schema XDM devono essere forniti dalla relativa classe o da un gruppo di campi compatibile con tale classe. Come spiegato nelle sezioni seguenti, tutti i singoli campi sono ancora associati a un gruppo di campi come passaggio chiave quando vengono aggiunti a uno schema.

Aggiungi campi standard

È possibile aggiungere campi dai gruppi di campi standard direttamente a uno schema senza dover prima conoscere il gruppo di campi corrispondente. Per aggiungere un campo standard a uno schema, seleziona il segno più (+) accanto al nome dello schema nell’area di lavoro. Un Campo senza titolo il segnaposto viene visualizzato nella struttura dello schema e nella barra a destra viene aggiornato per visualizzare i controlli per configurare il campo.

Segnaposto campo

Sotto Nome campo, inizia a digitare il nome del campo da aggiungere. Il sistema cerca automaticamente i campi standard corrispondenti alla query e li elenca in Campi standard consigliati, compresi i gruppi di campi a cui appartengono.

Campi standard consigliati

Anche se alcuni campi standard condividono lo stesso nome, la loro struttura può variare a seconda del gruppo di campi da cui provengono. Se un campo standard è nidificato all’interno di un oggetto principale nella struttura del gruppo di campi, anche il campo principale verrà incluso nello schema se viene aggiunto il campo figlio.

Seleziona l’icona di anteprima (Icona Anteprima) accanto a un campo standard per visualizzare la struttura del relativo gruppo di campi e comprendere meglio come potrebbe essere nidificato. Per aggiungere il campo standard allo schema, seleziona l’icona più (Icona Plus).

Aggiungi campo standard

L’area di lavoro viene aggiornata per mostrare il campo standard aggiunto allo schema, compresi tutti i campi principali nidificati all’interno della struttura del gruppo di campi. Il nome del gruppo di campi è inoltre elencato in Gruppi di campi nella barra a sinistra. Se si desidera aggiungere altri campi dallo stesso gruppo di campi, selezionare Gestire i campi correlati nella barra a destra.

Campo standard aggiunto

Aggiungere campi personalizzati

Analogamente al flusso di lavoro per i campi standard, puoi anche aggiungere campi personalizzati direttamente a uno schema.

Per aggiungere campi al livello principale di uno schema, seleziona il segno più (+) accanto al nome dello schema nell’area di lavoro. Un Campo senza titolo il segnaposto viene visualizzato nella struttura dello schema e nella barra a destra viene aggiornato per visualizzare i controlli per configurare il campo.

Campo personalizzato radice

Inizia a digitare il nome del campo che desideri aggiungere e il sistema inizia automaticamente a cercare i campi standard corrispondenti. Per creare un nuovo campo personalizzato, seleziona l’opzione superiore con aggiunta di (Nuovo campo).

Nuovo campo

Da qui, fornisci un nome visualizzato e un tipo di dati per il campo. Sotto Assegna gruppo di campi, è necessario selezionare un gruppo di campi a cui associare il nuovo campo. Inizia a digitare il nome del gruppo di campi e se in precedenza gruppi di campi personalizzati creati verranno visualizzati nell’elenco a discesa. In alternativa, è possibile digitare un nome univoco nel campo per creare un nuovo gruppo di campi.

Seleziona gruppo di campi

AVVERTENZA

Se selezioni un gruppo di campi personalizzato esistente, anche gli altri schemi che utilizzano quel gruppo di campi erediteranno il campo appena aggiunto dopo il salvataggio delle modifiche. Per questo motivo, selezionare un gruppo di campi esistente solo se si desidera questo tipo di propagazione. In caso contrario, dovresti scegliere di creare un nuovo gruppo di campi personalizzato.

Al termine, seleziona Applica.

Campo Applica

Il nuovo campo viene aggiunto all’area di lavoro e viene aggiunto con un namespace sotto la ID tenant per evitare conflitti con i campi XDM standard. In viene visualizzato anche il gruppo di campi a cui è stato associato il nuovo campo. Gruppi di campi nella barra a sinistra.

ID tenant

NOTA

Gli altri campi forniti dal gruppo di campi personalizzati selezionato vengono rimossi dallo schema per impostazione predefinita. Se si desidera aggiungere alcuni di questi campi allo schema, selezionare un campo appartenente al gruppo, quindi selezionare Gestire i campi correlati nella barra a destra.

Aggiungere campi personalizzati alla struttura dei gruppi di campi standard

Se lo schema su cui si sta lavorando dispone di un campo di tipo oggetto fornito da un gruppo di campi standard, è possibile aggiungere campi personalizzati a tale oggetto standard.

AVVERTENZA

Tutti i campi aggiunti a un gruppo di campi in uno schema verranno visualizzati anche in tutti gli altri schemi che utilizzano lo stesso gruppo di campi. Inoltre, se un campo personalizzato viene aggiunto a un gruppo di campi standard, questo verrà convertito in un gruppo di campi personalizzato e il gruppo di campi standard originale non sarà più disponibile.

Se hai partecipato alla versione beta per questa funzione, riceverai una finestra di dialogo che ti informa sui gruppi di campi standard che hai precedentemente personalizzato. Dopo aver selezionato Riconoscere, le risorse elencate vengono convertite in gruppi di campi personalizzati.

Finestra di dialogo di conferma per convertire i gruppi di campi standard

Per iniziare, seleziona il segno più (+) accanto alla radice dell’oggetto fornito dal gruppo di campi standard.

Aggiungi campo all’oggetto standard

Viene visualizzato un messaggio di avviso che richiede di confermare se si desidera convertire il gruppo di campi standard. Seleziona Continua a creare un gruppo di campi per procedere.

Conferma conversione gruppo di campi

L’area di lavoro viene visualizzata nuovamente con un segnaposto senza titolo per il nuovo campo. Si noti che al nome del gruppo di campi standard è stato aggiunto "(Esteso)" per indicare che è stato modificato dalla versione originale. Da qui, utilizza i controlli nella barra a destra per definire le proprietà del campo.

Campo aggiunto all’oggetto standard

Dopo aver applicato le modifiche, il nuovo campo viene visualizzato nello spazio dei nomi dell’ID tenant all’interno dell’oggetto standard. Questo spazio dei nomi nidificato evita conflitti tra nomi di campo all’interno del gruppo di campi stesso per evitare l’interruzione delle modifiche in altri schemi che utilizzano lo stesso gruppo di campi.

Campo aggiunto all’oggetto standard

Abilitare uno schema per il profilo cliente in tempo reale

Profilo cliente in tempo reale unisce i dati provenienti 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 da utilizzare in Profile.

IMPORTANTE

Per abilitare uno schema per Profile, deve avere un campo di identità principale definito. Consulta la guida su definizione dei campi di identità per ulteriori informazioni.

Per abilitare lo schema, inizia selezionando il nome dello schema nella barra a sinistra, quindi seleziona la Profilo attiva la barra a destra.

Viene visualizzato un puntatore che avvisa che, una volta abilitato e salvato uno schema, non può essere disabilitato. Seleziona Abilita per continuare.

L'area di lavoro viene visualizzata nuovamente con la Profilo attiva/disattiva.

IMPORTANTE

Poiché lo schema non è ancora stato salvato, questo è il punto di non ritorno se cambi idea di consentire allo schema di partecipare al Profilo cliente in tempo reale: una volta salvato uno schema abilitato, non è più possibile disattivarlo. Seleziona la Profilo per disattivare lo schema, seleziona di nuovo l’opzione .

Per completare il processo, seleziona Salva per salvare lo schema.

Lo schema è ora abilitato per l’utilizzo in Profilo cliente in tempo reale. Quando Platform acquisisce dati in set di dati basati su questo schema, questi verranno incorporati nei dati del profilo amalgamato.

Modifica dei nomi visualizzati per i campi dello schema

Dopo aver assegnato una classe e aggiunto gruppi di campi 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 gruppi di campi 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 influisce sugli altri schemi che utilizzano la stessa classe o gruppo di campi associati.

Una volta apportate le modifiche ai nomi visualizzati dei campi di uno schema, tali modifiche vengono immediatamente applicate a tutti i set di dati esistenti in base a tale schema.

Per modificare il nome visualizzato di un campo schema, selezionare il campo nell’area di lavoro. Nella barra a destra, inserisci il nuovo nome in Nome visualizzato.

Seleziona Applica nella barra a destra e l’area di lavoro viene aggiornata per mostrare il nuovo nome visualizzato del campo. Seleziona Salva per applicare le modifiche allo schema.

Modificare la classe di uno schema

È possibile modificare la classe di uno schema in qualsiasi punto durante il 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 gruppi di campi sono compatibili solo con determinate classi e pertanto la modifica della classe reimposterà l’area di lavoro e gli eventuali campi aggiunti.

Per riassegnare una classe, selezionare Assegna sul lato sinistro del quadro.

Viene visualizzata una finestra di dialogo in cui viene visualizzato l’elenco di tutte le classi disponibili, incluse quelle definite dall’organizzazione (il proprietario è "Cliente") nonché le classi standard definite dall'Adobe.

Selezionare una classe dall’elenco per visualizzarne la descrizione sul lato destro della finestra di dialogo. Puoi anche selezionare Struttura della classe di anteprima per visualizzare i campi e i metadati associati alla classe. Seleziona Assegna classe per continuare.

Viene visualizzata una nuova finestra di dialogo in cui viene richiesto di confermare l’assegnazione di una nuova classe. Seleziona Assegna per confermare.

Dopo aver confermato la modifica della classe, l'area di lavoro verrà reimpostata e tutti i progressi della composizione andranno persi.

Passaggi successivi

Questo documento illustra le nozioni di base per la creazione e la modifica degli schemi nell’interfaccia utente di Platform. Si consiglia vivamente di rivedere il esercitazione sulla creazione dello schema per un flusso di lavoro completo per la creazione di uno schema completo nell’interfaccia utente, inclusa la creazione di gruppi di campi personalizzati e tipi di dati per casi d’uso univoci.

Per ulteriori informazioni sulle funzionalità del Schemi area di lavoro, vedi Schemi panoramica dell'area di lavoro.

Per scoprire come gestire gli schemi nella Schema Registry API, vedi guida all’endpoint degli schemi.

In questa pagina