Begrenzungen für XDM-Feldtypen

Letzte Aktualisierung: 5. Mai 2025
  • Themen:

Erstellt für:

  • Entwickler

In Experience-Datenmodell (XDM)-Schemata schränkt der Typ eines Felds ein, welche Art von Daten das Feld enthalten kann. Dieses Dokument bietet einen Überblick über jeden Kernfeldtyp, einschließlich der anderen Serialisierungsformate, denen sie zugeordnet werden können, und wie Sie Ihre eigenen Feldtypen in der API definieren, um verschiedene Einschränkungen durchzusetzen.

Erste Schritte

Bevor Sie dieses Handbuch verwenden, lesen Sie die Grundlagen der Schemakomposition für eine Einführung in XDM-Schemata, Klassen und Schemafeldgruppen.

Wenn Sie Ihre eigenen Feldtypen in der API definieren möchten, wird dringend empfohlen, mit dem Entwicklerhandbuch zur Schemaregistrierung zu beginnen, um zu erfahren, wie Sie Feldergruppen und Datentypen erstellen, um Ihre benutzerdefinierten Felder in einzuschließen. Wenn Sie die Experience Platform-Benutzeroberfläche zum Erstellen Ihrer Schemata verwenden, erfahren Sie im Handbuch unter Definieren von Feldern in der Benutzeroberfläche , wie Sie Einschränkungen für Felder implementieren, die Sie in benutzerdefinierten Feldergruppen und Datentypen definieren.

Basisstruktur und Beispiele

XDM basiert auf dem JSON-Schema und daher übernehmen XDM-Felder beim Definieren ihres Typs eine ähnliche Syntax. Wenn Sie verstehen, wie verschiedene Feldtypen im JSON-Schema dargestellt werden, können Sie die grundlegenden Einschränkungen jedes Typs angeben. Bei benutzerdefinierten Feldnamen wird nicht zwischen Groß- und Kleinschreibung unterschieden und sie müssen unterschiedliche Namen auf derselben Ebene in Ihrem Schema haben.

NOTE
Weitere Informationen zu JSONSchemas und anderen zugrunde liegenden Technologien in Experience Platform-APIs findenim Handbuch zu den API-Grundlagen .

In der folgenden Tabelle wird beschrieben, wie jeder XDM-Typ im JSON-Schema dargestellt wird, zusammen mit einem Beispielwert, der dem Typ entspricht:

XDM-TypJSON-SchemaBeispiel
String 
{„type“: „string“}
"Platinum"
-Nummer 
{type}: „number“}
12925.49
Long 
{
  „type“: „integer“,
  „maximum“: 9007199254740991,
  „minimum“: -9007199254740991
}
1478108935
Ganzzahl 
{
  „type“: „integer“,
  „maximum“: 2147483648,
  „minimum“: -2147483648
}
24906290
short 
{
  „type“: „integer“,
  „maximum“: 32768,
  „minimum“: -32768
}
15781
Byte 
{
  „type“: „integer“,
  „Maximum“: 128,
  „minimum“: -128
}
90
Datum* 
{
  „type“: „string“,
  „format“: „date“
}
"2019-05-15"
DateTime* 
{
  „type“: „string“,
  „format“: „date-time“
}
"2019-05-15T20:20:39+00:00"
Boolesch 
{„type“: „boolean“}
true

*Alle datumsformatierten Zeichenfolgen müssen dem ISO 8601-Standard entsprechen (RFC 3339, Abschnitt 5.6).

Zuordnen von XDM-Typen zu anderen Formaten

In den folgenden Abschnitten wird beschrieben, wie jeder XDM-Typ anderen gängigen Serialisierungsformaten zugeordnet wird:

NOTE
Unter den in den folgenden Tabellen aufgelisteten Standard-XDM-Typen ist auch ​ Typ ​Map“ enthalten. Zuordnungen werden in Standardschemata verwendet, wenn Daten als Schlüssel dargestellt werden, die bestimmten Werten zugeordnet sind, oder wenn Schlüssel nicht sinnvoll in ein statisches Schema aufgenommen werden können und als Datenwerte behandelt werden müssen.
Viele standardmäßige XDM-Komponenten verwenden Zuordnungstypen und Sie können bei auch benutzerdefinierte Zuordnungsfelder. Die Aufnahme des Zuordnungstyps in die folgenden Tabellen soll Ihnen dabei helfen, zu bestimmen, wie Sie Ihre vorhandenen Daten XDM zuordnen, wenn sie derzeit in einem der unten aufgeführten Formate gespeichert sind.

Parquet, Spark SQL und Java

XDM-TypParquetSpark SQLJava
StringTyp: BYTE_ARRAY
Anmerkung: UTF8		StringTypejava.lang.String
ZahlTyp: DOUBLELongTypejava.lang.Double
LangTyp: INT64LongTypejava.lang.Long
IntegerTyp: INT32
Anmerkung: INT_32		IntegerTypejava.lang.Integer
kurzTyp: INT32
Anmerkung: INT_16		ShortTypejava.lang.Short
ByteTyp: INT32
Anmerkung: INT_8		ByteTypejava.lang.Short
DatumTyp: INT32
Anmerkung: DATE		DateTypejava.util.Date
DateTimeTyp: INT64
Anmerkung: TIMESTAMP_MILLIS		TimestampTypejava.util.Date
BooleschTyp: BOOLEANBooleanTypejava.lang.Boolean
LandkarteGruppe mit MAP Anmerkungen

(<key-type> muss STRING sein)		MapType

(keyType muss StringType sein)		java.util.Map