Creare e modificare i tipi di dati tramite l’interfaccia utente

Ultimo aggiornamento: 2023-12-14
  • Argomenti:
  • Schemas
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Developer
    User
    Admin
    Leader

In Experience Data Model (XDM), i tipi di dati sono campi riutilizzabili che contengono più sottocampi. Sebbene siano simili ai gruppi di campi dello schema in quanto consentono l’utilizzo coerente di una struttura a più campi, i tipi di dati sono più flessibili in quanto possono essere inclusi ovunque nella struttura dello schema, mentre i gruppi di campi possono essere aggiunti solo al livello principale.

Adobe Experience Platform fornisce molti tipi di dati standard che possono essere utilizzati per coprire un’ampia varietà di casi d’uso comuni di gestione delle esperienze. Tuttavia, puoi anche definire tipi di dati personalizzati per soddisfare esigenze aziendali specifiche.

NOTA

Se un campo è definito come tipo di dati specifico, non è possibile creare lo stesso campo con un tipo di dati diverso in un altro schema. Questo vincolo si applica a tutto il tenant dell’organizzazione.

Questo tutorial illustra i passaggi necessari per creare e modificare tipi di dati personalizzati nell’interfaccia utente di Platform.

Prerequisiti

Questa guida richiede una buona conoscenza del sistema XDM. Consulta la sezione Panoramica di XDM per un’introduzione al ruolo di XDM nell’ecosistema Experience Platform e nozioni di base sulla composizione dello schema come i tipi di dati contribuiscono agli schemi XDM.

Sebbene non sia necessario per questa guida, si consiglia di seguire l’esercitazione anche su composizione di uno schema nell’interfaccia utente per acquisire familiarità con le varie funzionalità del Schema Editor.

Apri Schema Editor per un tipo di dati

Nell’interfaccia utente di Platform, seleziona Schemi nel menu di navigazione a sinistra per aprire Schemi , quindi seleziona la Tipi di dati scheda. Viene visualizzato un elenco dei tipi di dati disponibili. L’elenco dei tipi di dati viene filtrato automaticamente in base alla modalità di creazione. L'impostazione predefinita visualizza i tipi di dati definiti da Adobe. Puoi anche filtrare l’elenco per visualizzare quelli creati dall’organizzazione.

Il Schemi workspace con Schemi nel menu di navigazione a sinistra e Tipi di dati evidenziato.

Da qui sono disponibili le seguenti opzioni:

Crea un nuovo tipo di dati

Dalla sezione Tipi di dati , seleziona Crea tipo di dati.

Il Schemi workspace Tipi di dati scheda con Crea tipo di dati evidenziato.

Il Schema Editor viene visualizzata la struttura corrente del nuovo tipo di dati nell'area di lavoro. Sul lato destro dell’editor, puoi fornire un nome visualizzato e una descrizione facoltativa per il tipo di dati. Assicurati di fornire un nome univoco e conciso per il tipo di dati, in quanto questo sarà il modo in cui verrà identificato quando lo aggiungi a uno schema.

Questo tutorial crea un tipo di dati che descrive una proprietà del ristorante, per cui al tipo di dati viene assegnato il nome visualizzato "Restaurant".

Da qui, puoi passare alla sezione sezione successiva per iniziare ad aggiungere campi al nuovo tipo di dati.

Filtrare i tipi di dati

L’elenco dei tipi di dati disponibili viene prefiltrato in base alla modalità di creazione. Seleziona il pulsante di opzione per scegliere tra Standard e Personalizzato opzioni. Il Standard mostra le entità create da Adobe e Personalizzato Questa opzione consente di visualizzare le entità create all’interno dell’organizzazione.

Il Tipi di dati scheda di Schemi workspace con Standard e Personalizzato evidenziato.

Modificare un tipo di dati esistente

NOTA

Una volta utilizzato un tipo di dati esistente in uno schema abilitato per l’utilizzo in Real-Time Customer Profile, è possibile apportare successivamente solo modifiche non distruttive a tale tipo di dati. Consulta la regole di evoluzione dello schema per ulteriori informazioni.

È possibile modificare solo i tipi di dati personalizzati definiti dall’organizzazione. Seleziona Personalizzato per mostrare solo i tipi di dati personalizzati di proprietà della tua organizzazione.

Seleziona dall’elenco il tipo di dati da modificare per aprire la barra a destra, con i dettagli del tipo di dati. Dal pannello dei dettagli puoi anche scaricare un file di esempio, copiare la struttura JSON o aggiungere il tipo di dati a un pacchetto.

Seleziona il nome del tipo di dati nella barra a destra per aprirne la struttura in Schema Editor.

Il Tipi di dati scheda di Schemi workspace, con un tipo di dati, Personalizzato e il tipo di dati Nome evidenziato.

Aggiungere campi al tipo di dati

Per iniziare ad aggiungere campi al tipo di dati, seleziona la più (+) accanto al campo a livello di radice nell’area di lavoro. Sotto viene visualizzato un nuovo campo e la barra a destra si aggiorna per visualizzare i controlli per il nuovo campo.

Utilizza i controlli nella barra a destra per configurare i dettagli del nuovo campo. Consulta la guida su definizione dei campi nell’interfaccia utente per passaggi specifici su come configurare e aggiungere il campo al tipo di dati.

Il tipo di dati Ristorante richiede un campo stringa per rappresentare il nome del ristorante. In quanto tale, il Nome campo è impostato come "name" e Tipo è impostato come "Stringa". Seleziona Applica per applicare le modifiche al campo.

Continua ad aggiungere altri campi al tipo di dati in base alle esigenze. Il tipo di dati Ristorante di esempio ora dispone di campi aggiuntivi per marchio, capacità di posti a sedere e spazio del pavimento.

Oltre ai campi di base, puoi anche nidificare tipi di dati aggiuntivi all’interno del tipo di dati personalizzato. Ad esempio, il tipo di dati Ristorante richiede un campo che rappresenti l’indirizzo fisico della proprietà. In questo scenario, puoi aggiungere un nuovo campo "address" a cui viene assegnato il tipo di dati standard "Indirizzo postale".

Questo dimostra quanto possano essere flessibili i tipi di dati in termini di descrizione dei dati: i tipi di dati possono utilizzare campi che sono anche tipi di dati, che a loro volta possono contenere ulteriori tipi di dati e così via. Questo consente di astrarre e riutilizzare pattern di dati comuni in tutti gli schemi XDM, semplificando la rappresentazione di strutture di dati complesse.

Dopo aver aggiunto i campi al tipo di dati, seleziona Salva per salvare le modifiche e aggiungere il tipo di dati al Schema Library.

Aggiungere il tipo di dati a uno schema

Dopo aver creato un tipo di dati, puoi iniziare a utilizzarlo negli schemi. Poiché gli schemi XDM sono composti da una classe e da zero o più gruppi di campi, i campi forniti da un tipo di dati non possono essere aggiunti direttamente a uno schema. Devono invece essere inclusi in una classe o in un gruppo di campi.

Per iniziare, segui i passaggi relativi a aggiunta di un campo a una classe o aggiunta di un campo a un gruppo di campi. In alternativa, è possibile iniziare aggiunta diretta di un campo a uno schema e scegliere la classe padre o il gruppo di campi. Quando scegli il Tipo per il nuovo campo, seleziona il nome del tipo di dati dal menu a discesa.

Convertire un oggetto multicampo in un tipo di dati

Quando si crea un campo di tipo oggetto con più sottocampi nel Schema Editor, è possibile convertire tale campo in un tipo di dati in modo da poter utilizzare la stessa struttura di campi in una classe o in un gruppo di campi diverso.

Per convertire un campo di tipo oggetto in un tipo di dati, selezionare il campo nell'area di lavoro. Prima di convertire il campo, assicurati che il Nome visualizzato è descrittivo dei dati che l’oggetto conterrà, in quanto diventerà il nome del tipo di dati. Quando sei pronto per convertire il campo, seleziona Converti in nuovo tipo di dati nella barra a destra.

Il quadro aggiorna il tipo di dati del campo da "Oggetto" al nuovo tipo di dati. Questa struttura può ora essere riutilizzata in altre classi e gruppi di campi selezionando questo tipo di dati dall' Tipo quando si definisce un nuovo campo.

Passaggi successivi

Questa guida illustra come creare e modificare i tipi di dati utilizzando l’interfaccia utente di Platform. Per ulteriori informazioni sulle funzionalità di Schemi Workspace, consulta la sezione Schemi panoramica di workspace.

Per scoprire come gestire i tipi di dati utilizzando Schema Registry API, consulta guida dell’endpoint "data types".

In questa pagina