Definire i campi XDM nell’interfaccia utente

La Schema Editor nell’interfaccia utente di Adobe Experience Platform puoi 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. Fai riferimento a Panoramica di XDM 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 richiesto per questa guida, è consigliabile seguire anche l’esercitazione su composizione di uno schema nell’interfaccia utente per acquisire familiarità con le varie funzionalità del Schema Editor.

Selezionare una risorsa a cui aggiungere campi

Per definire nuovi campi XDM nell’interfaccia utente, devi prima aprire uno schema all’interno della Schema Editor. A seconda degli schemi attualmente disponibili nel Schema Library, puoi scegliere di creare un nuovo schema o selezionare uno schema esistente da modificare.

Una volta che hai Schema Editor aperti, 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.

AVVERTENZA

Se si tenta di aggiungere un campo a un oggetto fornito da un gruppo di campi standard, tale gruppo di campi verrà convertito in un gruppo di campi personalizzato e il gruppo di campi originale non sarà più disponibile. Vedi la sezione su aggiunta di campi ai gruppi di campi standard per ulteriori informazioni, consulta la guida dell’interfaccia utente di schemas .

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 si desidera definire il campo.

A seconda che si stia aggiungendo un campo direttamente a uno schema o ai relativi gruppi di campi e classi costituenti, i passaggi necessari per aggiungere il campo variano. Il resto del documento illustra come configurare le proprietà di un campo indipendentemente da dove 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 degli schemi:

Definire le proprietà di un campo

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

Nella barra a destra sotto Proprietà campo, puoi configurare i dettagli del nuovo campo. 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 non possono inizia con un carattere di sottolineatura.
  • 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, puoi selezionare uno dei tipi scalari standard supportato da XDM o da uno dei campi multipli tipi di dati definiti in precedenza nella Schema Registry.

Puoi anche selezionare Ricerca avanzata del tipo per cercare e filtrare i tipi di dati esistenti e individuare più facilmente il tipo desiderato.

È inoltre possibile fornire un'opzione leggibile dall'utente Descrizione al campo per fornire più contesto riguardo al caso d’uso previsto del campo.

NOTA

A seconda del Tipo selezionati per il campo, ulteriori controlli di configurazione possono essere visualizzati nella barra a destra. Vedi la sezione su proprietà del campo specifiche del tipo per ulteriori informazioni su questi controlli.

La barra a destra fornisce anche delle caselle di controllo per la designazione di tipi di campi speciali. Vedi la sezione su tipi di campi speciali per ulteriori informazioni.

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 della Tipo scegli 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, Lunga, 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 A espressione regolare che 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 valore "Valore minimo esclusivo" vincolo 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 valore "Valore massimo esclusivo" vincolo 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 valore "Valore minimo" (non esclusivo) il vincolo 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 valore "Valore massimo" (non esclusivo) il vincolo 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:

Anche se tecnicamente non è un tipo di campo speciale, si consiglia anche di visitare la guida su 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 classi e gruppi di campi.

Per ulteriori informazioni sulle funzionalità del Schemi area di lavoro, vedi Schemi panoramica dell'area di lavoro.

In questa pagina