Documentación Experience Platform Guía del Modelo de datos de experiencia (XDM)

Restricciones de tipo de campo XDM

Last update: Thu Nov 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:

Creado para:

Desarrollador

En esquemas XDM (Experience Data Model), el tipo de campo restringe el tipo de datos que puede contener el campo. Este documento proporciona información general de cada tipo de campo principal, incluidos los demás formatos de serialización a los que se pueden asignar y cómo definir sus propios tipos de campo en la API para aplicar diferentes restricciones.

Introducción

Antes de usar esta guía, revise los conceptos básicos de la composición de esquemas para obtener una introducción a los esquemas XDM, las clases y los grupos de campos de esquema.

Si planea definir sus propios tipos de campo en la API, se recomienda comenzar con la Guía para desarrolladores de Schema Registry para aprender a crear grupos de campos y tipos de datos para incluir sus campos personalizados en. Si está usando la interfaz de usuario de Experience Platform para crear los esquemas, consulte la guía sobre definición de campos en la interfaz de usuario para obtener información sobre cómo implementar restricciones en campos que defina dentro de grupos de campos personalizados y tipos de datos.

Estructura base y ejemplos basic-types

XDM se basa en el esquema JSON y, por lo tanto, los campos XDM heredan una sintaxis similar al definir su tipo. Comprender cómo se representan los distintos tipos de campo en el esquema JSON puede ayudar a indicar las restricciones base de cada tipo. Los nombres de los campos personalizados no distinguen entre mayúsculas y minúsculas y deben tener nombres diferentes en el mismo nivel del esquema.

NOTE

Consulte la guía de aspectos básicos de la API para obtener más información sobre el esquema JSON y otras tecnologías subyacentes en las API de Experience Platform.

En la siguiente tabla se describe cómo se representa cada tipo XDM en el esquema JSON, junto con un valor de ejemplo que se ajusta al tipo:

Tipo de XDM

Esquema JSON

Ejemplo

String

{"type": "string"}

"Platinum"

Number

{"type": "number"}

12925.49

Long

{
  "tipo": "entero",
  "maximum": 9007199254740991,
  "mínimo": -9007199254740991
}

1478108935

Integer

{
  "tipo": "entero",
  "maximum": 2147483648,
  "mínimo": -2147483648
}

24906290

Short

{
  "tipo": "entero",
  "maximum": 32767,
  "mínimo": -32768
}

15781

Byte

{
  "tipo": "entero",
  "máximo": 128,
  mínimo: -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

*Todas las cadenas con formato de fecha deben cumplir con el estándar ISO 8601 (RFC 3339, sección 5.6).

Asignación de tipos XDM a otros formatos

Las secciones siguientes describen cómo cada tipo XDM se asigna a otros formatos de serialización comunes:

Parquet, Spark SQL y Java
Scala, .NET y CosmosDB
MongoDB, Aerospike y Protobuf 2

NOTE

Entre los tipos XDM estándar enumerados en las tablas siguientes, también se incluye el tipo Map. Los mapas se utilizan en esquemas estándar cuando los datos se representan como claves que se asignan a determinados valores o cuando las claves no se pueden incluir razonablemente en un esquema estático y deben tratarse como valores de datos.

Muchos componentes XDM estándar usan tipos de asignación, y también puede definir campos de asignación personalizados si lo desea. La inclusión del tipo de mapa en las tablas siguientes pretende ayudarle a determinar cómo asignar los datos existentes a XDM si actualmente están almacenados en cualquiera de los formatos enumerados a continuación.

Parquet, Spark SQL y Java parquet

Tipo de XDM

Parquet

Spark SQL

Java

String

Tipo: BYTE_ARRAY
Anotación: UTF8

StringType

java.lang.String

Number

Tipo: DOUBLE

LongType

java.lang.Double

Long

Tipo: INT64

LongType

java.lang.Long

Integer

Tipo: INT32
Anotación: INT_32

IntegerType

java.lang.Integer

Short

Tipo: INT32
Anotación: INT_16

ShortType

java.lang.Short

Byte

Tipo: INT32
Anotación: INT_8

ByteType

java.lang.Short

Date

Tipo: INT32
Anotación: DATE

DateType

java.util.Date

DateTime

Tipo: INT64
Anotación: TIMESTAMP_MILLIS

TimestampType

java.util.Date

Boolean

Tipo: BOOLEAN

BooleanType

java.lang.Boolean

Map

MAP: el grupo

anotado (<key-type> debe ser STRING)

MapType

(keyType debe ser StringType)

java.util.Map

Scala, .NET y CosmosDB scala

Tipo de XDM

Scala

.NET

CosmosDB

String

String

System.String

String

Number

Double

System.Double

Number

Long

Long

System.Int64

Number

Integer

Int

System.Int32

Number

Short

Short

System.Int16

Number

Byte

Byte

System.SByte

Number

Date

java.util.Date

System.DateTime

String

DateTime

java.util.Date

System.DateTime

String

Boolean

Boolean

System.Boolean

Boolean

Map

Map

(N/D)

object

MongoDB, Aerospike y Protobuf 2 mongo

Tipo de XDM

MongoDB

Aerospike

Protobuf 2

String

string

String

string

Number

double

Double

double

Long

long

Integer

int64

Integer

int

Integer

int32

Short

int

Integer

int32

Byte

int

Integer

int32

Date

date

Integer
(milisegundos de Unix)

int64
(milisegundos de Unix)

DateTime

timestamp

Integer
(milisegundos de Unix)

int64
(milisegundos de Unix)

Boolean

bool

Integer
(binario 0/1)

bool

Map

object

map

map<key_type, value_type>

Definición de tipos de campo XDM en la API define-fields

La API de Registro de esquemas permite definir campos personalizados mediante el uso de formatos y restricciones opcionales. Consulte la guía definición de campos personalizados en la API del Registro de esquemas para obtener más información.

recommendation-more-help

62e9ffd9-1c74-4cef-8f47-0d00af32fc07