Documentatie Experience Platform Handleiding voor Experience Data Model (XDM)

Beperkingen voor XDM-veldtypen

Laatst bijgewerkt: 31 maart 2025

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 schemacompositievoor 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 Schemabegint 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 UIleren hoe te om beperkingen op gebieden uit te voeren die u binnen de groepen van het douanegebied en gegevenstypes bepaalt.

Basisstructuur en voorbeelden

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 gidsvoor meer informatie over Schema JSON en andere onderliggende technologieën in 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.6in 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:

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

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 douanekaartbepalen 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

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

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

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

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 Schemavoor meer informatie.

recommendation-more-help