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 dall'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.

Scheda Classi dellarea di lavoro Schemi con Standard e Personalizzato evidenziati.

TIP
Utilizza le funzionalità di ricerca per filtrare o trovare una classe in base al suo nome. Per ulteriori informazioni, consulta la guida sull'esplorazione delle risorse XDM.

Crea una nuova classe create

Nell’interfaccia utente di Platform sono disponibili due metodi per creare una classe. Da qualsiasi scheda nell'area di lavoro Schemi, selezionare Crea schema oppure dalla scheda Classi selezionare Crea classe.

Scheda Classi dellarea di lavoro Schemi con Crea schema e Crea classe evidenziati

Se si seleziona 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, serie di record o serie temporali. Seleziona Crea per confermare le scelte e tornare alla scheda Classi.

La finestra di dialogo Crea classe con Crea evidenziata.

La classe creata è disponibile ed elencata nella visualizzazione Classi.

Scheda Classi dellarea di lavoro Schemi con la classe creata di recente evidenziata.

Creare o modificare una classe create-or-edit

In alternativa, se si sceglie di creare manualmente uno schema, è possibile creare o modificare una classe esistente come parte di tale flusso di lavoro. Selezionare Crea schema seguito da Manuale nella finestra di dialogo Crea schema visualizzata.

NOTE
Se utilizzi il flusso di lavoro per la creazione di schemi assistiti da apprendimento automatico, puoi caricare un file e utilizzare gli algoritmi ML per generare uno schema consigliato. Nel flusso di lavoro di creazione dello schema non è necessario specificare la classe base per lo schema. Per informazioni su come ML può consigliare una struttura di schema basata su un file csv, consulta la guida alla creazione di schemi assistiti da apprendimento automatico.

Finestra di dialogo Crea schema con le opzioni del flusso di lavoro e seleziona evidenziato.

Viene visualizzato il flusso di lavoro per la creazione dello schema. Nella sezione Dettagli schema, seleziona Altro. Viene visualizzato un elenco delle classi disponibili. Da qui puoi sfogliare e filtrare le classi preesistenti su cui basare la nuova classe.

NOTE
Solo le classi personalizzate definite dall'organizzazione possono essere completamente modificate e personalizzate. Per le classi principali definite da Adobe, è possibile modificare solo i nomi visualizzati dei relativi campi nel contesto dei singoli schemi. Per ulteriori informazioni, consulta la sezione sulla modifica dei nomi visualizzati per i campi dello schema.
Dopo aver salvato e utilizzato una classe personalizzata nell’acquisizione dei dati, è possibile apportarvi solo modifiche aggiuntive. Per ulteriori informazioni, consulta le regole dell'evoluzione dello schema.

Il flusso di lavoro Crea schema con Altro evidenziato nella sezione Dettagli schema.

Selezionare un pulsante di opzione per filtrare le classi in base al fatto che si tratti di classi personalizzate o standard. Puoi anche filtrare i risultati disponibili in base al settore o cercare una classe specifica utilizzando il campo di ricerca.

Il flusso di lavoro Crea schema con la barra di ricerca Personalizzato e Industrie evidenziati.

Per aiutarti a decidere la classe appropriata, sono disponibili informazioni ( Unicona di informazioni. ) e anteprima ( Icona anteprima. ) per ogni classe. L’icona info apre una finestra di dialogo che fornisce una descrizione della classe e del settore a cui è associata. L'icona di anteprima apre una finestra di dialogo di anteprima per la classe che contiene un diagramma schema e le relative proprietà.

Anteprima della classe selezionata con il diagramma dello schema e le proprietà della classe evidenziate.

Seleziona una riga per scegliere una classe, quindi seleziona Successivo per confermare la scelta.

Il flusso di lavoro Crea schema con una classe selezionata dalla tabella delle classi disponibili ed evidenziato Avanti.

Viene visualizzata la sezione Name and review del flusso di lavoro. 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.

Immettere un nome breve, descrittivo, univoco e descrittivo per la classe nel campo di testo Nome visualizzato schema. Quindi, immetti una descrizione adatta per identificare il comportamento dei dati definiti dallo schema. Dopo aver rivisto la struttura dello schema e aver impostato correttamente le impostazioni, seleziona Fine per creare lo schema.

La sezione Name and review del flusso di lavoro Create schema con Schema display name, Description, e Finish evidenziato.

Viene visualizzato l’Editor di schema, con la struttura dello schema visualizzata nell’area di lavoro. Ora puoi iniziare ad aggiungere campi alla classe.

Editor di schema con la struttura dello schema visualizzata nellarea di lavoro.

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.

IMPORTANT
Quando crei uno schema che implementa una classe definita dall’organizzazione, ricorda che i gruppi di campi di schema sono disponibili per l’utilizzo solo con classi compatibili. Poiché la classe definita è nuova, nella finestra di dialogo Aggiungi gruppo di campi non sono elencati gruppi di campi compatibili. Sarà invece necessario creare nuovi gruppi di campi da utilizzare con tale classe. La prossima volta che componi uno schema che implementa la nuova classe, i gruppi di campi definiti verranno elencati e saranno disponibili per l’uso.

Editor di schema con il pulsante di aggiunta evidenziato.

IMPORTANT
Tenere presente che tutti i campi aggiunti a una classe verranno utilizzati in tutti gli schemi che utilizzano tale classe. Pertanto, è necessario considerare attentamente quali campi saranno utili in tutti i casi di utilizzo degli schemi. Se stai pensando di aggiungere un campo che potrebbe essere utilizzato solo in alcuni schemi di questa classe, puoi provare ad aggiungerlo a tali schemi creando un gruppo di campi.

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.

Campo senza titolo nellarea di lavoro delleditor di schema con la proprietà del campo Assegna a classe selezionata ed evidenziata.

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.

Lo schema appena creato nellarea di lavoro dellEditor di schema, con Salva evidenziato.

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

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.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07