Extremo de comportamientos

En el Modelo de datos de experiencia (XDM), los comportamientos definen la naturaleza de los datos que describe un esquema. Cada clase XDM debe hacer referencia a un comportamiento específico, que heredarán todos los esquemas que emplean esa clase. Para casi todos los casos de uso de Platform, hay dos comportamientos disponibles:

  • Registro: Proporciona información sobre los atributos de un asunto. Un sujeto podría ser una organización o un individuo.
  • Serie temporal: Proporciona una instantánea del sistema en el momento en que un sujeto de registro realizó una acción, directa o indirectamente.
NOTA

Hay algunos casos de uso en Platform que requieren el uso de un esquema que no emplea ninguno de los comportamientos anteriores. Para estos casos, hay disponible un tercer comportamiento "ad hoc". Consulte el tutorial sobre creación de un esquema ad hoc para obtener más información.

Para obtener información más general sobre los comportamientos de datos en términos de cómo afectan a la composición de esquemas, consulte la guía de conceptos básicos de composición de esquemas.

El /behaviors punto final en la Schema Registry API permite ver los comportamientos disponibles en la variable global contenedor.

Primeros pasos

El extremo utilizado en esta guía forma parte de la Schema Registry API de . Antes de continuar, consulte la guía de introducción para obtener vínculos a documentación relacionada, una guía para leer las llamadas de API de ejemplo en este documento e información importante sobre los encabezados necesarios para realizar correctamente llamadas a cualquier API de Experience Platform.

Recuperación de una lista de comportamientos

Puede recuperar una lista de todos los comportamientos disponibles realizando una solicitud de GET a la variable /behaviors punto final.

Formato de API

GET /global/behaviors

Solicitud

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: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed-id+json'

Respuesta

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

Búsqueda de un comportamiento

Puede buscar un comportamiento específico proporcionando su ID en la ruta de una petición de GET a /behaviors punto final.

Formato de API

GET /global/behaviors/{BEHAVIOR_ID}
Parámetro Descripción
{BEHAVIOR_ID} El meta:altId o con codificación URL $id del comportamiento que desea buscar.

Solicitud

La siguiente solicitud recupera los detalles del comportamiento del registro proporcionando su meta:altId en la ruta de solicitud.

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: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed+json;version=1'

Respuesta

Una respuesta correcta devuelve los detalles del comportamiento, incluida su versión, descripción y los atributos que proporciona a las clases que lo emplean.

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

Pasos siguientes

Esta guía trata sobre el uso de /behaviors punto final en la Schema Registry API. Para obtener información sobre cómo asignar un comportamiento a una clase mediante la API, consulte guía de extremo de clases.

En esta página