Definire i campi XDM nell’interfaccia utente

L’ Schema Editor nell’interfaccia utente di Adobe Experience Platform ti consente di definire campi personalizzati all’interno delle classi Experience Data Model (XDM) personalizzate e dei gruppi di campi dello schema. Questa guida descrive i passaggi per la definizione dei campi XDM nell’interfaccia utente, incluse le opzioni di configurazione disponibili per ciascun tipo di campo.

Prerequisiti

Questa guida richiede una buona comprensione del sistema XDM. Per un'introduzione al ruolo di XDM all'interno dell'ecosistema Experience Platform, fai riferimento alla panoramica XDM e alle nozioni di base sulla composizione dello schema per scoprire in che modo classi e gruppi di campi contribuiscono ai campi degli schemi XDM.

Sebbene non sia richiesto per questa guida, si consiglia anche di seguire l'esercitazione su composizione di uno schema nell'interfaccia utente per acquisire familiarità con le varie funzionalità di Schema Editor.

Seleziona una risorsa per aggiungere campi a

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 creare un nuovo schema o selezionare uno schema esistente da modificare.

Una volta aperta la Schema Editor, utilizza la barra a sinistra per selezionare la classe o il gruppo di campi per cui desideri definire i campi. Se la risorsa è una risorsa personalizzata definita dall’organizzazione, i controlli per aggiungere o modificare i campi vengono visualizzati nell’area di lavoro. Tali controlli vengono visualizzati accanto al nome dello schema, nonché a tutti i campi di tipo oggetto definiti nella classe o nel gruppo di campi selezionati.

NOTA

Se la classe o il gruppo di campi selezionato è una risorsa di base fornita dall’Adobe, non può essere modificata e pertanto i controlli mostrati sopra non verranno visualizzati. Se lo schema a cui si desidera aggiungere i campi si basa su una classe XDM principale e non contiene gruppi di campi personalizzati, è possibile creare un nuovo gruppo di campi da aggiungere allo schema.

Per aggiungere un nuovo campo alla risorsa, seleziona l’icona più (+) accanto al nome dello schema nell’area di lavoro o accanto al campo del tipo di oggetto in cui si desidera definire il campo.

Definire un campo per una risorsa

Dopo aver selezionato l'icona più (+), nell'area di lavoro viene visualizzato un Nuovo campo, situato all'interno di un oggetto a livello di radice con namespace nell'ID tenant univoco (mostrato come _tenantId nell'esempio seguente). Tutti i campi aggiunti a uno schema tramite classi e gruppi di campi personalizzati vengono inseriti automaticamente in questo spazio dei nomi per evitare conflitti con altri campi delle classi e dei gruppi di campi forniti da Adobi.

Nella barra a destra in Proprietà campo, puoi configurare i dettagli dei nuovi campi. Per ogni campo sono necessarie le seguenti informazioni:

Proprietà campo Descrizione
Nome campo Nome descrittivo univoco del campo. Il nome del campo non può essere modificato dopo il salvataggio dello schema.

Il nome dovrebbe idealmente essere scritto in camelCase. Può contenere caratteri alfanumerici, trattini o caratteri di sottolineatura, ma potrebbe non essere iniziare con un trattino basso.
  • Corretto: fieldName
  • Accettabile: field_name2, Field-Name, field-name_3
  • Errato: _fieldName
Nome visualizzato Un nome descrittivo per il campo.
Tipo Il tipo di dati che il campo conterrà. Da questo menu a discesa, è possibile selezionare uno dei tipi scalari standard supportati da XDM oppure uno dei tipi di dati a3/> a più campi definiti in precedenza in Schema Registry.

È inoltre possibile selezionare Ricerca tipo avanzata per cercare e filtrare i tipi di dati esistenti e individuare più facilmente il tipo desiderato.

È inoltre possibile fornire al campo una Descrizione leggibile da un utente opzionale per fornire più contesto riguardo al caso d’uso previsto del campo.

NOTA

A seconda del Tipo selezionato per il campo, nella barra a destra possono essere visualizzati controlli di configurazione aggiuntivi. Per ulteriori informazioni su questi controlli, consulta la sezione sulle proprietà del campo specifiche per i tipi .

La barra a destra fornisce anche delle caselle di controllo per la designazione di tipi di campi speciali. Per ulteriori informazioni, consulta la sezione sui tipi di campi speciali .

Al termine della configurazione del campo, seleziona Applica.

L’area di lavoro viene aggiornata in modo da visualizzare il nome e il tipo del campo. Nella barra a destra viene ora visualizzato il percorso del campo oltre alle altre proprietà.

Puoi continuare a seguire i passaggi descritti sopra per aggiungere altri campi allo schema. Una volta salvato lo schema, vengono salvati anche i relativi gruppi di campi e classi di base, se sono state apportate modifiche.

NOTA

Eventuali modifiche apportate ai gruppi di campi o alla classe di uno schema verranno applicate a tutti gli altri schemi che li utilizzano.

Proprietà dei campi specifiche per il tipo

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 le proprietà aggiuntive dei campi insieme ai relativi tipi compatibili:

Proprietà campo Tipi compatibili Descrizione
Valore predefinito Stringa, Doppio, Lungo, Intero, Breve, Byte, Booleano Un valore predefinito che verrà assegnato a questo campo se durante l’acquisizione non viene fornito alcun altro valore. Questo valore deve essere conforme al tipo selezionato del campo.
Pattern Stringa Un' espressione regolare a cui il valore di questo campo deve essere conforme per essere accettato durante l'acquisizione.
Formato Stringa Selezionare da un elenco di formati predefiniti per le stringhe a cui il valore deve essere conforme. I formati disponibili sono:
Lunghezza minima Stringa Il numero minimo di caratteri che la stringa deve contenere affinché il valore possa essere accettato durante l’acquisizione.
Lunghezza massima Stringa Il numero massimo di caratteri che la stringa deve contenere affinché il valore possa essere accettato durante l’acquisizione.
Valore minimo Doppio Il valore minimo per il valore Double da accettare durante l’acquisizione. Se il valore acquisito corrisponde esattamente a quello inserito qui, viene accettato il valore . Quando si utilizza questo vincolo, il vincolo "Valore minimo esclusivo" deve essere lasciato vuoto.
Valore massimo Doppio Il valore massimo per il valore Double da accettare durante l’acquisizione. Se il valore acquisito corrisponde esattamente a quello inserito qui, viene accettato il valore . Quando si utilizza questo vincolo, il vincolo "Valore massimo esclusivo" deve essere lasciato vuoto.
Valore minimo esclusivo Doppio Il valore massimo per il valore Double da accettare durante l’acquisizione. Se il valore acquisito corrisponde esattamente a quello inserito qui, il valore viene rifiutato. Quando si utilizza questo vincolo, il vincolo "Valore minimo" (non esclusivo) deve essere lasciato vuoto.
Valore massimo esclusivo Doppio Il valore massimo per il valore Double da accettare durante l’acquisizione. Se il valore acquisito corrisponde esattamente a quello inserito qui, il valore viene rifiutato. Quando si utilizza questo vincolo, il vincolo "Valore massimo" (non esclusivo) deve essere lasciato vuoto.

Tipi di campi speciali

La barra a destra fornisce diverse caselle di controllo per la designazione di ruoli speciali per il campo selezionato. I casi di utilizzo per alcune di queste opzioni richiedono considerazioni importanti sulla strategia di modellazione dei dati e su come si intende utilizzare i servizi della piattaforma a valle.

Per ulteriori informazioni su questi tipi speciali, consulta la seguente documentazione:

Sebbene tecnicamente non sia un tipo di campo speciale, si consiglia anche di visitare la guida sulla definizione dei campi di tipo oggetto per ulteriori informazioni sulla definizione dei campi secondari nidificati nelle strutture dello schema.

Passaggi successivi

Questa guida fornisce una panoramica sulla definizione dei campi XDM nell’interfaccia utente. Tenere presente che i campi possono essere aggiunti solo agli schemi tramite l’uso di classi e gruppi di campi. Per ulteriori informazioni su come gestire queste risorse nell'interfaccia utente, consulta le guide per la creazione e la modifica di classi e gruppi di campi.

Per ulteriori informazioni sulle funzionalità dell'area di lavoro Schemi, consulta la panoramica dell'area di lavoro Schemi.

In questa pagina