Definire i campi XDM nell'interfaccia utente

La Schema Editor nell'interfaccia utente di Adobe Experience Platform consente di definire i propri campi all'interno delle classi e dei mixin personalizzati di Experience Data Model (XDM). Questa guida illustra i passaggi necessari per definire i campi XDM nell'interfaccia utente, incluse le opzioni di configurazione disponibili per ciascun tipo di campo.

Prerequisiti

Questa guida richiede una buona conoscenza del sistema XDM. Fare riferimento alla Panoramica XDM per un'introduzione al ruolo di XDM nell'ecosistema Experience Platform, e alle nozioni di base della composizione dello schema per scoprire in che modo classi e mixin 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 dimestichezza con le diverse funzionalità di Schema Editor.

Selezionare una risorsa per aggiungere campi a

Per definire nuovi campi XDM nell'interfaccia utente, è innanzitutto necessario 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, utilizzate la barra a sinistra per selezionare la classe o il mixin per il quale desiderate definire i campi. Se la risorsa è una risorsa personalizzata definita dall'organizzazione, nell'area di lavoro sono visualizzati i controlli per l'aggiunta o la modifica dei campi. Tali controlli vengono visualizzati accanto al nome dello schema, nonché a tutti i campi del tipo di oggetto definiti nella classe o nel mixin selezionato.

NOTA

Se la classe o il mixin selezionato è una risorsa di base fornita da Adobe, non può essere modificato e quindi i controlli riportati sopra non verranno visualizzati. Se lo schema a cui si desidera aggiungere i campi è basato su una classe XDM di base e non contiene mixin personalizzati, è possibile creare un nuovo mixin da aggiungere allo schema.

Per aggiungere un nuovo campo alla risorsa, selezionare l'icona più (+) accanto al nome dello schema nel quadro oppure 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 New field, situato all'interno di un oggetto a livello principale che viene associato all'ID tenant univoco (come _tenantId nell'esempio seguente). Tutti i campi aggiunti a uno schema tramite classi e mixin personalizzati vengono inseriti automaticamente all'interno di questo spazio nomi per evitare conflitti con altri campi da classi e mixin forniti dal Adobe.

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

Proprietà field Descrizione
Field name Un nome univoco e descrittivo per il campo. Il nome del campo non può essere modificato dopo il salvataggio dello schema.

Il nome deve essere scritto idealmente in camelCase. Può contenere caratteri alfanumerici, trattini o caratteri di sottolineatura, ma non può iniziare con un carattere di sottolineatura.
  • Corretto: fieldName
  • Accettabile: field_name2, Field-Name, field-name_3
  • Scorretto: _fieldName
Display name Un nome descrittivo per il campo.
Type Il tipo di dati che il campo conterrà. Da questo menu a discesa, è possibile selezionare uno dei tipi scalari standard supportati da XDM, o uno dei tipi di dati multi-campo precedentemente definiti in Schema Registry.

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

È inoltre possibile fornire al campo un Description leggibile dall'utente opzionale per fornire un contesto più ampio in merito al caso di utilizzo previsto per il campo.

NOTA

A seconda della Type selezionata per il campo, nella barra a destra potrebbero essere visualizzati controlli di configurazione aggiuntivi. Per ulteriori informazioni su questi controlli, vedere la sezione relativa alle proprietà del campo specifiche del tipo.

La barra a destra include anche le caselle di controllo per la designazione di tipi di campi speciali. Per ulteriori informazioni, vedere la sezione relativa ai tipi di campo speciali.

Dopo aver configurato il campo, selezionare Apply.

Il quadro viene aggiornato per mostrare il nome e il tipo del campo, mentre la barra a destra elenca il percorso del campo oltre alle altre proprietà.

È possibile continuare a seguire i passaggi descritti sopra per aggiungere altri campi allo schema. Una volta salvato lo schema, vengono salvati anche la relativa classe di base e i mixin, se sono state apportate modifiche.

NOTA

Eventuali modifiche apportate ai mixin o alla classe di uno schema si rifletteranno su tutti gli altri schemi che li utilizzano.

Proprietà dei campi specifici per il tipo

Durante la definizione di un nuovo campo, nella barra a destra possono essere visualizzate opzioni di configurazione aggiuntive, a seconda della Type scelta per il campo. Nella tabella seguente sono illustrate le proprietà aggiuntive dei campi insieme ai tipi compatibili:

Proprietà field Tipi compatibili Descrizione
Default value String, Double, Long, Integer, Short, Byte, Boolean Un valore predefinito che verrà assegnato a questo campo se durante l'assimilazione non viene fornito nessun altro valore. Questo valore deve essere conforme al tipo selezionato del campo.
Pattern String Un' espressione regolare a cui il valore di questo campo deve essere conforme per essere accettato durante l'assimilazione.
Format String Selezionare da un elenco di formati predefiniti per le stringhe a cui il valore deve essere conforme. I formati disponibili includono:
Minimum length String Il numero minimo di caratteri che la stringa deve contenere affinché il valore venga accettato durante l'assimilazione.
Maximum length String Il numero massimo di caratteri che la stringa deve contenere affinché il valore venga accettato durante l'assimilazione.
Minimum value Double Il valore minimo per il valore Double da accettare durante l'assimilazione. Se il valore assimilato corrisponde esattamente a quello immesso qui, il valore viene accettato. Quando si utilizza questo vincolo, il vincolo "Exclusive minimum value" deve essere lasciato vuoto.
Maximum value Double Il valore massimo per il valore Double da accettare durante l'assimilazione. Se il valore assimilato corrisponde esattamente a quello immesso qui, il valore viene accettato. Quando si utilizza questo vincolo, il vincolo "Exclusive maximum value" deve essere lasciato vuoto.
Exclusive minimum value Double Il valore massimo per il valore Double da accettare durante l'assimilazione. Se il valore assimilato corrisponde esattamente a quello immesso qui, il valore viene rifiutato. Quando si utilizza questo vincolo, il vincolo "Minimum value" (non esclusivo) deve essere lasciato vuoto.
Exclusive maximum value Double Il valore massimo per il valore Double da accettare durante l'assimilazione. Se il valore assimilato corrisponde esattamente a quello immesso qui, il valore viene rifiutato. Quando si utilizza questo vincolo, il vincolo "Maximum value" (non esclusivo) deve essere lasciato vuoto.

Tipi di campi speciali

Nella barra a destra sono disponibili diverse caselle di controllo per la designazione di ruoli speciali per il campo selezionato. I casi di utilizzo per alcune di queste opzioni comportano importanti considerazioni sulla strategia di modellazione dei dati e sulle modalità di utilizzo dei 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 consultare la guida sulla definizione di campi di tipo oggetto per ulteriori informazioni sulla definizione di sottomoduli nidificati in caso di struttura dello schema.

Passaggi successivi

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

Per ulteriori informazioni sulle funzionalità dell'area di lavoro Schemas, vedere la panoramica dell'area di lavoro Schemas.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free