임시 스키마 만들기

특정 상황에서 단일 데이터 집합에서만 사용하도록 지정된 필드가 있는 Experience Data Model (XDM) 스키마를 만들어야 할 수 있습니다. 이를 "임시" 스키마라고 합니다. 임시 스키마는 CSV 파일 섭취와 특정 종류의 소스 연결 만들기를 포함하여 Experience Platform에 대한 다양한 데이터 수집 워크플로우에서 사용됩니다.

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

시작하기

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

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

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

임시 클래스 만들기

XDM 스키마의 데이터 동작은 기본 클래스에 의해 결정됩니다. 임시 스키마를 만드는 첫 번째 단계는 adhoc 동작을 기반으로 클래스를 만드는 것입니다. 이 작업은 /tenant/classes 종단점에 POST 요청을 수행하면 수행됩니다.

API 형식

POST /tenant/classes

요청

다음 요청은 페이로드에 제공된 속성으로 구성된 새 XDM 클래스를 만듭니다. allOf 배열에서 https://ns.adobe.com/xdm/data/adhoc로 설정된 $ref 속성을 공급하면 이 클래스는 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: {IMS_ORG}' \
  -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": "{IMS_ORG}",
    "meta:xdmType": "object",
    "meta:registryMetadata": {
        "repo:createdDate": 1557527784822,
        "repo:lastModifiedDate": 1557527784822,
        "xdm:createdClientId": "{CREATED_CLIENT}",
        "xdm:lastModifiedClientId": "{MODIFIED_CLIENT}",
        "eTag": "Jggrlh4PQdZUvDUhQHXKx38iTQo="
    }
}

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

임시 스키마 만들기

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

API 형식

POST /tenant/schemas

요청

다음 요청은 새 스키마를 만들어 페이로드에서 이전에 만든 임시 클래스의 $id에 참조($ref)를 제공합니다.

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: {IMS_ORG}' \
  -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": "{IMS_ORG}",
    "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: {IMS_ORG}' \
  -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": "{IMS_ORG}",
    "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 을 사용하여 지시에 따라 워크플로우를 완료할 수 있습니다.

Schema Registry API 작업에 대한 자세한 내용은 개발자 안내서를 참조하십시오.

Adobe.com의 리소스

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

임시 스키마 만들기

시작하기

임시 클래스 만들기

임시 스키마 만들기

전체 임시 스키마 보기

다음 단계

Adobe.com의 리소스

이 페이지에서는

다음 보기:

학습

문서

커뮤니티

지원

리소스

Adobe 계정

Adobe