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

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.

AVVERTENZA

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

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

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:

Field, proprietà Descrizione
Nome campo 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
Nome visualizzato Nome visualizzato per il campo. Questo è il nome che verrà utilizzato per rappresentare il campo nell’area di lavoro dell’Editor di schema. Il nome del campo può essere modificato in nome visualizzato utilizzando interruttore nome visualizzato.
Tipo 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 più campi tipi di dati che sono stati precedentemente definiti in Schema Registry.

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

È inoltre possibile fornire un'opzione di Descrizione al campo per fornire più contesto in merito al caso d’uso previsto del campo.

NOTA

A seconda della Tipo se hai selezionato il campo, nella barra a destra potrebbero essere visualizzati ulteriori controlli di configurazione. Consulta 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 designare tipi di campo speciali. Consulta la sezione su tipi di campo speciali per ulteriori informazioni.

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.

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à del campo specifiche del tipo

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:

Field, proprietà Tipi compatibili Descrizione
Valore predefinito Stringa, Doppio, Lungo, Intero, Breve, Byte, Booleano Valore predefinito assegnato a questo campo se non viene fornito alcun altro valore durante l’acquisizione. Questo valore deve essere conforme al tipo selezionato del campo.

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.
Pattern Stringa A espressione regolare che il valore di questo campo deve essere conforme a per essere accettato durante l’acquisizione.
Formato Stringa Seleziona da un elenco di formati predefiniti per le stringhe a cui il valore deve essere conforme. I formati disponibili includono:
Lunghezza minima Stringa Numero minimo di caratteri che la stringa deve contenere per consentire l’accettazione del valore durante l’acquisizione.
Lunghezza massima Stringa Numero massimo di caratteri che la stringa deve contenere per consentire l’accettazione del valore 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, il valore viene accettato. Quando si utilizza questo vincolo, la proprietà "Valore minimo esclusivoIl 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, il valore viene accettato. Quando si utilizza questo vincolo, la proprietà "Valore massimo esclusivoIl 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, la proprietà "Valore minimo"Il vincolo (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, la proprietà "Valore massimo"Il vincolo (non esclusivo) deve essere lasciato vuoto.

Tipi di campo speciali

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.

In questa pagina