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.

Numero di classi allinterno della scheda Classi dellarea di lavoro Schemi Classi e Schemi evidenziati.

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.

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

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.

Scheda Classi dellarea di lavoro Schemi con Crea classe evidenziata

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

Crea schema

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

Scheda Classi dellarea di lavoro Schemi con Crea schema evidenziato

Selezionare 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. Selezionare Crea classe.

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

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 finestra di dialogo Crea classe con Crea evidenziata.

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.

La sezione Dettagli schema con la nuova classe selezionata ed evidenziata Successivo.

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.

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

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 schema con la proprietà di 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 una classe (#edit-a-class)

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.

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

Editor di schema con una classe esistente e Creazione di uno schema evidenziati.

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.

LEditor di schema con un campo selezionato ed evidenziato e la barra a destra esposta, evidenziando Assegna a.

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

IMPORTANT
Eventuali aggiornamenti apportati ai campi verranno applicati a tutti gli schemi che utilizzano tale classe, seguendo le regole di evoluzione dello schema.

Editor schema con un campo selezionato e la barra a destra esposta, evidenziando Applica.

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.

Editor schema con Salva evidenziato.

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