임시 스키마 만들기

특정 상황에서 Experience Data Model (XDM) 스키마에는 단일 데이터 세트에서만 사용하도록 지정된 필드가 있습니다. 이를 "임시" 스키마라고 합니다. 애드혹 스키마는 의 다양한 데이터 수집 워크플로우에서 사용됩니다 Experience PlatformCSV 파일 섭취 및 특정 종류의 소스 연결 만들기 등의 작업을 포함합니다.

이 문서에서는 스키마 레지스트리 API. 그것은 다른 것과 함께 사용되기 위한 것이다 Experience Platform 워크플로우의 일부로 임시 스키마를 만들어야 하는 자습서. 이러한 각 문서는 특정 사용 사례에 대해 임시 스키마를 적절히 구성하는 방법에 대한 자세한 정보를 제공합니다.

시작하기

이 자습서에서는 을(를) 제대로 이해하고 있어야 합니다 Experience Data Model (XDM) 시스템. 이 자습서를 시작하기 전에 다음 XDM 설명서를 검토하십시오.

XDM 시스템 개요: XDM과 의 구현에 대한 개요 Experience Platform.
스키마 작성 기본 사항: XDM 스키마의 기본 구성 요소에 대한 개요입니다.

이 자습서를 시작하기 전에 개발자 안내서 를 성공적으로 호출하기 위해 알고 있어야 하는 중요한 정보 Schema Registry API. 여기에는 다음이 포함됩니다 {TENANT_ID}, "컨테이너"의 개념 및 요청을 수행하는 데 필요한 헤더입니다(Accept 헤더와 가능한 값에 특별히 주의).

임시 클래스 만들기

XDM 스키마의 데이터 동작은 기본 클래스에 의해 결정됩니다. 임시 스키마를 만드는 첫 번째 단계는 adhoc 비헤이비어. 이 작업은 POST 요청을 /tenant/classes 엔드포인트.

API 형식

POST /tenant/classes

요청

다음 요청은 페이로드에 제공된 속성으로 구성된 새 XDM 클래스를 만듭니다. 다음을 제공합니다. $ref 속성 설정 https://ns.adobe.com/xdm/data/adhoc 에서 allOf 배열, 이 클래스는 adhoc 비헤이비어. 또한 이 요청에는 _adhoc 객체. 클래스에 대한 사용자 정의 필드를 포함합니다.

노트

에 정의된 사용자 지정 필드 _adhoc 임시 스키마의 사용 사례에 따라 달라집니다. 사용 사례를 기반으로 한 필수 사용자 지정 필드에 대해서는 해당 자습서의 특정 워크플로우를 참조하십시오.

curl -X POST \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/classes \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "title":"New ad-hoc class",
        "description": "New ad-hoc class description",
        "type":"object",
        "allOf": [
          {
            "$ref":"https://ns.adobe.com/xdm/data/adhoc"
          },
          {
            "properties": {
              "_adhoc": {
                "type":"object",
                "properties": {
                  "field1": {
                    "type":"string"
                  },
                  "field2": {
                    "type":"string"
                  }
                }
              }
            }
          }
        ]
      }'

속성	설명
`$ref`	새 클래스의 데이터 동작입니다. 임시 클래스의 경우 이 값을 `https://ns.adobe.com/xdm/data/adhoc`.
`properties._adhoc`	필드 이름과 데이터 형식의 키-값 쌍으로 표시되는 클래스에 대한 사용자 지정 필드를 포함하는 객체입니다.

응답

성공적인 응답은 새 클래스의 세부 정보를 반환하고 properties._adhoc 시스템 생성, 읽기 전용 클래스 고유 식별자인 GUID를 가진 개체의 이름입니다. 다음 meta:datasetNamespace 또한 속성이 자동으로 생성되어 응답에 포함됩니다.

{
    "$id": "https://ns.adobe.com/{TENANT_ID}/classes/6395cbd58812a6d64c4e5344f7b9120f",
    "meta:altId": "_{TENANT_ID}.classes.6395cbd58812a6d64c4e5344f7b9120f",
    "meta:resourceType": "classes",
    "version": "1.0",
    "title": "New Class",
    "description": "New class description",
    "type": "object",
    "allOf": [
        {
            "$ref": "https://ns.adobe.com/xdm/data/adhoc"
        },
        {
            "properties": {
                "_6395cbd58812a6d64c4e5344f7b9120f": {
                    "type": "object",
                    "properties": {
                        "field1": {
                            "type": "string",
                            "meta:xdmType": "string"
                        },
                        "field2": {
                            "type": "string",
                            "meta:xdmType": "string"
                        }
                    },
                    "meta:xdmType": "object"
                }
            },
            "type": "object",
            "meta:xdmType": "object"
        }
    ],
    "meta:abstract": true,
    "meta:extensible": true,
    "meta:extends": [
        "https://ns.adobe.com/xdm/data/adhoc"
    ],
    "meta:containerId": "tenant",
    "meta:datasetNamespace": "_6395cbd58812a6d64c4e5344f7b9120f",
    "imsOrg": "{ORG_ID}",
    "meta:xdmType": "object",
    "meta:registryMetadata": {
        "repo:createdDate": 1557527784822,
        "repo:lastModifiedDate": 1557527784822,
        "xdm:createdClientId": "{CREATED_CLIENT}",
        "xdm:lastModifiedClientId": "{MODIFIED_CLIENT}",
        "eTag": "Jggrlh4PQdZUvDUhQHXKx38iTQo="
    }
}

속성	설명
`$id`	시스템이 새 임시 클래스에 대해 생성한 읽기 전용 고유 식별자로 사용되는 URI입니다. 이 값은 임시 스키마를 만드는 다음 단계에서 사용됩니다.

임시 스키마 만들기

임시 클래스를 만든 후에는 POST 요청을 수행하여 해당 클래스를 구현하는 새 스키마를 만들 수 있습니다 /tenant/schemas 엔드포인트.

API 형식

POST /tenant/schemas

요청

다음 요청은 참조를 제공하는 새 스키마를 만듭니다($ref) $id 의 페이로드에서 이전에 만든 임시 클래스를 생성할 수 있습니다.

curl -X POST \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/schemas \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "title":"New Schema",
        "description": "New schema description.",
        "type":"object",
        "allOf": [
          {
            "$ref":"https://ns.adobe.com/{TENANT_ID}/classes/6395cbd58812a6d64c4e5344f7b9120f"
          }
        ]
      }'

응답

성공적인 응답은 시스템에서 생성한 읽기 전용 스키마를 포함하여 새로 생성된 스키마의 세부 정보를 반환합니다 $id.

{
    "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/26f6833e55db1dd8308aa07a64f2042d",
    "meta:altId": "_{TENANT_ID}.schemas.26f6833e55db1dd8308aa07a64f2042d",
    "meta:resourceType": "schemas",
    "version": "1.0",
    "title": "New Schema",
    "description": "New schema description.",
    "type": "object",
    "allOf": [
        {
            "$ref": "https://ns.adobe.com/{TENANT_ID}/classes/6395cbd58812a6d64c4e5344f7b9120f"
        }
    ],
    "meta:datasetNamespace": "_6395cbd58812a6d64c4e5344f7b9120f",
    "meta:class": "https://ns.adobe.com/{TENANT_ID}/classes/6395cbd58812a6d64c4e5344f7b9120f",
    "meta:abstract": false,
    "meta:extensible": false,
    "meta:extends": [
        "https://ns.adobe.com/{TENANT_ID}/classes/6395cbd58812a6d64c4e5344f7b9120f",
        "https://ns.adobe.com/xdm/data/adhoc"
    ],
    "meta:containerId": "tenant",
    "imsOrg": "{ORG_ID}",
    "meta:xdmType": "object",
    "meta:registryMetadata": {
        "repo:createdDate": 1557528570542,
        "repo:lastModifiedDate": 1557528570542,
        "xdm:createdClientId": "{CREATED_CLIENT}",
        "xdm:lastModifiedClientId": "{MODIFIED_CLIENT}",
        "eTag": "Jggrlh4PQdZUvDUhQHXKx38iTQo="
    }
}

전체 임시 스키마 보기

노트

조건을 추가합니다. 임시 스키마의 필드 구조를 검사하지 않으려면 로 건너뛸 수 있습니다 다음 단계 섹션을 참조하십시오.

임시 스키마가 만들어지면 조회(GET) 요청을 만들어 확장된 양식의 스키마를 볼 수 있습니다. 이 작업은 아래 설명된 대로 GET 요청에서 적절한 Accept 헤더를 사용하여 수행됩니다.

API 형식

GET /tenant/schemas/{SCHEMA_ID}

매개 변수	설명
`{SCHEMA_ID}`	URL로 인코딩되어 있습니다 `$id` URI 또는 `meta:altId` 액세스하려는 임시 스키마 중 하나입니다.

요청

다음 요청에서는 Accept 헤더를 사용합니다 application/vnd.adobe.xed-full+json; version=1는 스키마의 확장된 양식을 반환합니다. 에서 특정 리소스를 검색할 때 Schema Registry를 지정하는 경우, 요청의 Accept 헤더에 해당 리소스의 주요 버전이 포함되어야 합니다.

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/schemas/_{TENANT_ID}.schemas.26f6833e55db1dd8308aa07a64f2042d \
  -H 'Accept: application/vnd.adobe.xed-full+json; version=1' \
  -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}' \

응답

성공적으로 응답하면 아래의 중첩된 모든 필드를 포함하여 스키마의 세부 사항이 반환됩니다 properties.

{
    "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/26f6833e55db1dd8308aa07a64f2042d",
    "meta:altId": "_{TENANT_ID}.schemas.26f6833e55db1dd8308aa07a64f2042d",
    "meta:resourceType": "schemas",
    "version": "1.0",
    "title": "New Schema",
    "description": "New schema description.",
    "type": "object",
    "meta:datasetNamespace": "_6395cbd58812a6d64c4e5344f7b9120f",
    "meta:class": "https://ns.adobe.com/{TENANT_ID}/classes/6395cbd58812a6d64c4e5344f7b9120f",
    "meta:abstract": false,
    "meta:extensible": false,
    "meta:extends": [
        "https://ns.adobe.com/{TENANT_ID}/classes/6395cbd58812a6d64c4e5344f7b9120f",
        "https://ns.adobe.com/xdm/data/adhoc"
    ],
    "meta:containerId": "tenant",
    "imsOrg": "{ORG_ID}",
    "meta:xdmType": "object",
    "properties": {
        "_6395cbd58812a6d64c4e5344f7b9120f": {
            "type": "object",
            "meta:xdmType": "object",
            "properties": {
                "field1": {
                    "type": "string",
                    "meta:xdmType": "string"
                },
                "field2": {
                    "type": "string",
                    "meta:xdmType": "string"
                }
            }
        }
    },
    "meta:registryMetadata": {
        "repo:createdDate": 1557528570542,
        "repo:lastModifiedDate": 1557528570542,
        "xdm:createdClientId": "{CREATED_CLIENT}",
        "xdm:lastModifiedClientId": "{MODIFIED_CLIENT}",
        "eTag": "bTogM1ON2LO/F7rlcc1iOWmNVy0="
    }
}

다음 단계

이 자습서를 따라 새 임시 스키마를 생성했습니다. 이 문서를 다른 자습서의 일부로 가져온 경우 이제 $id 워크플로우가 필요한 대로 완료할 수 있도록 ad-hoc 스키마 입니다.

작업 방법에 대한 자세한 내용 Schema Registry API는 개발자 안내서.

Business.Adobe.com 리소스

Customer Intelligence Content Insights Dynamic Media Dynamic Forms Email Testing Email Service Providers

새로운 검색, 검색 기능 개선

임시 스키마 만들기

시작하기

임시 클래스 만들기

임시 스키마 만들기

전체 임시 스키마 보기

다음 단계

Business.Adobe.com 리소스

이 페이지에서는

다음 보기:

학습

기술 문서

커뮤니티

고객지원

리소스

Adobe 계정

Adobe