Definire i campi XDM nell’interfaccia utente
Schema Editor nell'interfaccia utente di Adobe Experience Platform consente di definire campi personalizzati all'interno di classi e gruppi di campi di schema di Experience Data Model (XDM) personalizzati. 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. Per un'introduzione al ruolo di XDM nell'ecosistema Experience Platform e alle nozioni di base sulla composizione dello schema, consulta la panoramica di XDM per scoprire come le classi e i gruppi di campi contribuiscono ai campi degli schemi XDM.
Sebbene non sia necessario per questa guida, è consigliabile seguire l'esercitazione su composizione di uno schema nell'interfaccia utente per acquisire familiarità con le varie funzionalità di 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, puoi scegliere di creare un nuovo schema o selezionare uno schema esistente da modificare.
Una volta aperto Schema Editor, 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 l'icona più (+) accanto al nome dello schema nell'area di lavoro oppure 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 l'icona più (+), nell'area di lavoro verrà visualizzato un segnaposto per il campo senza titolo .
Nella barra a destra sotto Proprietà campo, puoi 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 inizia con un trattino basso.
- Corretto:
fieldName - Accettabile:
field_name2,Field-Name,field-name_3 - Errato:
_fieldName
Nota: se selezioni il tipo di dati Mappa, viene visualizzata la proprietà Tipo di valore mappa.
È inoltre possibile selezionare Ricerca avanzata dei tipi per cercare e filtrare i tipi di dati esistenti e individuare più facilmente il tipo desiderato.
Per ulteriori informazioni sulle proprietà di campo specifiche per il tipo, vedere la panoramica sulla definizione dei campi.
Puoi anche scegliere di fornire una descrizione e delle note per ciascun campo. Utilizza il campo 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, selezionare Applica.
L'area di lavoro si aggiorna per mostrare il campo appena aggiunto, che si trova all'interno di un oggetto con spazio dei nomi assegnato all'ID tenant univoco (mostrato 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 del Tipo scelto 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 tipo di dati 'Complex'. Impossibile creare tipi di dati 'Complex' 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 consultare la guida definizione dei campi del tipo di 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à dell'area di lavoro Schemi, vedere la panoramica dell'area di lavoro Schemi.