建立即席架構

在特定情況下，可能需要 Experience Data Model (XDM)模式，其欄位僅由單個資料集使用。這稱為「臨時」架構。在各種資料接收工作流中使用點對點模式 Experience Platform，包括插入CSV檔案和建立某些類型的源連接。

本文檔提供了使用架構註冊表API。它打算與其他 Experience Platform 要求在工作流中建立臨時架構的教程。每個文檔都提供了有關如何為特定用例正確配置臨時架構的詳細資訊。

快速入門

本教程要求您對 Experience Data Model (XDM)系統。在開始本教程之前，請查看以下XDM文檔：

XDM系統概述:XDM及其在XDM中的實施 Experience Platform。
架構組合的基礎:XDM架構的基本元件概述。

在開始本教程之前，請複習開發者指南獲取您需要瞭解的重要資訊，以便成功撥打 Schema Registry API。這包括您 {TENANT_ID}、「容器」的概念和發出請求所需的標頭（特別要注意「接受」標頭及其可能值）。

建立即席類

XDM架構的資料行為由其基礎類決定。建立即席模式的第一步是根據 adhoc 行為。這是通過向 /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`	用作新ad-hoc類的只讀系統生成的唯一標識符的URI。此值用於建立即席架構的下一步。