建立隨選結構

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

本檔案提供使用Schema Registry API建立臨機架構的一般步驟。它旨在與其他需要建立隨選架構作為其工作流程一部分的Experience Platform教學課程搭配使用。這些檔案都提供如何為其特定使用案例正確配置臨時架構的詳細資訊。

快速入門

本教學課程需要妥善了解Experience Data Model (XDM)系統。開始本教學課程之前，請先檢閱下列XDM檔案：

XDM系統概觀:概略概述XDM及其實作於中 Experience Platform。
結構構成基本概念:概述XDM結構的基本元件。

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

建立臨機類別

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`	作為只讀、系統生成的新Ad-Hoc類唯一標識符的URI。此值將用於建立臨機架構的下一個步驟。