Dans le modèle de données d’expérience (XDM), les comportements définissent la nature des données qu’un schéma décrit. Chaque classe XDM doit faire référence à un comportement spécifique, dont tous les schémas qui utilisent cette classe hériteront. Pour presque tous les cas d’utilisation de la plate-forme, il existe deux comportements disponibles :
Il y a des cas d'utilisation dans Plateforme qui nécessitent l'utilisation de schéma qui n'utilisent aucun des comportements ci-dessus. Pour ces cas, un troisième comportement "ad hoc" est disponible. Pour plus d’informations, consultez le didacticiel intitulé Création d’un schéma ad hoc.
Pour obtenir des informations plus générales sur les comportements des données en ce qui concerne la façon dont ils affectent la composition des schémas, consultez le guide sur les bases de la composition des schémas.
Le point de terminaison /behaviors
de l'API Schema Registry vous permet de vue des comportements disponibles dans le conteneur global
.
Le point de terminaison utilisé dans ce guide fait partie de l'Schema Registry API. Avant de continuer, consultez le guide de prise en main pour obtenir des liens vers la documentation connexe, un guide de lecture des exemples d'appels d'API dans ce document et des informations importantes concernant les en-têtes requis nécessaires pour passer des appels à toute API Experience Platform.
Vous pouvez récupérer une liste de tous les comportements disponibles en envoyant une demande de GET au point de terminaison /behaviors
.
Format d’API
GET /global/behaviors
Requête
curl -X GET \
https://platform.adobe.io/data/foundation/schemaregistry/global/behaviors \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Accept: application/vnd.adobe.xed-id+json'
Réponse
{
"results": [
{
"$id": "https://ns.adobe.com/xdm/data/record",
"meta:altId": "_xdm.data.record",
"version": "1.16.4",
"title": "Record Schema"
},
{
"$id": "https://ns.adobe.com/xdm/data/adhoc",
"meta:altId": "_xdm.data.adhoc",
"version": "1.16.4",
"title": "Ad Hoc Schema"
},
{
"$id": "https://ns.adobe.com/xdm/data/time-series",
"meta:altId": "_xdm.data.time-series",
"version": "1.16.4",
"title": "Time-series Schema"
}
],
"_page": {
"orderby": "updated",
"next": null,
"count": 3
},
"_links": {
"next": null
}
}
Vous pouvez rechercher un comportement spécifique en fournissant son identifiant dans le chemin d'une demande de GET au point de terminaison /behaviors
.
Format d’API
GET /global/behaviors/{BEHAVIOR_ID}
Paramètre | Description |
---|---|
{BEHAVIOR_ID} |
meta:altId ou encodé en URL $id du comportement que vous souhaitez rechercher. |
Requête
La requête suivante récupère les détails du comportement de l'enregistrement en fournissant son meta:altId
dans le chemin de la requête.
curl -X GET \
https://platform.adobe.io/data/foundation/schemaregistry/global/behaviors/_xdm.data.record \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Accept: application/vnd.adobe.xed+json;version=1'
Réponse
Une réponse positive renvoie les détails du comportement, y compris sa version, sa description et les attributs que le comportement fournit aux classes qui l’utilisent.
{
"$id": "https://ns.adobe.com/xdm/data/record",
"meta:altId": "_xdm.data.record",
"meta:resourceType": "behaviors",
"version": "1.16.4",
"title": "Record Schema",
"type": "object",
"description": "Used to indicate the behavior of record data semantic when composed into data schemas.",
"definitions": {
"record": {
"properties": {
"_id": {
"title": "Identifier",
"type": "string",
"format": "uri-reference",
"description": "A unique identifier for the record.",
"meta:xdmType": "string",
"meta:xdmField": "@id"
}
}
}
},
"allOf": [
{
"$ref": "#/definitions/record",
"type": "object",
"meta:xdmType": "object"
},
{
"$ref": "https://ns.adobe.com/xdm/common/extensible#/definitions/@context",
"type": "object",
"meta:xdmType": "object"
}
],
"meta:extensible": true,
"meta:abstract": true,
"meta:xdmType": "object",
"meta:status": "stable",
"$schema": "http://json-schema.org/draft-06/schema#",
"meta:registryMetadata": {
"repo:createdDate": 1606266789446,
"repo:lastModifiedDate": 1606266789446,
"eTag": "2cc114a54949a9668fe2ad046ccece59192e1bfa28f14e5ac7c893acb7820ba2",
"meta:globalLibVersion": "1.16.4"
}
}
Ce guide porte sur l'utilisation du point de terminaison /behaviors
dans l'API Schema Registry. Pour savoir comment attribuer un comportement à une classe à l'aide de l'API, consultez le guide de point de terminaison classes.