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 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.
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.
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 define
Dopo aver selezionato l’icona più (+), nell’area di lavoro verrà visualizzato un segnaposto Untitled field.
Nella barra a destra sotto Field properties, puoi configurare i dettagli del nuovo campo. Per ogni campo sono necessarie le seguenti informazioni:
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 o trattini bassi, ma non può iniziare con un trattino basso.
- Corretto:
fieldName - Accettabile:
field_name2,fieldName_3 - Errato:
_fieldName
Nota: se selezioni il tipo di dati Mappa, viene visualizzata la proprietà Map value type.
È inoltre possibile selezionare Advanced type search per cercare e filtrare i tipi di dati esistenti e individuare più facilmente il tipo desiderato.
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. Utilizzare il campo Description 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. |
Al termine della configurazione del campo, selezionare Apply.
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 provenienti da classi e gruppi di campi forniti da 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.
Proprietà del campo specifiche del tipo type-specific-properties
Quando definisci un nuovo campo, nella barra a destra possono essere visualizzate opzioni di configurazione aggiuntive a seconda di Type scelto per il campo. La tabella seguente illustra queste proprietà di campo aggiuntive con i relativi tipi compatibili.
Proprietà come Pattern, Format e la lunghezza o i limiti numerici vengono applicati durante l’acquisizione se configurati. Default value è diverso: registra i metadati dello schema informativo e non convalida né popola i dati acquisiti. Vedere la riga Default value seguente e la nota che segue la tabella.
Nota: tutti i tipi di dati mappa creati tramite l’API che non sono di tipo Stringa o Intero vengono visualizzati come tipo di dati ‘Complex’. Impossibile creare tipi di dati ‘Complex’ tramite l’interfaccia utente.
Seleziona da un elenco di formati predefiniti per le stringhe a cui il valore deve essere conforme. I formati disponibili includono:
default (ad esempio String e Boolean)default dello schema JSON e memorizzati nella definizione dello schema. Il valore configurato non viene applicato automaticamente durante l’acquisizione o i flussi di preparazione dati. I campi omessi rimangono assenti a meno che non vengano esplicitamente mappati o trasformati nel flusso di dati. Vedi definizione dei campi obbligatori.Tipi di campo speciali 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 Experience 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 Schemas, vedere la panoramica dell’area di lavoro Schemas.