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.

Questo tutorial illustra i passaggi necessari per esplorare schemi, classi, gruppi di campi e tipi di dati esistenti nell’interfaccia utente di Experience Platform.

Cercare una risorsa schema lookup

Nell'interfaccia utente di Experience Platform, seleziona Schemas nel menu di navigazione a sinistra. L'area di lavoro Schemas fornisce una scheda Browse per esplorare tutti gli schemi dell'organizzazione, insieme a schede dedicate aggiuntive per esplorare rispettivamente Classes, Field groups, Data types e Relationships.

L'icona del filtro ( ) rivela i controlli nella barra a sinistra per limitare i risultati elencati. I filtri delle risorse sono disponibili per schemi e relazioni rispettivamente nelle schede Browse e Relationships. Nella scheda Field groups, utilizza i filtri descritti in Metadati del gruppo di campi e filtro per limitare l'elenco in base a tag di classe e settore compatibili.

Nella scheda Browse dell'area di lavoro Schemas è possibile filtrare l'inventario degli schemi. Utilizzare l'interruttore Included in Profile per visualizzare solo gli schemi abilitati per l'utilizzo in Profilo cliente in tempo reale. Utilizza l'interruttore Show adhoc schemas per filtrare l'elenco di schemi creati con campi con spazio dei nomi utilizzabili solo da un singolo set di dati.

Nella scheda Relationship dell'area di lavoro Schemas è possibile filtrare l'elenco delle relazioni in base a quattro criteri. I filtri includono Source schema, Destination schema, Source class e Destination class. La tabella seguente fornisce una descrizione dei filtri.

Puoi anche utilizzare la barra di ricerca per limitare ulteriormente i risultati.

Le risorse visualizzate nei risultati della ricerca vengono ordinate prima in base alle corrispondenze titolo, quindi in base alle corrispondenze descrizione. A sua volta, più le parole corrispondono in una di queste categorie, più la risorsa viene visualizzata nell’elenco.

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

Gestire schemi, classi, gruppi di campi e tipi di dati: azioni ed eliminazione xdm-resource-actions

Usa questa sezione quando devi gestire o eliminare risorse XDM o quando un’azione (come l’eliminazione) non è disponibile e devi capire perché.

Dove trovare le azioni (pagina in linea o pagina dei dettagli) where-to-find-actions

Per eseguire azioni quali l'eliminazione, l'esportazione o la copia di una risorsa, utilizzare uno dei seguenti punti di ingresso:

Nelle schede Browse, Classes, Field groups e Data types, le azioni di gestione sono disponibili in due posizioni:

Queste azioni sono coerenti tra i due punti di ingresso per i tipi di risorse supportati (schemi, classi, gruppi di campi e tipi di dati).

Azioni disponibili available-actions

A seconda del tipo di risorsa e delle autorizzazioni, possono essere disponibili le azioni seguenti:

Quanto segue si applica a diversi tipi di risorse:

Comportamento eliminazione delete-behavior

Utilizzare l'azione Delete quando si desidera rimuovere una risorsa personalizzata non più necessaria.

Per eliminare una risorsa:

La risorsa viene rimossa definitivamente dall’organizzazione dopo la conferma.

Se l’eliminazione non è disponibile per una risorsa, l’opzione appare disabilitata con una descrizione che spiega perché non è possibile eseguire l’azione.

Vincoli (set di dati, profilo, RBAC, tenant vs globale) delete-constraints

Se un'azione come Delete non è disponibile o è disabilitata, in genere è dovuta a una delle seguenti condizioni:

Questi vincoli si riflettono direttamente nell’interfaccia utente di. Quando un’azione non è disponibile, appare disabilitata e include una descrizione del limite specifico.

Se non è possibile eliminare una risorsa, controlla le condizioni precedenti per determinare se è necessario aggiornare le autorizzazioni, rimuovere le dipendenze o modificare il modello dati.

Per ulteriori flussi di lavoro di modifica dello schema nell'area di lavoro, vedere Creare e modificare schemi nell'interfaccia utente.

Esplorare una risorsa XDM nell’area di lavoro explore

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

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.

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 (generati da Adobe) sono indicati con l'icona lucchetto ( . Il lucchetto viene visualizzato nella barra a sinistra accanto al nome della classe o del gruppo di campi, nonché accanto a qualsiasi campo nel diagramma dello schema che fa parte di una risorsa generata dal sistema.

Consulta la documentazione Aggiungere campi personalizzati ai gruppi di campi standard. Impossibile modificare una classe 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.

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 Payment Item[] indica un array di oggetti conformi al tipo di dati Payment Item.

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.

Field properties 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 Field properties. Questo può includere una descrizione del caso d’uso previsto del campo, valori predefiniti, modelli, formati, se il campo è obbligatorio e altro ancora. 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.

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.

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

Campi di relazione relationship

Se si esamina uno schema che contiene un campo di relazione, il campo verrà elencato nella barra a sinistra in Relationships. 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.

Per visualizzare lo spazio dei nomi delle identità dell'identità primaria dello schema di riferimento, selezionare il campo relazione, quindi Edit relationship nella barra laterale Field properties. I parametri per la relazione vengono visualizzati nella finestra di dialogo Edit relationship visualizzata.

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 Schemas > Field groups per esplorare i gruppi di campi. Nella scheda Field groups, 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

Dalla tabella Field groups, 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, la sezione Schemas using this field group elenca gli schemi che attualmente includono il gruppo di campi.

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 sono presenti più schemi di quanti possano essere visualizzati in linea, selezionare View more per aprire la finestra di dialogo completa.

Viene visualizzata la finestra di dialogo Schemas using this field group, con l'elenco completo degli schemi che utilizzano il gruppo di campi.

Nella finestra di dialogo Schemas using this field group è possibile:

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 Field groups 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 Compatible classes, che indica a quali classi è possibile applicare 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. Industry tags consente di categorizzare i gruppi di campi per l'individuazione.

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

Nel pannello dei filtri puoi effettuare le seguenti operazioni:

Durante la navigazione, seleziona una riga nella tabella per aggiornare la barra delle 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:

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 ( ) sulla barra degli strumenti area di lavoro e abilitare Show labels on tree per visualizzare gli indicatori delle etichette sui campi dell'area di lavoro.

Selezionare un campo nell'area di lavoro per visualizzare i dettagli delle etichette nella barra Field properties, incluse le etichette applicate a tale campo.

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

Questo documento illustra come esplorare le risorse XDM esistenti nell’interfaccia utente di Experience Platform. Per ulteriori informazioni sulle diverse caratteristiche dell'area di lavoro Schemas e di Schema Editor, vedere la panoramica dell'area di lavoro Schemas.