Creare e modificare le classi nell’interfaccia utente ui-create-and-edit

In Adobe Experience Platform, la classe di uno schema definisce gli aspetti comportamentali dei dati che lo schema conterrà (record o serie temporali). Inoltre, le classi descrivono il minor numero di proprietà comuni che tutti gli schemi basati su tale classe dovrebbero includere e forniscono un modo per unire più set di dati compatibili.

Adobe fornisce diverse classi standard ("core") Experience Data Model (XDM), tra cui XDM Individual Profile e XDM ExperienceEvent. Oltre a queste classi principali, puoi anche creare classi personalizzate per descrivere casi d’uso più specifici per la tua organizzazione.

Questo documento fornisce una panoramica su come creare, modificare e gestire le classi personalizzate nell’interfaccia utente di Experience Platform.

Prerequisiti prerequisites

Questa guida richiede una buona conoscenza del sistema XDM. Per un'introduzione al ruolo di XDM nell'ecosistema Experience Platform e alle nozioni di base sulla composizione dello schema, consulta la panoramica di XDM per scoprire come le classi contribuiscono agli schemi XDM.

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

Introduzione getting-started

Nell'interfaccia utente di Experience Platform, seleziona Schemas nel menu di navigazione a sinistra per aprire l'area di lavoro Schemas, quindi seleziona la scheda Classes. Viene visualizzato un elenco delle classi disponibili.

Filtra classi filter

L’elenco delle classi viene filtrato automaticamente in base alla modalità di creazione. L’impostazione predefinita visualizza le classi definite da Adobe. Puoi anche filtrare l’elenco per visualizzare quelli creati dall’organizzazione. Selezionare il pulsante di opzione per scegliere tra le opzioni Standard e Custom. L'opzione Standard mostra le entità create da Adobe e l'opzione Custom mostra le entità create all'interno dell'organizzazione.

Crea una nuova classe create

Esistono due metodi per creare una classe nell'interfaccia utente di Experience Platform, tramite Create class o Create schema.

Crea classe

Selezionare Create class dalla scheda Classes nell'area di lavoro Schemas.

Viene visualizzata la finestra di dialogo Create class. Immettere Display name e Description per la classe e scegliere il comportamento desiderato della classe con i pulsanti di scelta. Le classi possono essere di tipo Record o Time-series. Seleziona Create per confermare le scelte e tornare alla scheda Classes.

La classe creata è disponibile ed elencata nella visualizzazione Classes.

Crea schema

In alternativa, puoi creare una classe creando manualmente uno schema. Selezionare Create schema dalla scheda Classes nell'area di lavoro Schemas.

Selezionare Manual nella finestra di dialogo Create a schema visualizzata.

Viene visualizzato il flusso di lavoro per la creazione dello schema. Nella sezione Schema details, selezionare Other. Viene visualizzato un elenco delle classi disponibili. Seleziona Create class.

Viene visualizzata la finestra di dialogo Create class. Immettere Display name e Description per la classe e scegliere il comportamento desiderato della classe con i pulsanti di scelta. Le classi possono essere di tipo Record o Time-series. Seleziona Create per confermare le scelte e tornare alla scheda Classes.

L'elenco delle classi viene aggiornato nella sezione Schema details e la nuova classe creata viene selezionata automaticamente. Seleziona Next per continuare a creare lo schema.

Dopo aver selezionato una classe, viene visualizzata la sezione Name and review. In questa sezione, fornisci 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 rivedere e verificare la struttura di classe e schema selezionata.

Immetti un Schema display name descrittivo nel campo di testo. Quindi, inserisci una descrizione adatta per identificare lo schema. Dopo aver rivisto la struttura dello schema e aver impostato correttamente le impostazioni, selezionare Finish per creare lo schema.

Aggiungere campi a una classe add-fields

Dopo aver aperto uno schema che utilizza una classe personalizzata nell’Editor schema, puoi iniziare ad aggiungere campi alla classe. Per aggiungere un nuovo campo, seleziona l'icona più (+) accanto al nome dello schema.

Nell'area di lavoro viene visualizzato un segnaposto Untitled Field e la barra a destra si aggiorna per mostrare i controlli per configurare le proprietà del campo. In Assign to, selezionare Class.

Consulta la guida su definizione dei campi nell'interfaccia utente per i passaggi specifici su come configurare e aggiungere il campo alla classe. Continua ad aggiungere alla classe tutti i campi necessari. Al termine, selezionare Save per salvare sia lo schema che la classe.

Se in precedenza sono stati creati schemi che utilizzano questa classe, i campi appena aggiunti verranno visualizzati automaticamente in tali schemi.

Modificare una classe edit-a-class

È possibile modificare una classe tramite il flusso di lavoro dello schema modificando uno schema esistente che estende la classe o creando manualmente uno schema. Non è possibile modificare direttamente una classe. Dalla scheda Browse nell'area di lavoro Schemas, selezionare una classe esistente o Create a schema.

Se scegli di creare un nuovo schema, consulta la sezione sulla creazione di uno schema per i dettagli. Al termine della creazione dello schema o dopo aver selezionato uno schema esistente, verrà visualizzato l'Editor di schema. Per aggiornare un campo di classe esistente, seleziona il campo dalla struttura dello schema. Le informazioni del campo vengono visualizzate nella barra a destra. Assicurati che Assign to
l'opzione Class è selezionata o gli aggiornamenti non influiranno sulla classe.

Apporta le modifiche desiderate al campo, scorrendo verso il basso nella barra a destra per selezionare Apply per salvare le modifiche.

Per aggiungere nuovi campi, seguire la guida per aggiungere campi a una classe. Al termine, selezionare Save per salvare sia lo schema che la classe.

Modificare la classe di uno schema schema

È possibile modificare la classe dello schema in qualsiasi momento durante il processo di creazione iniziale prima che sia stato salvato. Tuttavia, questo deve essere fatto con cautela, in quanto i gruppi di campi sono compatibili solo con determinate classi. La modifica della classe ripristina l’area di lavoro e tutti i campi aggiunti.
Per ulteriori informazioni, consulta la guida su creazione e modifica di schemi.

Passaggi successivi next-steps

Questo documento illustra come creare e modificare le classi utilizzando l’interfaccia utente di Experience Platform. Per ulteriori informazioni sulle funzionalità dell'area di lavoro Schemas, vedere la panoramica dell'area di lavoro Schemas.

Per informazioni su come gestire le classi utilizzando l'API Schema Registry, vedere la guida dell'endpoint delle classi.