建立臨機結構

在特定情況下，可能需要建立(XDM)架構，其中欄位的名稱僅限單一資料集使用。 Experience Data Model 這稱為「臨機」架構。臨機結構描述用於各種資料擷取工作流程中， Experience Platform包括擷取CSV檔案並建立特定類型的來源連線。

本檔案提供使用架構註冊表API建立臨機架構的一般步驟。它可與其他需要在其工作流程中 Experience Platform 建立臨機架構的教學課程搭配使用。這些文檔中的每個文檔都提供了有關如何為特定使用案例正確配置臨時架構的詳細資訊。

快速入門

本教學課程需要對(XDM) Experience Data Model 系統有良好的認識。開始本教學課程之前，請先閱讀下列XDM檔案：

XDM系統概述:XDM及其實施的高階概觀 Experience Platform。
架構構成基礎:概述XDM架構的基本元件。

在開始本教學課程之前，請先閱讀開發人員指南，以取得成功呼叫 Schema Registry API所需的重要資訊。這包括您 {TENANT_ID}的「容器」概念，以及提出要求所需的標題（請特別注意「接受」標題及其可能的值）。

建立臨機類別

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: {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替換對象的名稱，該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。此值用於建立臨機結構的下一個步驟。