Esplorare le risorse dello schema nell’interfaccia utente

In Adobe Experience Platform, tutte le risorse dello schema Experience Data Model (XDM) sono memorizzate in Schema Library, incluse le risorse standard fornite da Adobe e le risorse personalizzate definite dall’organizzazione. Nell’interfaccia utente di Experience Platform è possibile visualizzare la struttura e i campi di qualsiasi schema, classe, gruppo di campi o tipo di dati esistente in Schema Library. Questa funzione è particolarmente utile durante la pianificazione e la preparazione per l’acquisizione dei dati, in quanto l’interfaccia utente fornisce informazioni sui tipi di dati previsti e sui casi di utilizzo di ciascun campo fornito da queste risorse XDM.

Questa guida spiega come esplorare schemi, classi, gruppi di campi, tipi di dati e relazioni esistenti nell’interfaccia utente di Experience Platform.

Cercare una risorsa schema lookup

Nell’interfaccia utente di Experience Platform, seleziona Schemi nella barra a sinistra. L’area di lavoro Schemi fornisce una scheda Sfoglia in cui è possibile visualizzare tutti gli schemi dell’organizzazione. È inoltre possibile utilizzare le schede Classi, Gruppi di campi, Tipi di dati e Relazioni per visualizzare tali risorse.

Area di lavoro Schemi con diverse schede evidenziate.

Utilizza gli strumenti di filtro e di ricerca nell’area di lavoro Schemi per restringere l’elenco degli schemi e individuare più rapidamente risorse specifiche. L’icona del filtro ( icona Filtro ) apre il pannello dei filtri, in cui è possibile filtrare gli schemi utilizzando metadati, identità, relazione, data e criteri di proprietà. I filtri delle risorse sono disponibili nelle schede Sfoglia e Relazioni.

Scheda Sfoglia dell'area di lavoro Schemi con il pannello dei filtri completo evidenziato.

Filtri per metadati dello schema

Filtrare gli schemi in base alle loro caratteristiche fondamentali e agli attributi organizzativi.

Filtro
Tipo di controllo
Descrizione
Mostra profili
Pulsanti di scelta
Visualizza solo All, Enabled o solo Disabled. Gli schemi abilitati per il profilo partecipano a Real-Time Customer Profile e supportano le visualizzazioni unificate dei clienti all’interno dell’organizzazione.
Tipo di schema
Caselle di controllo
Filtra per origine dello schema: Schemi standard (forniti da Adobe), Schemi relazionali (funzionalità strutturate di modellazione dati relazionali) o Schemi ad hoc (campi con spazio dei nomi da utilizzare per un singolo set di dati).
Classe
A discesa
Mostra solo gli schemi basati su basi di classi specifiche, ad esempio Profilo individuale XDM, ExperienceEvent XDM o classi personalizzate definite dall’organizzazione.
Tag
A discesa
Filtrare gli schemi per tag definiti dall’utente e applicati dall’utente. Le opzioni includono Ha qualsiasi tag e Ha tutti i tag. Utilizza i tag per individuare gli schemi organizzati per progetto, team, dominio aziendale o tassonomie personalizzate che supportano le procedure di gestione dello schema organizzativo.

Filtri degli attributi dello schema

Risultati ridotti in base alla struttura dello schema e alla configurazione dell’identità.

Filtro
Tipo di controllo
Descrizione
Ha una relazione
Caselle di controllo Sì/No
Mostra solo gli schemi che contengono campi di relazione che si connettono ad altri schemi. I campi di relazione consentono connessioni dati tra schemi diversi e supportano scenari di modellazione dati complessi.
Ha identità primaria
Caselle di controllo Sì/No
Filtra gli schemi con campi di identità primari designati. I campi di identità primari sono necessari per l’abilitazione del profilo e fungono da base per l’unificazione dei dati del cliente.
Spazio dei nomi identità primaria
A discesa
Trova gli schemi che utilizzano particolari tipi di identità come e-mail, ECID, telefono o spazi dei nomi personalizzati come identificatori primari.

Filtri temporali e filtri creatori

Filtrare gli schemi in base ai pattern di creazione e alla proprietà.

Filtro
Tipo di controllo
Descrizione
Data di creazione
Selettori data di inizio e di fine
Filtrare gli schemi per intervalli di date di creazione. Individua gli schemi creati di recente o trova gli schemi generati durante specifiche fasi o periodi di tempo del progetto.
Data di modifica
Selettori data di inizio e di fine
Filtrare gli schemi per intervalli di date di modifica. Identifica gli schemi con aggiornamenti o modifiche recenti per supportare i flussi di lavoro di manutenzione e governance.
Creato da
A discesa
Filtrare gli schemi in base al creatore originale. Individua gli schemi generati da membri del team, sistemi o account di servizio specifici per supportare il rilevamento della proprietà e la collaborazione.

Filtri della scheda Relazione

Quando visualizzi le relazioni tra schemi nella scheda Relazioni, utilizza filtri aggiuntivi per esplorare le connessioni tra schemi:

Filtro
Tipo di controllo
Descrizione
Schema Source
A discesa
Visualizza le relazioni in cui lo schema selezionato è il punto iniziale o “sorgente”.
Schema di destinazione
A discesa
Mostra le relazioni in cui lo schema selezionato è la destinazione o “destinazione”.
Classe Source
A discesa
Filtra le relazioni in base alla classe dello schema di avvio.
Classe di destinazione
A discesa
Visualizzare le relazioni che terminano con gli schemi di una classe specifica.

Scheda Relazione dell'area di lavoro Schemi con i campi filtro evidenziati.

Combinare più filtri

Combina i filtri per restringere l’elenco degli schemi e trovare più rapidamente risorse specifiche. Ad esempio, puoi trovare schemi standard abilitati per il profilo con tag personalizzati creati nell’ultimo mese oppure individuare schemi ad hoc che utilizzano un’identità principale e-mail e contengono campi di relazione.

Il pannello dei filtri avanzato nell'area di lavoro Schemi mostra più tipi di filtri applicati contemporaneamente.

I filtri applicati vengono visualizzati come chip rimovibili nella riga di intestazione inventario. Per rimuovere un filtro, selezionare × nel relativo chip. Per rimuovere tutti i filtri attivi contemporaneamente, selezionare Cancella tutto.

Utilizza la barra di ricerca per limitare ulteriormente i risultati.

Scheda Sfoglia dell'area di lavoro Schemi con il campo di ricerca evidenziato.

I risultati della ricerca sono classificati in base alle corrispondenze nei titoli delle risorse e nelle descrizioni. Le corrispondenze dei titoli hanno priorità rispetto alle corrispondenze delle descrizioni e le risorse con termini più corrispondenti appaiono più in alto nell’elenco dei risultati.

Una volta trovata la risorsa da esplorare, selezionane il nome dall’elenco per visualizzarne la struttura nell’area di lavoro.

Sfogliare, organizzare e gestire gli schemi browse-organize-manage-schemas

Utilizza l’area di lavoro Schemi per trovare, organizzare e gestire gli schemi. Puoi filtrare l’inventario degli schemi, ordinare le colonne di metadati ed eseguire azioni comuni sugli schemi direttamente dalla vista inventario.

Sfoglia e filtra i metadati

Nell’inventario degli schemi vengono visualizzati i metadati chiave dello schema in un’unica vista a tabella. Puoi visualizzare i tag, il tipo di schema, lo stato di abilitazione del profilo, la data di creazione, la data dell’ultima modifica, la classe, le identità, le relazioni, il comportamento e altri metadati senza aprire singoli schemi.

Per ordinare l’inventario, selezionare un’intestazione di colonna. Seleziona nuovamente la stessa intestazione di colonna per invertire l’ordinamento.

Se l’inventario contiene più risultati di quelli che si adattano a una singola pagina, utilizzare i controlli della pagina nella parte inferiore dell’elenco per spostarsi tra le pagine.

Inventario dello schema dell'area di lavoro Schemi che mostra le colonne Tag, Tipo di schema, Abilitazione profilo, Data di creazione, Ultima modifica, Classe, Identità, Relazioni e Comportamento.

Eseguire azioni in linea sugli schemi

Utilizza il menu con i puntini di sospensione per una riga di schema per eseguire azioni comuni sullo schema direttamente dalla vista inventario.

Le azioni sono disponibili sia nella vista inventariale che nella vista dei dettagli delle risorse. Alcune azioni sono disponibili solo per le risorse personalizzate (definite dal tenant). Le risorse standard fornite da Adobe possono avere opzioni di azione limitate.

Menu con puntini di sospensione per una riga dello schema che mostra azioni in linea quali Modifica, Elimina, Applica etichette e Gestisci tag.

A seconda del tipo di risorsa e delle autorizzazioni, puoi modificare le proprietà dello schema, applicare le etichette di governance dei dati, eliminare gli schemi e gestire i tag senza aprire lo schema. Ulteriori azioni includono lo spostamento degli schemi nelle cartelle, l’aggiunta di schemi ai pacchetti di distribuzione, la copia di JSON per lo schema e il download di file di esempio da testare.

NOTE
Utilizza i file di esempio solo per testare la struttura dello schema. Non includere i dati di produzione.

Per istruzioni dettagliate su ciascuna azione, consulta la guida alle azioni dello schema.

Utilizza tag e cartelle per organizzare e individuare gli schemi nell’inventario. I tag consentono di raggruppare gli schemi per progetto, team, dominio dati o altre categorie definite dall’organizzazione. Le cartelle forniscono una struttura gerarchica per organizzare gli schemi correlati.

Per filtrare gli schemi per tag, seleziona l’icona del filtro ( icona Filtro ) per aprire il pannello dei filtri. Quindi seleziona uno o più tag dal menu a discesa Con qualsiasi tag.

Filtrare gli schemi in base ai tag definiti dall'utente nell'inventario degli schemi per individuare schemi specifici.

Per sfogliare gli schemi per cartella, selezionare l’icona Mostra cartelle ( Mostra cartelle icona ). La gerarchia delle cartelle viene visualizzata nella barra a sinistra. Seleziona una cartella per visualizzare i relativi schemi associati.

Passa alle gerarchie di cartelle nella barra a sinistra per sfogliare e individuare gli schemi.

I tag e le cartelle funzionano con il sistema di filtraggio dell’inventario, che consente di restringere l’elenco degli schemi in base ai tag e alle posizioni delle cartelle assegnati.

Per informazioni sulla creazione e la gestione dei tag in Experience Platform, consulta la guida alla gestione dei tag unificati.

Esplorare una risorsa XDM nell’area di lavoro explore

Dopo aver selezionato una risorsa, la sua struttura si apre nell’area di lavoro.

Area di lavoro del tipo di dati che visualizza il tipo di dati di Commerce.

Tutti i campi di tipo oggetto contenenti sottoproprietà vengono compressi per impostazione predefinita quando vengono visualizzati per la prima volta nell’area di lavoro. Per visualizzare le sottoproprietà di qualsiasi campo, seleziona l’icona accanto al nome.

Area di lavoro del tipo di dati con campi espansi e sottoproprietà evidenziate.

Indicatore di classe e gruppo di campi standard standard-class-and-field-group-indicator

Nell’Editor schema, le classi e i gruppi di campi standard visualizzano un’icona lucchetto ( icona lucchetto. ). L’icona identifica le risorse generate da Adobe con restrizioni di modifica. Viene visualizzato nella barra a sinistra accanto ai nomi di classi e gruppi di campi e accanto ai campi che appartengono alle risorse generate da Adobe nel diagramma dello schema.

Editor schema con l'icona lucchetto evidenziata

Impossibile modificare una classe standard. Per estendere un gruppo di campi standard, consulta la documentazione Aggiungere campi personalizzati ai gruppi di campi standard.

Campi generati dal sistema system-fields

Alcuni nomi di campo sono preceduti da un trattino basso, ad esempio _repo e _id. Questi rappresentano segnaposto per i campi che il sistema genera e assegna automaticamente quando i dati vengono acquisiti.

Di conseguenza, la maggior parte di questi campi deve essere esclusa dalla struttura dei dati al momento dell’acquisizione in Experience Platform. L’eccezione principale a questa regola è il campo _{TENANT_ID}, in cui tutti i campi XDM creati nell’organizzazione devono essere namespace.

Tipi di dati data-types

Per ogni campo visualizzato nell’area di lavoro, accanto al nome viene visualizzato il tipo di dati corrispondente, che indica subito il tipo di dati previsto dal campo per l’acquisizione.

Il tipo di dati Indirizzo postale visualizzato nell'area di lavoro con i tipi di dati associati evidenziati.

Qualsiasi tipo di dati aggiunto con parentesi quadre ([]) rappresenta una matrice di quel particolare tipo di dati. Ad esempio, un tipo di dati String[] indica che il campo richiede una matrice di valori stringa. Un tipo di dati Elemento pagamento[] indica un array di oggetti conformi al tipo di dati Elemento pagamento.

Se un campo array è basato su un tipo di oggetto, è possibile selezionarne l’icona nell’area di lavoro per visualizzare gli attributi previsti per ogni elemento array.

Oggetto nell'area di lavoro con campo di matrice evidenziato e attributi previsti per ogni elemento di matrice visualizzato.

Proprietà campo field-properties

Quando selezioni il nome di un campo nell’area di lavoro, la barra a destra si aggiorna per mostrare i dettagli di quel campo in Proprietà campo. Questo può includere una descrizione del caso d’uso previsto del campo, Valore predefinito (metadati dello schema informativo che non vengono applicati durante l’acquisizione), modelli, formati, se il campo è obbligatorio e altro ancora. Consulta proprietà del campo specifiche del tipo per informazioni sulle differenze tra valore predefinito e le impostazioni di convalida dell’acquisizione. Durante l’esplorazione di un gruppo di campi, è possibile visualizzare qui anche i dettagli relativi alle etichette per il campo selezionato. Vedere Etichette nella visualizzazione struttura.

Campo selezionato dal tipo di dati Commerce con le proprietà del campo evidenziate.

Se il campo che stai esaminando è un campo enum, nella barra a destra verranno visualizzati anche i valori accettabili che il campo si aspetta di ricevere.

Editor schema con un campo selezionato e valori enum e nomi visualizzati evidenziati nella barra delle proprietà del campo.

Campi di identità identity

Durante l’analisi degli schemi che contengono campi di identità, questi campi sono elencati nella barra a sinistra sotto la classe o il gruppo di campi che li fornisce allo schema. Seleziona il nome del campo di identità nella barra a sinistra per visualizzare il campo nell’area di lavoro, indipendentemente dalla profondità di nidificazione.

I campi di identità sono evidenziati nell’area di lavoro con un’icona di impronta digitale ( Immagine icona impronta digitale ). Se si seleziona il nome del campo di identità, è possibile visualizzare ulteriori informazioni, ad esempio lo spazio dei nomi identità e se il campo rappresenta o meno l’identità primaria dello schema.

Editor schema con l'identità dello schema evidenziata nella barra a sinistra, il campo evidenziato nel diagramma schema e lo spazio dei nomi dell'identità evidenziato nelle proprietà del campo.

NOTE
Per ulteriori informazioni sui campi di identità e sulla loro relazione con i servizi Experience Platform a valle, consulta la guida su definizione dei campi di identità.

Campi di relazione relationship

Se stai esaminando uno schema che contiene un campo di relazione, il campo verrà elencato nella barra a sinistra in Relazioni. Seleziona il nome del campo relazione nella barra a sinistra per visualizzare il campo nell’area di lavoro, indipendentemente dalla profondità di nidificazione. I campi di relazione vengono inoltre evidenziati in modo univoco nell’area di lavoro, mostrando il nome dello schema di riferimento a cui è collegato il campo. Per le organizzazioni con funzionalità B2B, in questi casi è possibile scrivere nomi di relazione personalizzati che verranno visualizzati nell’area di lavoro.

Editor schema con il campo relazione e la relazione Modifica evidenziati.

Per visualizzare lo spazio dei nomi dell’identità primaria dello schema di riferimento, selezionare il campo relazione, quindi Modifica relazione nella barra laterale Proprietà campo. I parametri per la relazione vengono visualizzati nella finestra di dialogo Modifica relazione visualizzata.

Viene visualizzata la finestra di dialogo Modifica relazione con i parametri di relazione.

Per ulteriori informazioni sull’utilizzo delle relazioni negli schemi XDM, consulta il tutorial su creazione di una relazione nell’interfaccia utente.

Esplora gruppi di campi: utilizzo e metadati explore-field-groups

Passa a Schemi > Gruppi di campi per esplorare i gruppi di campi. Nella scheda Gruppi di campi, le funzionalità aggiuntive consentono di comprendere dove viene utilizzato un gruppo di campi in tutti gli schemi e cosa include, ad esempio compatibilità, campi obbligatori (che impongono i requisiti di acquisizione) e segnali di governance.

Queste funzioni consentono di valutare l’impatto prima di apportare modifiche e identificare in modo più efficiente i gruppi di campi rilevanti durante la progettazione dello schema.

Visualizza utilizzo schema per gruppi di campi view-schema-usage-for-field-groups

Nella tabella Gruppi di campi selezionare un gruppo di campi per aprirne la visualizzazione dettagli. L’area di lavoro viene aggiornata per visualizzare la struttura del gruppo di campi e la barra delle proprietà mostra informazioni aggiuntive sulla risorsa selezionata.

Schemi che utilizzano questo gruppo di campi

Nella barra delle proprietà a destra, nella sezione Schemi che utilizzano questo gruppo di campi sono elencati gli schemi che attualmente includono il gruppo di campi.

La barra delle proprietà del gruppo di campi mostra gli schemi che utilizzano questa sezione del gruppo di campi.

  • Se il gruppo di campi viene utilizzato da tre o meno schemi, vengono visualizzati tutti i nomi degli schemi.
  • Se viene utilizzato da più di tre schemi, vengono visualizzati solo alcuni nomi e un’opzione per visualizzare l’elenco completo.

Seleziona un nome di schema per aprirne la visualizzazione dettagli in una nuova scheda e controllare come il gruppo di campi viene implementato all’interno di tale schema.

Visualizza altro e elenco completo degli schemi

Se esistono più schemi di quanti possano essere visualizzati in linea, seleziona Visualizza altri per aprire la finestra di dialogo completa.

Opzione Visualizza altro negli schemi che utilizzano questa sezione del gruppo di campi.

Viene visualizzata la finestra di dialogo Schemi che utilizzano questo gruppo di campi, con l’elenco completo degli schemi che utilizzano il gruppo di campi.

Schemi che utilizzano questa finestra di dialogo del gruppo di campi che visualizza l'elenco e le colonne dello schema.

Nella finestra di dialogo Schemi che utilizzano questo gruppo di campi è possibile:

  • Sfoglia tutti gli schemi che utilizzano il gruppo di campi
  • Pagina attraverso set di risultati di grandi dimensioni
  • Seleziona uno schema per aprirne la visualizzazione dettagli in una nuova scheda

Puoi visualizzare i dettagli dello schema come il nome dello schema, la classe e altri attributi.

Questo flusso di lavoro è destinato solo a analisi di impatto ed esplorazione. Non modifica schemi o gruppi di campi. Per modificare la struttura dello schema, vedere Creare e modificare schemi nell’interfaccia utente.

Metadati del gruppo di campi e filtro field-group-metadata-and-filtering

La scheda Gruppi di campi fornisce metadati e strumenti di filtro che consentono di individuare e valutare i gruppi di campi prima di selezionarli.

Sfoglia tabella e filtri

La tabella di inventario dei gruppi di campi include colonne aggiuntive che espongono i metadati direttamente nella visualizzazione elenco, ad esempio Classi compatibili, che indica a quali classi può essere applicato un gruppo di campi. I gruppi di campi possono essere aggiunti solo agli schemi che utilizzano una delle classi compatibili elencate, in base al comportamento dei dati che rappresentano (ad esempio, dati basati su record o serie temporali). La tabella potrebbe visualizzare All se il gruppo di campi è compatibile con tutte le classi. I tag di settore consentono di categorizzare i gruppi di campi per l’individuazione.

Per perfezionare l’elenco, seleziona l’icona del filtro ( Immagine icona filtro ) per aprire il pannello del filtro nella barra a sinistra. L’immagine seguente mostra il pannello dei filtri aperto nella barra a sinistra.

La scheda Gruppi di campi mostra le classi compatibili, i tag di settore e il pannello dei filtri.

Nel pannello dei filtri puoi effettuare le seguenti operazioni:

  • Classi compatibili - Utilizzare il menu a discesa per filtrare i gruppi di campi in base alla compatibilità delle classi
  • Tag di settore: utilizzare le caselle di controllo per filtrare in base a una o più categorie di settore

Durante la navigazione, seleziona una riga nella tabella per attivare la barra informazioni. La barra delle informazioni mostra metadati quali classi compatibili e tag di settore, in modo da poter rivedere i dettagli chiave senza aprire il gruppo di campi.

Metadati dei dettagli del gruppo di campi

Quando apri un gruppo di campi, nella barra delle proprietà vengono visualizzati i metadati aggiuntivi associati alla risorsa.

La barra delle proprietà può visualizzare i seguenti metadati:

  • Classi compatibili — Classi che il gruppo di campi può estendere
  • Attributi richiesti — Attributi che devono avere valori validi quando richiesto dal gruppo di campi durante l’inserimento dei dati. I requisiti dipendono dalla struttura dei dati e i record con valori richiesti mancanti o non validi non vengono convalidati
  • Etichette — Le etichette non vengono visualizzate a livello di gruppo di campi. Seleziona un campo per visualizzare i dettagli dell’etichetta nella barra Proprietà campo

Queste informazioni sono utili per comprendere vincoli e requisiti prima di utilizzare o modificare il gruppo di campi.

Etichette nella vista struttura

Quando un gruppo di campi è aperto nell’area di lavoro, è possibile visualizzare le informazioni sull’etichetta direttamente nella struttura. Selezionare l’icona delle impostazioni ( Icona delle impostazioni. ) sulla barra degli strumenti area di lavoro e abilitare Mostra etichette nella struttura per visualizzare gli indicatori delle etichette nei campi dell’area di lavoro.

L'area di lavoro del gruppo di campi mostra la finestra di dialogo delle opzioni di visualizzazione della struttura con Mostra etichette nella struttura evidenziata.

Selezionare un campo nell’area di lavoro per visualizzare i dettagli delle etichette nella barra Proprietà campo, incluse le etichette applicate a tale campo.

L'area di lavoro del gruppo di campi mostra le etichette nei campi e i dettagli delle etichette nella barra delle proprietà dei campi.

Le etichette sono raggruppate per categoria (ad esempio, etichette di identità e sensibili) e forniscono visibilità sulla governance o sui vincoli di accesso applicati ai dati.

Questi indicatori sono solo a scopo di visibilità e non modificano la struttura dello schema. Per ulteriori informazioni, vedere Gestire le etichette di utilizzo dei dati per uno schema.

Passaggi successivi

Utilizza le seguenti risorse per continuare a lavorare con gli schemi XDM e le relative funzioni di Experience Platform:

recommendation-more-help
experience-platform-help-xdm