Creazione e modifica di tipi di dati tramite l'interfaccia utente

In Experience Data Model (XDM), i tipi di dati vengono utilizzati come campi di tipo riferimento nelle classi o nei mixin allo stesso modo dei campi letterali di base, con la differenza chiave che i tipi di dati possono definire più sottocampi. Anche se simili ai mixin in quanto consentono l'uso coerente di una struttura multi-campo, i tipi di dati sono più flessibili perché possono essere inclusi ovunque nella struttura dello schema, mentre i mixin possono essere aggiunti solo a livello principale.

Adobe Experience Platform fornisce molti tipi di dati standard che possono essere utilizzati per coprire un'ampia gamma di casi d'uso comuni per la gestione dell'esperienza. Tuttavia, puoi anche definire tipi di dati personalizzati per soddisfare esigenze aziendali specifiche.

Questa esercitazione descrive i passaggi per la creazione e la modifica di tipi di dati personalizzati nell'interfaccia utente della piattaforma.

Prerequisiti

Questa guida richiede una buona conoscenza del sistema XDM. Per un'introduzione al ruolo di XDM nell'ecosistema Experience Platform, fare riferimento alla panoramica XDM e alle nozioni di base della composizione dello schema per sapere in che modo i tipi di dati contribuiscono agli schemi XDM.

Sebbene non sia richiesto per questa guida, si consiglia anche di seguire l'esercitazione su composizione di uno schema nell'interfaccia utente per acquisire dimestichezza con le diverse funzionalità di Schema Editor.

Aprire la Schema Editor per un tipo di dati

Nell'interfaccia utente della piattaforma, selezionare Schemas nel menu di navigazione a sinistra per aprire l'area di lavoro Schemas, quindi selezionare la scheda Data types. Viene visualizzato un elenco dei tipi di dati disponibili, inclusi quelli definiti dal Adobe e quelli creati dall'organizzazione.

Da qui sono disponibili due opzioni:

Creare un nuovo tipo di dati

Dalla scheda Data types, selezionare Create data type.

Viene visualizzata la Schema Editor che mostra la struttura corrente del nuovo tipo di dati nel quadro. Sul lato destro dell'editor, è possibile fornire un nome visualizzato e una descrizione facoltativa per il tipo di dati. Assicurarsi di fornire un nome univoco e conciso per il tipo di dati, così come sarà identificato quando lo si aggiunge a uno schema.

Questa esercitazione crea un tipo di dati che descrive una proprietà ristorante, quindi al tipo di dati viene assegnato il nome visualizzato "Restaurant".

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

Modificare un tipo di dati esistente

È possibile modificare solo i tipi di dati personalizzati definiti dall'organizzazione. Per restringere l'elenco visualizzato, selezionate l'icona del filtro (Icona filtro) per visualizzare i controlli per il filtraggio in base a Owner. Selezionare Customer per mostrare solo i tipi di dati personalizzati di proprietà dell'organizzazione.

Selezionare il tipo di dati che si desidera modificare dall'elenco per aprire la barra laterale destra, mostrando i dettagli del tipo di dati. Selezionare il nome del tipo di dati nella barra a destra per aprirne la struttura in Schema Editor.

Aggiungere campi al tipo di dati

Per iniziare ad aggiungere campi al tipo di dati, selezionare l'icona più (+) accanto al campo di livello principale nell'area di lavoro. Di seguito viene visualizzato un nuovo campo e la barra laterale destra si aggiorna per visualizzare i controlli per il nuovo campo.

Utilizzate i controlli nella barra a destra per configurare i dettagli del nuovo campo. Per istruzioni su come configurare e aggiungere il campo al tipo di dati, vedere la guida relativa alla definizione dei campi nell'interfaccia utente.

Il tipo di dati Ristorante richiede un campo stringa che rappresenti il nome del ristorante. Di conseguenza, Field name è impostato come "name" e Type come "String". Selezionare Apply per applicare le modifiche al campo.

Continua ad aggiungere altri campi al tipo di dati, se necessario. L'esempio tipo di dati Ristorante dispone ora di campi aggiuntivi per marchio, capacità di posti a sedere e spazio pavimento.

Oltre ai campi di base, è anche possibile nidificare altri tipi di dati 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, è possibile aggiungere un nuovo campo "indirizzo" a cui è assegnato il tipo di dati standard "Postal address".

Questo dimostra come i tipi di dati flessibili possono essere flessibili 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, selezionare Save per salvare le modifiche e aggiungere il tipo di dati al Schema Library.

Aggiungere il tipo di dati a una classe o a un mixin

Dopo aver creato un tipo di dati, è possibile iniziare a utilizzarlo negli schemi. Poiché gli schemi XDM sono composti da una classe e da zero o più mixin, 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 mixin.

Per iniziare, seguire i passaggi relativi all'aggiunta di un campo a una classe](./classes.md#add-fields) o aggiunta di un campo a un mixin. [ Quando si sceglie Type per il nuovo campo, selezionare il nome del tipo di dati dal menu a discesa.

Conversione di un oggetto multicampo in un tipo di dati

Quando si crea un campo di tipo oggetto con più campi secondari in Schema Editor, è possibile convertire tale campo in un tipo di dati in modo da poter utilizzare la stessa struttura di campo in una classe o in un mixin 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, assicurarsi che la Display name sia descrittiva dei dati che l'oggetto conterrà, in quanto questo diventerà il nome del tipo di dati. Quando si è pronti per convertire il campo, selezionare Convert to new data type nella barra a destra.

Il quadro aggiorna il tipo di dati del campo da "Object" al nuovo tipo di dati. Accanto ai sottocampi sono inoltre presenti delle icone di blocco piccole, che indicano che non si tratta più di singoli campi ma piuttosto di un tipo di dati multicampo. È ora possibile riutilizzare questa struttura in altre classi e mixin selezionando questo tipo di dati dal menu a discesa Type quando si definisce un nuovo campo.

Passaggi successivi

Questa guida ha illustrato come creare e modificare i tipi di dati utilizzando l'interfaccia utente della piattaforma. Per ulteriori informazioni sulle funzionalità dell'area di lavoro Schemas, vedere la panoramica dell'area di lavoro Schemas.

Per informazioni su come gestire i tipi di dati utilizzando l'API Schema Registry, consultare la guida endpoint dei tipi di dati.

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