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") di 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 all'interno dell'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 Platform, seleziona Schemi nell'area di navigazione a sinistra per aprire l'area di lavoro Schemi, quindi seleziona la scheda Classi. 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 Personalizzato. 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 Platform, tramite Crea classe o Crea schema.

Crea classe

Seleziona Crea classe dalla scheda Classi nell'area di lavoro Schemi.

Viene visualizzata la finestra di dialogo Crea classe. Immetti un Nome visualizzato e una Descrizione per la classe e scegli il comportamento previsto della classe con i pulsanti di scelta. Le classi possono essere di tipo Record o Serie temporali. Seleziona Crea per confermare le scelte e tornare alla scheda Classi.

La classe creata è disponibile ed elencata nella visualizzazione Classi.

Crea schema

In alternativa, puoi creare una classe creando manualmente uno schema. Seleziona Crea schema dalla scheda Classi nell'area di lavoro Schemi.

Selezionare Manuale nella finestra di dialogo Crea schema visualizzata.

Viene visualizzato il flusso di lavoro per la creazione dello schema. Nella sezione Dettagli schema, seleziona Altro. Viene visualizzato un elenco delle classi disponibili. Selezionare Crea classe.

Viene visualizzata la finestra di dialogo Crea classe. Immetti un Nome visualizzato e una Descrizione per la classe e scegli il comportamento previsto della classe con i pulsanti di scelta. Le classi possono essere di tipo Record o Serie temporali. Seleziona Crea per confermare le scelte e tornare alla scheda Classi.

L'elenco delle classi viene aggiornato nella sezione Dettagli schema e la classe appena creata viene selezionata automaticamente. Seleziona Avanti 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 nome visualizzato dello schema 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, seleziona Fine 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 per Campo senza titolo e la barra a destra si aggiorna per mostrare i controlli per configurare le proprietà del campo. In Assegna a, seleziona Classe.

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 Salva 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. Dall'interno della scheda Sfoglia nell'area di lavoro Schemi, selezionare una classe esistente o Crea uno 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 Assegna a
l'opzione Classe è selezionata o gli aggiornamenti non influiranno sulla classe.

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

Per aggiungere nuovi campi, seguire la guida per aggiungere campi a una classe. Al termine, selezionare Salva 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 Platform. Per ulteriori informazioni sulle funzionalità dell'area di lavoro Schemi, vedere la panoramica dell'area di lavoro Schemi.

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