DocumentatieExperience PlatformHandleiding voor Experience Data Model (XDM)

Beperkingen voor XDM-veldtypen

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

In schema's van het Model van Gegevens van de Ervaring (XDM), beperkt het type van een gebied welk soort gegevens het gebied kan bevatten. Dit document biedt een overzicht van elk kernveldtype, inclusief de andere serialisatie-indelingen waaraan ze kunnen worden toegewezen en hoe u uw eigen veldtypen in de API kunt definiëren om verschillende beperkingen af te dwingen.

Aan de slag

Alvorens deze gids te gebruiken, te herzien gelieve de ​ grondbeginselen van schemacompositie ​ voor een inleiding aan schema XDM, klassen, en groepen van het schemagebied.

Als u van plan bent om uw eigen gebiedstypes in API te bepalen, adviseert men sterk dat u met de ​ de ontwikkelaarsgids van de Registratie van het Schema ​ begint om te leren hoe te om gebiedsgroepen en gegevenstypes tot stand te brengen om uw douanegebieden in te omvatten. Als u Experience Platform UI gebruikt om uw schema's tot stand te brengen, zie de gids op ​ bepalende gebieden in UI ​ leren hoe te om beperkingen op gebieden uit te voeren die u binnen de groepen van het douanegebied en gegevenstypes bepaalt.

Basisstructuur en voorbeelden basic-types

XDM wordt gebouwd bovenop het Schema van JSON, en daarom erven de gebieden XDM een gelijkaardige syntaxis wanneer het bepalen van hun type. Begrijpen hoe de verschillende gebiedstypes in het Schema JSON worden vertegenwoordigd kan helpen op de basisbeperkingen van elk type wijzen. Namen van aangepaste velden zijn hoofdlettergevoelig en moeten verschillende namen hebben op hetzelfde niveau in het schema.

NOTE
Zie de ​ API grondbeginselen gids ​ voor meer informatie over Schema JSON en andere onderliggende technologieën in Experience Platform APIs.

In de volgende tabel wordt beschreven hoe elk XDM-type wordt vertegenwoordigd in JSON-schema, samen met een voorbeeldwaarde die overeenkomt met het type:

XDM-type
JSON Schema
Voorbeeld
String
{"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",
  "maximum": 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

*Alle datum-geformatteerde koorden moeten met ISO 8601 norm (​ RFC 3339, sectie 5.6 ​ in overeenstemming zijn).

XDM-typen toewijzen aan andere indelingen

In de onderstaande secties wordt beschreven hoe elk XDM-type wordt toegewezen aan andere algemene serialisatie-indelingen:

NOTE
Onder de standaard XDM-typen die in de onderstaande tabellen worden vermeld, wordt ook het Map -type opgenomen. Kaarten worden gebruikt in standaardschema's wanneer de gegevens als sleutels worden vertegenwoordigd die aan bepaalde waarden in kaart brengen, of waar de sleutels redelijkerwijs niet in een statisch schema kunnen worden omvat en als gegevenswaarden moeten worden behandeld.
Vele standaardXDM componenten gebruiken kaarttypes, en u kunt ook ​ gebieden van de douanekaart ​ bepalen indien gewenst. De opname van het kaarttype in de onderstaande tabellen is bedoeld om u te helpen bepalen hoe u uw bestaande gegevens kunt toewijzen aan XDM als deze momenteel zijn opgeslagen in een van de hieronder vermelde indelingen.

Parquet, Spark SQL en Java parquet

XDM-type
Parquet
Spark SQL
Java
String
Type: BYTE_ARRAY
annotatie: UTF8
StringType
java.lang.String
Number
Type: DOUBLE
LongType
java.lang.Double
Long
Type: INT64
LongType
java.lang.Long
Integer
Type: INT32
annotatie: INT_32
IntegerType
java.lang.Integer
Short
Type: INT32
annotatie: INT_16
ShortType
java.lang.Short
Byte
Type: INT32
annotatie: INT_8
ByteType
java.lang.Short
Date
Type: INT32
annotatie: DATE
DateType
java.util.Date
DateTime
Type: INT64
annotatie: TIMESTAMP_MILLIS
TimestampType
java.util.Date
Boolean
Type: BOOLEAN
BooleanType
java.lang.Boolean
Map
MAP -annoated group

(<key-type> moet STRING zijn)
MapType

(keyType must be StringType)
java.util.Map

Scala, .NET en CosmosDB scala

XDM-type
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.v.t.)
object

MongoDB, Aerospike en Protobuf 2 mongo

XDM-type
MongoDB
Aerospike
Protocol 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
(Unix milliseconds)
int64
(Unix milliseconds)
DateTime
timestamp
Integer
(Unix milliseconds)
int64
(Unix milliseconds)
Boolean
bool
Integer
(0/1 binair)
bool
Map
object
map
map<key_type, value_type>

XDM-veldtypen definiëren in de API define-fields

Met de API voor het schemaregister kunt u aangepaste velden definiëren met behulp van indelingen en optionele beperkingen. Zie de gids op ​ bepalend douanegebieden in de Registratie API van het Schema ​ voor meer informatie.

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