在結構描述中模型資料

前往Platform使用者介面，並確保已選取您的沙箱。

前往左側導覽中的​ 結構描述。

選取右上方的​ 建立結構描述 ​按鈕。

在「建立結構描述」工作流程中，選取​ 個別設定檔 ​作為結構描述的基底類別，因為我們將針對個別客戶的屬性（點、狀態等）建立模型。

選取​ 下一步。

在​ 結構描述顯示名稱 ​文字欄位中輸入Luma Loyalty Schema。 在以下畫布中，您也可以檢閱及驗證您所選擇類別所提供的基本結構描述結構。

選取​ 完成 ​以建立您的結構描述。

選取​ 欄位群組 ​標題下的​ 新增。

在​ 新增欄位群組 ​強制回應視窗中，選取下列欄位群組：

1. 基本客戶資料的人口統計細節，例如名稱和出生日期
2. 個人聯絡詳細資料 ​基本聯絡詳細資料，例如電子郵件地址和電話號碼

您可以選取列右側的圖示，預覽欄位群組中貢獻的欄位。

勾選​ 產業 > 零售 ​方塊，以公開產業特定欄位群組。

選取​ 熟客方案詳細資料 ​以新增熟客方案欄位。

選取​ 新增欄位群組 ​以將這三個欄位群組新增到結構描述。

選取結構描述名稱旁的​ +。 這會在您的租使用者ID名稱空間下新增欄位，以管理您的自訂欄位和任何標準欄位之間的衝突。

在​ 欄位屬性 ​側邊欄中新增新欄位的詳細資料：

1. 欄位名稱： systemIdentifier

2. 顯示名稱： System Identifier

3. 型別： 物件

4. 在​ 欄位群組 ​下拉式清單中，選取我們已建立的​ Luma身分設定檔欄位群組。

   

5. 選取​ 套用

   

第一個欄位

1. 欄位名稱： loyaltyId
2. 顯示名稱： Loyalty Id
3. 型別： 字串

第二個欄位

1. 欄位名稱： crmId
2. 顯示名稱： CRM Id
3. 型別： 字串

開啟Postman

如果您沒有存取權杖，請開啟要求​ OAuth: Request Access Token ​並選取​ 傳送 ​以要求新的存取權杖。

開啟您的環境變數，並將​ CONTAINER_ID ​的值從global變更為tenant。 請記住，每當您想要與Platform中您自己的自訂元素互動時（例如建立結構描述），都必須使用tenant。

選取​ 儲存

開啟請求​ Schema Registry API > Schemas > Create a new custom schema.

開啟​ 內文 ​索引標籤並貼上下列程式碼，然後選取​ 傳送 ​進行API呼叫。 此呼叫使用相同的XDM Individual Profile基底類別建立新的結構描述：

{
  "type": "object",
  "title": "Luma CRM Schema",
  "description": "Schema for CRM data of Luma Retail ",
  "allOf": [{
    "$ref": "https://ns.adobe.com/xdm/context/profile"
  }]
}

您應該會收到201 Created回應

從回應本文複製meta:altId。 我們稍後會在另一個練習中使用它。

新的結構描述應該會顯示在使用者介面中，但不包含任何欄位群組

在Postman中，開啟要求​ Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

在​ 引數 ​索引標籤中，將先前回應中的meta:altId值貼上為SCHEMA_ID

開啟[內文]索引標籤並貼上下列程式碼，然後選取​ 傳送 ​以進行API呼叫。 這個呼叫會將標準欄位群組新增到您的Luma CRM Schema：

[{
    "op": "add",
    "path": "/allOf/-",
    "value": {
      "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details"
    }
  },
  {
    "op": "add",
    "path": "/allOf/-",
    "value": {
      "$ref": "https://ns.adobe.com/xdm/context/profile-person-details"
    }
  }
]

您應該會收到回應的「200 OK」狀態，而且欄位群組應該會顯示在您的UI結構描述中

開啟請求​ Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

選取​ 傳送 ​按鈕，以擷取您帳戶中所有自訂欄位群組的清單

抓取Luma Identity profile field group的$id值（您的值將與此熒幕擷圖中的值不同）

再次開啟請求​ Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

Params ​索引標籤仍應具有結構描述的$id

開啟​ 內文 ​索引標籤並貼上下列程式碼，將$ref值取代為您自己的Luma Identity profile field group的$id：

[{
  "op": "add",
  "path": "/allOf/-",
  "value": {
    "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
  }
}]

選取​ 傳送

選取​ 建立結構描述 ​按鈕。

在[建立結構描述]工作流程中，選取​ 其他 ​選項。

選取​ 建立類別 ​按鈕

將其命名為Luma Product Catalog Class

將​ 行為 ​保留為​ 記錄

選取​ 建立 ​按鈕。

您建立的​ Luma產品目錄類別 ​會出現在下面的「類別」表格中。 確定已選取類別，然後選取​ 下一步。

命名結構描述Luma Product Catalog Schema。

使用下列欄位建立名為Luma Product Catalog field group的新欄位群組：

1. productName：產品名稱：字串
2. productCategory：產品類別：字串
3. productColor：產品色彩：字串
4. productSku： Product SKU： String | 必填
5. productSize：產品大小：字串
6. productPrice：產品價格：雙倍

儲存 ​結構描述