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 :headding-anchor: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.

Editor di schema con le icone di aggiunta evidenziate.

WARNING
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. Per ulteriori informazioni, consulta la sezione su aggiunta di campi ai gruppi di campi standard nella guida dell'interfaccia utente degli schemi.

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.

Editor di schema con unicona di aggiunta evidenziata.

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 :headding-anchor:define

Dopo aver selezionato l'icona più (+), nell'area di lavoro verrà visualizzato un segnaposto per il campo senza titolo .

Editor schema con un nuovo campo senza titolo evidenziato.

Nella barra a destra sotto Proprietà campo, puoi 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 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 l'interruttore nome visualizzato.
Tipo
Tipo di dati che il campo conterrà. Da questo menu a discesa puoi selezionare uno dei tipi scalari standard supportati da XDM oppure uno dei tipi di dati a più campi precedentemente definiti in Schema Registry.
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.
Tipo di valore mappa
Questo valore è necessario se si seleziona Mappa come tipo di dati per il campo. I valori disponibili per la mappa sono String e Integer. Seleziona un valore dall’elenco a discesa delle opzioni disponibili.
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. |

NOTE
A seconda del Tipo selezionato per il campo, nella barra a destra potrebbero essere visualizzati ulteriori controlli di configurazione. Per ulteriori informazioni su questi controlli, vedere la sezione relativa alle proprietà del campo specifiche per il tipo.
La barra a destra fornisce anche delle caselle di controllo per designare tipi di campo speciali. Per ulteriori informazioni, vedere la sezione relativa ai tipi di campi speciali.

Al termine della configurazione del campo, selezionare Applica.

La sezione Proprietà campo dellEditor schema è evidenziata.

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à.

È evidenziato un nuovo campo nel diagramma schema e il percorso corrispondente nella sezione Proprietà campo.

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.

NOTE
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 :headding-anchor: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:

Field, proprietà
Tipi compatibili
Descrizione
Tipo di valore mappa
Mappa
La proprietà Tipo di valore mappa viene visualizzata nell'interfaccia utente solo se si seleziona il valore Mappa dalle opzioni a discesa Tipo. Puoi scegliere tra i tipi di valore Stringa e Intero per la Mappa.
Editor schemi con i campi Tipo e Tipo di valore mappa evidenziati. {width="100" modal="regular"}
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.
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
espressione regolare a cui il valore di questo campo deve conformarsi 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, il vincolo "Exclusive minimum value" 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, 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 campo speciali :headding-anchor: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.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07