Naamruimte in XDM (Experience Data Model)

Aan alle velden in XDM-schema's (Experience Data Model) is een naamruimte gekoppeld. Deze namespaces staan u toe om uw schema's uit te breiden en gebiedsbotsingen te verhinderen aangezien de verschillende schemacomponenten samen worden gebracht. Dit document verstrekt een overzicht van namespaces in XDM en hoe zij in de ​ Registratie API van het Schema ​ worden vertegenwoordigd.

Met naamruimte kunt u een veld in één naamruimte definiëren als iets anders dan hetzelfde veld in een andere naamruimte. In de praktijk geeft de naamruimte van een veld aan wie het veld heeft gemaakt (bijvoorbeeld standaard-XDM (Adobe), een leverancier of uw organisatie).

Neem bijvoorbeeld een XDM-schema dat gebruikmaakt van de Personal Contact Details veldgroep ​ , die een standaard mobilePhone veld heeft dat in de xdm naamruimte bestaat. In het zelfde schema, bent u ook vrij om een afzonderlijk mobilePhone gebied onder een verschillende namespace (uw ​ huurder identiteitskaart ​) tot stand te brengen. Beide velden kunnen naast elkaar bestaan terwijl ze verschillende onderliggende betekenissen of beperkingen hebben.

Syntaxis naamruimte

In de volgende secties ziet u hoe naamruimten worden toegewezen in XDM-syntaxis.

Standaard XDM standard

De standaard syntaxis XDM verstrekt insight in hoe namespaces in schema's (met inbegrip van ​ worden vertegenwoordigd hoe zij in Adobe Experience Platform ​ worden vertaald).

Standaard XDM gebruikt ​ JSON-LD ​ syntaxis om namespaces aan gebieden toe te wijzen. Deze naamruimte wordt geleverd in de vorm van een URI (bijvoorbeeld https://ns.adobe.com/xdm voor de xdm naamruimte) of als een voorvoegsel dat wordt geconfigureerd in het @context -kenmerk van een schema.

Hier volgt een voorbeeldschema voor een product in de standaard XDM-syntaxis. Met uitzondering van @id (de unieke id zoals gedefinieerd door de JSON-LD-specificatie), begint elk veld onder properties met een naamruimte en eindigt het met de veldnaam. Als u een voorvoegsel gebruikt dat is gedefinieerd onder @context , worden de naamruimte en de veldnaam gescheiden door een dubbele punt ( : ). Als u geen voorvoegsel gebruikt, worden de naamruimte en de veldnaam gescheiden door een schuine streep (/).

{
  "$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"
    }
  }
}

Compatibiliteitsmodus compatibility

In Adobe Experience Platform, worden de schema's XDM vertegenwoordigd in ​ syntaxis van de Wijze van de Verenigbaarheid ​, die niet de JSON-LD syntaxis gebruikt om namespaces te vertegenwoordigen. In plaats daarvan converteert Experience Platform de naamruimte naar een bovenliggend veld (te beginnen met een onderstrepingsteken) en worden de onderliggende velden genest.

De standaard-XDM repo:createdDate wordt bijvoorbeeld omgezet in _repo.createdDate en wordt weergegeven onder de volgende structuur in de compatibiliteitsmodus:

"_repo": {
  "type": "object",
  "properties": {
    "createdDate": {
      "type": "string",
      "format": "datetime"
    }
  }
}

De gebieden die xdm gebruiken namespace verschijnen als wortelgebieden onder properties en laten vallen xdm: prefix die in ​ standaardXDM syntaxis ​ zou verschijnen. xdm:sku wordt bijvoorbeeld gewoon weergegeven als sku .

De volgende JSON vertegenwoordigt hoe het standaard XDM syntaxisvoorbeeld hierboven wordt getoond vertaald naar de Wijze van de Verenigbaarheid.

{
  "$id": "https://ns.adobe.com/xdm/schemas/mySchema",
  "title": "Product",
  "description": "Represents the definition of a Project",
  "properties": {
    "_id": {
      "type": "string"
    },
    "sku": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "_repo": {
      "type": "object",
      "properties": {
        "createdDate": {
          "type": "string",
          "format": "datetime"
        }
      }
    },
    "_channels": {
      "type": "object",
      "properties": {
        "application": {
          "type": "string"
        }
      }
    },
    "_schema": {
      "type": "object",
      "properties": {
        "application": {
          "type": "string"
        }
      }
    },
    "_vendorA": {
      "type": "object",
      "properties": {
        "product": {
          "type": "object",
          "properties": {
            "stockNumber": {
              "type": "string"
            }
          }
        }
      }
    },
    "_tenantId": {
      "type": "object",
      "properties": {
        "internalSku": {
          "type": "number"
        }
      }
    }
  }
}

Volgende stappen

Deze handleiding biedt een overzicht van XDM-naamruimten en hoe deze worden weergegeven in JSON. Voor meer informatie over hoe te om schema's XDM te vormen gebruikend API, zie de ​ gids van de Registratie API van het Schema ​.