Creare e modificare gli schemi nell’interfaccia utente create-edit-schemas-in-ui

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

Prerequisiti prerequisites

Questa guida richiede una buona conoscenza del sistema XDM. Fare riferimento alla panoramica di XDM per un'introduzione al ruolo di XDM all'interno dell'ecosistema Experience Platform e alle nozioni di base sulla composizione dello schema per una panoramica di come vengono costruiti gli schemi.

Crea un nuovo schema create

Nell'area di lavoro Schemi, seleziona Crea schema nell'angolo in alto a destra.

Viene visualizzata la finestra di dialogo Crea uno schema . In questa finestra di dialogo, puoi scegliere di creare manualmente uno schema aggiungendo campi e gruppi di campi oppure caricare un file CSV e utilizzare algoritmi ML per generare uno schema. Seleziona un workflow per la creazione di uno schema dalla finestra di dialogo.

{type=Informative} Beta Creazione manuale o assistita da ML di schemi manual-or-assisted

Per informazioni su come usare un algoritmo ML per consigliare una struttura di schema basata su un file CSV, vedi la guida🔗 alla creazione di schemi assistita da Machine Learning. Questa guida dell’interfaccia utente si concentra sul flusso di lavoro di creazione manuale.

Creazione manuale dello schema manual-creation

Viene visualizzato il workflow dello schema Crea. Puoi scegliere una classe base per lo schema selezionando Profilo individuale, Evento esperienza o Altro, seguito da Successivo per confermare la scelta. Per ulteriori informazioni su queste classi, consulta il profilo individuale XDM e la documentazione di XDM ExperienceEvent .

Quando si sceglie Altro, viene visualizzato un elenco delle classi disponibili. Da qui è possibile sfogliare e filtrare le classi preesistenti.

Selezionare un pulsante radio per filtrare le classi a seconda che si tratti di classi personalizzate o standard. È inoltre possibile filtrare i risultati disponibili in base al relativo settore o ricerca per una classe specifica utilizzando il campo ricerca.

Per aiutarti a decidere la classe appropriata, ci sono icone di informazioni e anteprima per ogni classe. L'icona info ( ) apre una finestra di dialogo che fornisce una descrizione della classe e del settore a cui è associata.

L'icona di anteprima ( ) apre una finestra di dialogo di anteprima per la classe contenente un diagramma schema e le relative proprietà.

Seleziona una riga per scegliere una classe, quindi seleziona Successivo per confermare la scelta.

Dopo aver selezionato una classe, viene visualizzata la sezione Nome e revisione . In questa sezione vengono forniti un nome e una descrizione per identificare lo schema.La struttura di base dello schema (fornita dalla classe) viene visualizzata nell'area di lavoro per consentirti di rivedere e verificare la struttura della classe e dello schema selezionata.

Immettere un nome visualizzato Schema intuitivo nel campo di testo. Successivo, immetti una descrizione appropriata che aiuti a identificare lo schema. Dopo aver esaminato la struttura dello schema e aver soddisfatto le impostazioni, selezionare Fine per creare lo schema.

![La sezione Nome e revisione dello schema] Crea workflow con il nome visualizzato dello schema, l'Descrizione e la fine evidenziati.

Viene visualizzato l'Editor di schema, con la struttura dello schema visualizzata nell'area di disegno. Se lo si desidera, è ora possibile iniziare ad aggiungere campi alla classe.

Modifica uno schema esistente edit

Per modificare uno schema esistente, selezionare il scheda Sfoglia , quindi selezionare il nome dello schema che si desidera modificare. È inoltre possibile utilizzare la barra ricerca per restringere l'elenco delle opzioni disponibili.

Una volta selezionato uno schema, viene visualizzato Schema Editor con la struttura dello schema mostrata nell'area di disegno. È ora possibile aggiungere gruppi di campi allo schema (o aggiungere singoli campi da tali gruppi), modificare i nomi visualizzati dei campi o modificare i gruppi di campi personalizzati esistenti, se lo schema ne utilizza.

Altre azioni more

Nell’Editor di schema è inoltre possibile eseguire azioni rapide per copiare la struttura JSON dello schema o eliminare lo schema, se non è stato abilitato per Real-Time Customer Profile o se a esso sono associati set di dati. Seleziona Altro nella parte superiore della visualizzazione per visualizzare un elenco a discesa con azioni rapide.

La funzionalità di copia della struttura JSON consente di visualizzare l’aspetto di un payload di esempio durante la creazione dello schema e delle pipeline di dati. È particolarmente utile nelle situazioni in cui sono presenti strutture complesse di mappa oggetto nello schema, ad esempio una mappa di identità.

Attiva/Disattiva nome visualizzato display-name-toggle

Per comodità, l’Editor di schema fornisce un’opzione per passare dai nomi dei campi originali a quelli più leggibili dall’utente. Questa flessibilità consente di migliorare l'individuazione dei campi e la modifica degli schemi. L'interruttore si trova in alto a destra nella vista Editor schema.

I nomi visualizzati per i gruppi di campi standard sono generati dal sistema ma possono essere personalizzati, come descritto nella sezione Nomi🔗 visualizzati. I nomi visualizzati vengono riflessi in più viste interfaccia, incluse le mappe e le anteprime dei set di dati. L'impostazione predefinita è disattivata e i nomi dei campi vengono visualizzati in base ai valori originali.

Aggiungere gruppi di campi a uno schema add-field-groups

Dopo aver aperto uno schema all'interno di Schema Editor, è possibile aggiungere campi allo schema tramite l'utilizzo di gruppi di campi. Per iniziare, seleziona Aggiungi accanto a Gruppi di campi nella barra a sinistra.

![Nell'Editor schema è evidenziata la sezione Aggiungi dai gruppi] di campi.

Viene visualizzata una finestra di dialogo contenente un elenco di gruppi di campi che è possibile selezionare 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 popolarità di utilizzo all’interno dell’organizzazione.

Se conosci l’attività generale o l’area aziendale dei campi che desideri aggiungere, seleziona una o più categorie verticali di settore nella barra a sinistra per filtrare l’elenco visualizzato dei gruppi di campi.

È inoltre possibile utilizzare la barra dei ricerca per individuare il gruppo di campi desiderato. I gruppi di campi il cui nome corrisponde alla query vengono visualizzati in cima all'elenco. In 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. Dall’elenco puoi selezionare più gruppi di campi, ciascuno dei quali viene visualizzato nella barra a destra.

TIP

Per qualsiasi gruppo di campi elencato, è possibile passare il mouse o concentrarsi sull'icona delle informazioni ( delle informazioni) per visualizzare una breve descrizione del tipo di dati acquisiti dal gruppo di campi. È inoltre possibile selezionare l'icona di anteprima ( di anteprima) per visualizzare la struttura dei campi fornita dal gruppo di campi prima di decidere di aggiungerlo allo schema.

Dopo aver scelto i gruppi di campi, selezionare Aggiungi gruppi di campi per aggiungerli allo schema.

Viene Schema Editor rivisualizzato con i campi specificati dal gruppo di campi rappresentati nell'area di disegno.

NOTE

Nell'Editor schema, le classi e i gruppi di campi standard (generati da Adobe Systems) sono indicati con l'icona a forma . Il lucchetto viene visualizzato nel barra sinistro accanto al nome della classe o del gruppo di campi, nonché accanto a qualsiasi campo del diagramma dello schema che fa parte di una risorsa generata dal sistema.

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

Rimuovi campi aggiunti dai gruppi di campi remove-fields

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

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

Se si desidera rimuovere più campi, è possibile gestire il gruppo di campi nel suo complesso. Seleziona un campo appartenente al gruppo nell'area di disegno, quindi seleziona Gestisci campi correlati nel barra destro.

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 richiesti. Al termine, selezionare Conferma.

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

Aggiunta di campi personalizzati a gruppi di campi add-fields

Dopo aver aggiunto un gruppo di campi a uno schema, è possibile 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, tale gruppo di campi verrà convertito in un gruppo di campi personalizzato e il gruppo di campi standard originale non sarà più disponibile.

Se si desidera aggiungere un campo personalizzato a un gruppo di campi standard, fare riferimento alla sezione seguente per istruzioni specifiche. Se stai aggiungendo campi a un gruppo di campi personalizzato, consulta la sezione su modifica di gruppi di campi personalizzati nella guida dell'interfaccia utente dei gruppi di campi.

Se non si desidera modificare gruppi di campi esistenti, è possibile creare un nuovo gruppo di campi personalizzato per definire campi aggiuntivi.

Aggiunta di singoli campi a uno schema add-individual-fields

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 da gruppi di campi standard o aggiungere campi personalizzati.

Aggiungi campi standard add-standard-fields

Puoi aggiungere campi da gruppi di campi standard direttamente a uno schema, senza dover conoscere in anticipo il gruppo di campi corrispondente. Per aggiungere un campo standard a uno schema, selezionare l'icona più (+) accanto al nome dello schema nell'area di lavoro. Nella struttura dello schema viene visualizzato un segnaposto per Campo senza titolo e la barra a destra viene aggiornata per visualizzare i controlli per la configurazione del campo.

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

Sebbene alcuni campi standard condividano 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.

Selezionare l'icona di anteprima ( ) accanto a un campo standard per visualizzare la struttura del relativo gruppo di campi e capire meglio come potrebbe essere nidificato. Per aggiungere il campo standard allo schema, selezionare l'icona più ( ).

L’area di lavoro viene aggiornata per mostrare il campo standard aggiunto allo schema, inclusi eventuali campi principali nidificati all’interno della struttura del gruppo di campi. Il nome del gruppo di campi è anche elencato in Gruppi di campi nella barra a sinistra. Se desideri aggiungere altri campi dallo stesso gruppo di campi, seleziona Gestisci campi correlati nella barra a destra.

Aggiungere campi personalizzati add-custom-fields

Analogamente alla workflow per i campi standard, è anche possibile aggiungere campi personalizzati direttamente a uno schema.

Per aggiungere campi al livello principale di uno schema, seleziona l'icona più (+) accanto al nome dello schema nell'area di disegno. Nella struttura dello schema viene visualizzato un segnaposto per Campo senza titolo e la barra a destra viene aggiornata per visualizzare i controlli per la configurazione del campo.

Iniziare a digitare il nome del campo che si desidera aggiungere e il sistema avvia automaticamente la ricerca dei campi standard corrispondenti. Per creare un nuovo campo personalizzato, seleziona l'opzione superiore aggiunta con (Nuovo campo).

Dopo aver fornito un nome visualizzato e un tipo di dati per il campo, il passaggio successivo consiste nell'assegnare il campo a una risorsa XDM padre. Se lo schema utilizza una classe personalizzata, è possibile scegliere di aggiungere il campo alla classe assegnata o a un gruppo di campi. Se lo schema utilizza una classe standard, tuttavia, è possibile assegnare il campo personalizzato solo a un gruppo di campi.

Assegnare il campo a un gruppo di campi personalizzato add-to-field-group

In Assegna a, seleziona Gruppo di campi. Se lo schema utilizza una classe standard, questa è l'unica opzione disponibile ed è selezionata per impostazione predefinita.

Successivamente, è necessario selezionare un gruppo di campi al quale associare il nuovo campo. Inizia digitare il nome del gruppo di campi nell'input di testo fornito. Se esistono gruppi di campi personalizzati che corrispondono all'input, questi verranno visualizzati nell'elenco a discesa. In alternativa, è possibile digitare un nome univoco per creare un nuovo gruppo di campi.

Dopo aver selezionato il gruppo di campi dall'elenco, selezionare Applica.

Il nuovo campo viene aggiunto al canvas e viene assegnato uno spazio dei nomi all'ID🔗 tenant per evitare conflitti con i campi XDM standard. Il gruppo di campi a cui è stato associato il nuovo campo viene visualizzato anche in Gruppi di campi nella barra sinistra.

Assegna il campo a una classe personalizzata add-to-class

In Assegna a, selezionare Classe. Il campo di input sottostante viene sostituito con il nome della classe personalizzata dello schema corrente, indicando che il nuovo campo verrà assegnato a questa classe.

Continua configurando il campo come desiderato e selezionate Applica al termine.

Il nuovo campo viene aggiunto al canvas e viene assegnato uno spazio dei nomi all'ID🔗 tenant per evitare conflitti con i campi XDM standard. Selezionando il nome della classe nel barra sinistro si apre il nuovo campo come parte della struttura della classe.

Aggiungere campi personalizzati alla struttura dei gruppi di campi standard custom-fields-for-standard-groups

Se lo schema su cui stai lavorando dispone di un campo di tipo oggetto fornito da un gruppo di campi standard, puoi aggiungere campi personalizzati a tale oggetto standard.

WARNING

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, tale gruppo 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 di questa funzione, riceverai una finestra di dialogo che informa sui gruppi di campi standard che hai personalizzato in precedenza. Dopo aver selezionato Riconosci, le risorse elencate vengono convertite in gruppi di campi personalizzati.

Per iniziare, selezionare l'icona più (+) accanto alla directory principale dell'oggetto fornita dal gruppo di campi standard.

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

L'area di disegno viene rivisualizzata con un segnaposto senza titolo per il nuovo campo. Si noti che al nome del gruppo di campi standard è stato aggiunto "(Extended)" per indicare che è stato modificato dalla versione originale. Da qui, utilizzare i controlli nel barra destro per definire le proprietà del campo.

Dopo aver applicato le modifiche, il nuovo campo viene visualizzato sotto lo spazio dei nomi ID tenant all'interno dell'oggetto standard. Questo spazio dei nomi nidificato evita conflitti di nomi di campo all’interno del gruppo di campi stesso, al fine di evitare di interrompere le modifiche in altri schemi che utilizzano lo stesso gruppo di campi.

Abilitare uno schema per il profilo cliente in tempo reale profile

Il profilo cliente in tempo reale unisce 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 per l'utilizzo in Profile.

Per abilitare lo schema, inizia selezionando il nome dello schema nella barra sinistra, quindi seleziona l'interruttore Profilo in barra destra.

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

L'area di lavoro viene nuovamente visualizzata con l'opzione Profilo abilitata.

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

Lo schema è ora abilitato per l'utilizzo in Real-Time Customer Profile. Quando Experience Platform inserisce dati in set di dati basati su questo schema, tali dati verranno incorporati nei dati del profilo amalgamati.

Modifica dei nomi visualizzati per i campi schema display-names

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

Modificare i nomi dei campi con i nomi visualizzati attivando Mostra nomi visualizzati per i campi. Per modificare il nome visualizzato di un campo schema, selezionare il campo nell'area di disegno. Nel barra a destra, immetti il nuovo nome in Nome visualizzato.

Seleziona Applica nel barra a destra e l'area di disegno si aggiorna per mostrare il nuovo nome visualizzato del campo. Selezionare Salva per applicare le modifiche allo schema.

Modificare la classe di uno schema change-class

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

Per riassegnare una classe, seleziona Assegna nella parte sinistra dell'area di disegno.

Viene visualizzata una finestra di dialogo in cui viene visualizzato un elenco di tutte le classi disponibili, incluse quelle definite dall'organizzazione (la proprietario è "Cliente") e le classi standard definite dall Adobe Systems.

Selezionare una classe dall'elenco per visualizzarne la descrizione sul lato destro della finestra di dialogo. È inoltre possibile selezionare Anteprima struttura di classe 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 il cambio di classe, la tela verrà ripristinata e tutti i progressi della composizione andranno persi.

Passaggi successivi next-steps

Questo documento ha trattato le nozioni di base per la creazione e la modifica di schemi nel interfaccia Experience Platform. Si consiglia vivamente di esaminare la esercitazione🔗 di creazione dello schema per ottenere una workflow completa per la creazione di uno schema completo nel interfaccia, inclusa la creazione di gruppi di campi e tipi di dati personalizzati per casi di utilizzo specifici.

Per ulteriori informazioni sulle funzionalità dell'area di lavoro Schemi, vedere Cenni preliminari🔗 sull'area di lavoro Schemi.

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