Definire i campi XDM nell’interfaccia utente
Il Schema Editor Nell’interfaccia utente di Adobe Experience Platform puoi definire i tuoi campi all’interno delle classi e dei gruppi di campi dello schema personalizzati di Experience Data Model (XDM). Questa guida descrive i passaggi per definire i campi XDM nell’interfaccia utente di, incluse le opzioni di configurazione disponibili per ogni tipo di campo.
Prerequisiti
Questa guida richiede una buona conoscenza del sistema XDM. Consulta la sezione Panoramica di XDM per un’introduzione al ruolo di XDM nell’ecosistema Experience Platform e nozioni di base sulla composizione dello schema per scoprire come le classi e i gruppi di campi contribuiscono ai campi degli schemi XDM.
Sebbene non sia necessario per questa guida, si consiglia di seguire l’esercitazione anche su composizione di uno schema nell’interfaccia utente per acquisire familiarità con le varie funzionalità del Schema Editor.
Seleziona una risorsa a cui aggiungere campi select-resource
Per definire nuovi campi XDM nell’interfaccia utente, devi prima aprire uno schema all’interno di Schema Editor. A seconda degli schemi attualmente disponibili in Schema Library, è possibile scegliere di crea un nuovo schema o seleziona uno schema esistente da modificare.
Una volta ottenuta la Schema Editor apri, i controlli per aggiungere campi vengono visualizzati nell'area di lavoro. Questi controlli vengono visualizzati accanto al nome dello schema, nonché nei campi di tipo oggetto definiti nella classe o nel gruppo di campi selezionato.
Per aggiungere un nuovo campo alla risorsa, seleziona la più (+) accanto al nome dello schema nell’area di lavoro o accanto al campo di tipo oggetto in cui desideri definire il campo.
I passaggi necessari per aggiungere un campo variano a seconda che si stia aggiungendo un campo direttamente a uno schema o alla classe e ai gruppi di campi che lo costituiscono. Il resto di questo documento si concentra su come configurare le proprietà di un campo indipendentemente da dove questo campo viene visualizzato nello schema. Per ulteriori informazioni sui diversi modi in cui i campi possono essere aggiunti a uno schema, consulta le sezioni seguenti nella guida dell’interfaccia utente Schemi:
Definire le proprietà di un campo define
Dopo aver selezionato più (+) icona, un Campo senza titolo il segnaposto viene visualizzato nell’area di lavoro.
Nella barra a destra sotto Proprietà campo, è possibile configurare i dettagli del nuovo campo. Per ogni campo sono necessarie le seguenti informazioni:
Nome univoco e descrittivo del campo. Tieni presente che il nome del campo non può essere modificato una volta salvato lo schema. Questo valore viene utilizzato per identificare e fare riferimento al campo nel codice e in altre applicazioni a valle
Il nome dovrebbe idealmente essere scritto in CamelCase. Può contenere caratteri alfanumerici, trattini o trattini bassi, ma non può inizia con un trattino basso.
- Corretto:
fieldName - Accettabile:
field_name2,Field-Name,field-name_3 - Errato:
_fieldName
Nota: se si seleziona il tipo di dati Mappa, Tipo di valore mappa viene visualizzata la proprietà.
Puoi anche selezionare Ricerca avanzata dei tipi per cercare e filtrare i tipi di dati esistenti e individuare più facilmente il tipo desiderato.
Per ulteriori informazioni su proprietà del campo specifiche del tipo, consulta la panoramica sulla definizione dei campi.
Puoi anche scegliere di fornire una descrizione e delle note per ciascun campo. Utilizza il Descrizione per aggiungere contesto e descrivere la funzionalità del tipo di dati mappa. Ciò contribuisce alla manutenzione e alla leggibilità dell’implementazione. È inoltre possibile aggiungere note per completare la descrizione iniziale. Questo dovrebbe offrire informazioni più granulari e specifiche per aiutare gli sviluppatori a comprendere, mantenere e utilizzare efficacemente la mappa nel contesto della base di codice. |
Al termine della configurazione del campo, seleziona Applica.
L’area di lavoro viene aggiornata per mostrare il campo appena aggiunto, che si trova all’interno di un oggetto con spazio dei nomi assegnato all’ID tenant univoco (visualizzato come _tenantId nell’esempio seguente). Tutti i campi personalizzati aggiunti a uno schema vengono automaticamente inseriti all’interno di questo spazio dei nomi per evitare conflitti con altri campi da classi e gruppi di campi forniti dall’Adobe. La barra a destra elenca ora il percorso del campo oltre alle altre proprietà.
Puoi continuare a seguire i passaggi precedenti per aggiungere altri campi allo schema. Una volta salvato lo schema, anche la classe base e i gruppi di campi vengono salvati se sono state apportate modifiche.
Proprietà del campo specifiche del tipo type-specific-properties
Quando definisci un nuovo campo, nella barra a destra possono essere visualizzate opzioni di configurazione aggiuntive a seconda della Tipo scegli per il campo. La tabella seguente illustra queste proprietà di campo aggiuntive e i relativi tipi compatibili:
Nota: qualsiasi tipo di dati mappa creato tramite l’API che non sia un tipo String o Integer viene visualizzato come "Complesso' tipo di dati. Impossibile creare 'Complesso' tipi di dati tramite l'interfaccia utente.
I valori predefiniti non vengono salvati nel set di dati al momento dell’acquisizione, in quanto possono cambiare nel tempo. I valori predefiniti impostati nello schema vengono dedotti dai servizi e dalle applicazioni Platform a valle quando leggono i dati dal set di dati. Ad esempio, quando si esegue una query sui dati utilizzando Query Service, se l’attributo ha un valore NULL, ma il valore predefinito è impostato su
5 a livello di schema, è previsto che Query Service restituisca 5 invece di NULL. Tieni presente che al momento questo comportamento non è uniforme in tutti i servizi AEP.Seleziona da un elenco di formati predefiniti per le stringhe a cui il valore deve essere conforme. I formati disponibili includono:
Tipi di campo speciali special
La barra a destra fornisce diverse caselle di controllo per designare ruoli speciali per il campo selezionato. I casi d’uso per alcune di queste opzioni richiedono considerazioni importanti sulla strategia di modellazione dei dati e su come intendi utilizzare i servizi Platform a valle.
Per ulteriori informazioni su questi tipi speciali, consulta la seguente documentazione:
Anche se tecnicamente non si tratta di un tipo di campo speciale, si consiglia di visitare la guida definizione dei campi di tipo oggetto per ulteriori informazioni sulla definizione dei sottocampi nidificati, se le strutture dello schema sono configurate.
Passaggi successivi
Questa guida fornisce una panoramica su come definire i campi XDM nell’interfaccia utente. Ricorda che i campi possono essere aggiunti agli schemi solo tramite l’utilizzo di classi e gruppi di campi. Per ulteriori informazioni su come gestire queste risorse nell’interfaccia utente, consulta le guide sulla creazione e la modifica di classi e gruppi di campi.
Per ulteriori informazioni sulle funzionalità di Schemi Workspace, consulta la sezione Schemi panoramica di workspace.