建立臨機結構

在特定情況下，可能需要建立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}、"containers"的概念，以及提出要求時所需的標題（請特別注意「接受」標題及其可能的值）。

建立臨機類別

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`	包含類自定義欄位的對象，表示為欄位名和資料類型的鍵值對。

回應

成功的響應返回新類的詳細資訊，用系統生成的唯讀類唯一標識符GUID替換properties._adhoc對象的名稱。 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。此值用於建立臨機結構的下一個步驟。