Vincoli del tipo di campo XDM

Ultimo aggiornamento: 4 aprile 2025
  • Argomenti:

Creato per:

  • Sviluppatore

Negli schemi Experience Data Model (XDM), il tipo di un campo limita il tipo di dati che il campo può contenere. Questo documento fornisce una panoramica di ogni tipo di campo principale, inclusi gli altri formati di serializzazione a cui possono essere mappati e come definire tipi di campo personalizzati nell’API per applicare vincoli diversi.

Introduzione

Prima di utilizzare questa guida, controlla le nozioni di base sulla composizione dello schema per un'introduzione a schemi, classi e gruppi di campi dello schema XDM.

Se prevedi di definire tipi di campo personalizzati nell'API, ti consigliamo vivamente di iniziare con la Guida per gli sviluppatori del registro dello schema per scoprire come creare gruppi di campi e tipi di dati per includere i campi personalizzati in. Se utilizzi l'interfaccia utente di Experience Platform per creare gli schemi, consulta la guida su definizione dei campi nell'interfaccia utente per scoprire come implementare i vincoli sui campi definiti all'interno dei gruppi di campi personalizzati e dei tipi di dati.

Struttura di base ed esempi

XDM è basato su schema JSON e pertanto i campi XDM ereditano una sintassi simile durante la definizione del relativo tipo. Informazioni sulla modalità di rappresentazione dei diversi tipi di campo nello schema JSON possono essere utili per indicare i vincoli di base di ciascun tipo. I nomi dei campi personalizzati non fanno distinzione tra maiuscole e minuscole e devono avere nomi diversi allo stesso livello nello schema.

NOTE
Per ulteriori informazioni sullo schema JSON e su altre tecnologie sottostanti nelle API di Experience Platform, consulta la guida sui concetti fondamentali delle API.

La tabella seguente illustra come ogni tipo XDM viene rappresentato nello schema JSON, insieme a un valore di esempio conforme al tipo:

Tipo XDMSchema JSONEsempio
Stringa 
{"type": "string"}
"Platinum"
Number 
{"type": "number"}
12925.49
Long 
{
  "type": "integer",
  "maximum": 9007199254740991,
  "minimum": -9007199254740991
}
1478108935
Integer 
{
  "type": "integer",
  "maximum": 2147483648,
  "minimum": -2147483648
}
24906290
Short 
{
  "type": "integer",
  "maximum": 32768,
  "minimum": -32768
}
15781
Byte 
{
  "type": "integer",
  "max": 128,
  "minimum": -128
}
90
Date* 
{
  "type": "string",
  "format": "date"
}
"2019-05-15"
DateTime* 
{
  "type": "string",
  "format": "date-time"
}
"2019-05-15T20:20:39+00:00"
Boolean 
{"type": "boolean"}
true

*Tutte le stringhe in formato data devono essere conformi allo standard ISO 8601 (RFC 3339, sezione 5.6).

Mappatura dei tipi XDM su altri formati

Le sezioni seguenti descrivono come ogni tipo XDM viene mappato su altri formati di serializzazione comuni:

NOTE
Tra i tipi XDM standard elencati nelle tabelle seguenti, è incluso anche il tipo Map. Le mappe vengono utilizzate negli schemi standard quando i dati sono rappresentati come chiavi che si associano a determinati valori, o quando le chiavi non possono essere ragionevolmente incluse in uno schema statico e devono essere trattate come valori di dati.
Molti componenti XDM standard utilizzano tipi di mappa e se necessario, puoi anche definire campi di mappa personalizzati. L’inclusione del tipo di mappa nelle tabelle seguenti è utile per determinare come mappare i dati esistenti su XDM se sono attualmente memorizzati in uno dei formati elencati di seguito.

Parquet, Spark SQL e Java

Tipo XDMParquetSpark SQLJava
StringaTipo: BYTE_ARRAY
Annotazione: UTF8		StringTypejava.lang.String
NumeroTipo: DOUBLELongTypejava.lang.Double
LungoTipo: INT64LongTypejava.lang.Long
Numero interoTipo: INT32
Annotazione: INT_32		IntegerTypejava.lang.Integer
BreveTipo: INT32
Annotazione: INT_16		ShortTypejava.lang.Short
ByteTipo: INT32
Annotazione: INT_8		ByteTypejava.lang.Short
DataTipo: INT32
Annotazione: DATE		DateTypejava.util.Date
DataOraTipo: INT64
Annotazione: TIMESTAMP_MILLIS		TimestampTypejava.util.Date
BooleanoTipo: BOOLEANBooleanTypejava.lang.Boolean
MappaGruppo con annotazioni MAP

(<key-type> deve essere STRING)		MapType

(keyType deve essere StringType)		java.util.Map