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 Platform, seleziona Schemi nell'area di navigazione a sinistra. L'area di lavoro Schemi fornisce una scheda Sfoglia per esplorare tutti gli schemi dell'organizzazione, insieme a schede dedicate aggiuntive per esplorare rispettivamente Classi, Gruppi di campi, Tipi di dati e Relazioni.

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 Sfoglia e Relazioni.

Nella scheda Sfoglia dell'area di lavoro Schemi, puoi filtrare l'inventario degli schemi. Utilizza l'opzione Incluso nel profilo per visualizzare solo gli schemi abilitati per l'utilizzo in Profilo cliente in tempo reale. Utilizza l'interruttore Mostra schemi ad hoc per filtrare l'elenco di schemi creati con campi con spazio dei nomi utilizzabili solo da un singolo set di dati.

Nella scheda Relazione dell'area di lavoro Schemi è possibile filtrare l'elenco delle relazioni in base a quattro criteri. I filtri includono schema Source, schema di destinazione, classe Source e la classe Destination. 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.

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

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

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

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.

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

Passaggi successivi

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