Creare e modificare i tipi di dati tramite l’interfaccia utente ui-create-and-edit

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.

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

Prerequisiti prerequisites

Questa guida richiede una buona conoscenza del sistema XDM. Consulta la panoramica di XDM per un'introduzione al ruolo di XDM all'interno dell'ecosistema Experience Platform e le nozioni di base sulla composizione dello schema per informazioni sul modo in cui i tipi di dati contribuiscono agli schemi XDM.

Sebbene non sia necessario per questa guida, è consigliabile seguire l'esercitazione su composizione di uno schema nell'interfaccia utente per acquisire familiarità con le varie funzionalità di Schema Editor.

Apri Schema Editor per un tipo di dati data-type

Nell'interfaccia utente di Platform, seleziona Schemi nell'area di navigazione a sinistra per aprire l'area di lavoro Schemi, quindi seleziona la scheda Tipi di dati. 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.

Da qui sono disponibili le seguenti opzioni:

Crea un nuovo tipo di dati create

Dalla scheda Tipi di dati, selezionare Crea tipo di dati.

Viene visualizzato Schema Editor, che mostra 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 successiva per iniziare ad aggiungere campi al nuovo tipo di dati.

Filtrare i tipi di dati filter

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

Modificare un tipo di dati esistente edit

È 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.

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

Aggiungere campi al tipo di dati add-fields

Per iniziare ad aggiungere campi al tipo di dati, seleziona l’icona 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 i 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. Di conseguenza, il Nome campo è impostato come "name" e il 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 "Postal address".

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 a Schema Library.

Aggiungere il tipo di dati a uno schema add-data-type

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.

Iniziare seguendo i passaggi necessari per aggiungere un campo a una classe o aggiungere un campo a un gruppo di campi. In alternativa, è possibile avviare l'aggiunta di un campo direttamente a uno schema e scegliere la classe padre o il gruppo di campi da tale schema. 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 convert

Quando si crea un campo di tipo oggetto con più sottocampi in 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, verificare che il Nome visualizzato sia descrittivo dei dati che l'oggetto conterrà, in quanto diventerà il nome del tipo di dati. Quando sei pronto a convertire il campo, seleziona Converti in nuovo tipo di dati nella barra a destra.

L'area di lavoro aggiorna il tipo di dati del campo da "Oggetto" al nuovo tipo di dati. Questa struttura può essere riutilizzata in altre classi e gruppi di campi selezionando questo tipo di dati dal menu a discesa Tipo durante la definizione di un nuovo campo.

Passaggi successivi next-steps

Questa guida illustra come creare e modificare i tipi di dati utilizzando l’interfaccia utente di Platform. Per ulteriori informazioni sulle funzionalità dell'area di lavoro Schemi, vedere la panoramica dell'area di lavoro Schemi.

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