Syntaxe de l’espace de noms
Les sections suivantes montrent comment les espaces de noms sont attribués dans la syntaxe XDM.
XDM standard
La syntaxe XDM standard fournit à insight la manière dont les espaces de noms sont représentés dans les schémas (y compris leur traduction dans Adobe Experience Platform).
Le XDM standard utilise la syntaxe JSON-LD pour affecter des espaces de noms aux champs. Cet espace de noms se présente sous la forme d’un URI (comme https://ns.adobe.com/xdm
pour l’espace de noms xdm
) ou d’un préfixe abrégé configuré dans l’attribut @context
d’un schéma.
Voici un exemple de schéma pour un produit dans la syntaxe XDM standard. À l’exception de @id
(l’identifiant unique tel que défini par la spécification JSON-LD ), chaque champ sous properties
commence par un espace de noms et se termine par le nom du champ. Si vous utilisez un préfixe court défini sous @context
, l’espace de noms et le nom du champ sont séparés par le caractère deux-points (:
). Si vous n’utilisez pas de préfixe, l’espace de noms et le nom du champ sont séparés par une barre oblique (/
).
{
"$id": "https://ns.adobe.com/xdm/schemas/mySchema",
"title": "Product",
"description": "Represents the definition of a Project",
"@context": {
"xdm": "https://ns.adobe.com/xdm",
"repo": "http://ns.adobe.com/adobecloud/core/1.0/",
"schema": "http://schema.org",
"tenantId": "https://ns.adobe.com/tenantId"
},
"properties": {
"@id": {
"type": "string"
},
"xdm:sku": {
"type": "string"
},
"xdm:name": {
"type": "string"
},
"repo:createdDate": {
"type": "string",
"format": "datetime"
},
"https://ns.adobe.com/xdm/channels/application": {
"type": "string"
},
"schema:latitude": {
"type": "number"
},
"https://ns.adobe.com/vendorA/product/stockNumber": {
"type": "string"
},
"tenantId:internalSku": {
"type": "number"
}
}
}
Propriété | Description |
---|---|
@context | Objet définissant les préfixes courts qui peuvent être utilisés au lieu d’un URI d’espace de noms complet sous properties . |
@id | Identifiant unique de l’enregistrement tel que défini par la spécification JSON-LD. |
xdm:sku | Exemple de champ qui utilise un préfixe court pour indiquer un espace de noms. Dans ce cas, xdm est l’espace de noms (https://ns.adobe.com/xdm ) et sku est le nom du champ. |
https://ns.adobe.com/xdm/channels/application | Exemple de champ qui utilise l’URI d’espace de noms complet. Dans ce cas, https://ns.adobe.com/xdm/channels est l’espace de noms et application est le nom du champ. |
https://ns.adobe.com/vendorA/product/stockNumber | Les champs fournis par les ressources fournisseur utilisent leurs propres espaces de noms uniques. Dans cet exemple, https://ns.adobe.com/vendorA/product est l’espace de noms du fournisseur et stockNumber est le nom du champ. |
tenantId:internalSku | Les champs définis par votre organisation utilisent votre identifiant client unique comme espace de noms. Dans cet exemple, tenantId est l’espace de noms du client (https://ns.adobe.com/tenantId ) et internalSku est le nom du champ. |