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

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.