임시 스키마 만들기

특정 상황에서 다음을 만들어야 할 수 있습니다. Experience Data Model 단일 데이터 세트에서만 사용할 수 있도록 네임스페이스가 지정된 필드가 있는 XDM 스키마. 이를 "임시" 스키마라고 합니다. 임시 스키마는 의 다양한 데이터 수집 워크플로우에서 사용됩니다. Experience Platform: CSV 파일 수집 및 특정 종류의 소스 연결 생성을 포함합니다.

이 문서에서는 다음을 사용하여 임시 스키마를 만드는 일반적인 단계를 제공합니다. 스키마 레지스트리 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 페이로드에서 이전에 만든 ad-hoc 클래스.

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 지정된 대로 워크플로를 완료할 임시 스키마.

을 사용하여 작업하는 방법에 대한 자세한 내용 Schema Registry API, 다음을 참조하십시오. 개발자 안내서.

Business.Adobe.com 리소스

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

임시 스키마 만들기

시작하기

임시 클래스 만들기

임시 스키마 만들기

전체 임시 스키마 보기

다음 단계

Business.Adobe.com 리소스

이 페이지에서는

다음 보기:

학습

기술 문서

커뮤니티

고객지원

리소스

Adobe 계정

Adobe