使用Schema Editor建立結構描述

Adobe Experience Platform使用者介面可讓您在名為Experience Data Model的互動式視覺畫布中建立和管理Schema Editor (XDM)結構描述。 本教學課程涵蓋如何使用Schema Editor建立結構描述。

為了示範，本教學課程中的步驟涉及建立範例結構描述，以說明客戶忠誠度計畫的成員。 雖然您可以使用這些步驟建立不同的結構描述以供您自己的用途，但建議您先依照建立範例結構描述以瞭解Schema Editor的功能。

快速入門

此教學課程需要您實際瞭解架構建立中Adobe Experience Platform的各個層面。 在開始本教學課程之前，請檢閱檔案以瞭解下列概念：

開啟Schemas工作區 browse

Schemas UI中的Experience Platform工作區提供Schema Library的視覺效果，可讓您檢視管理組織可用的結構描述。 工作區也包含Schema Editor，您可在此畫布上撰寫此教學課程的結構描述。

登入Experience Platform後，在左側導覽中選取​ Schemas ​以開啟​ Schemas ​工作區。 Browse​索引標籤會顯示結構描述清單（Schema Library的表示方式），供您檢視和自訂。 此清單包括結構描述所根據的名稱、型別、類別和行為（記錄或時間序列），以及上次修改結構描述的日期和時間。

如需詳細資訊，請參閱在UI中探索現有XDM資源的指南。

建立方案並為其命名 create

若要開始撰寫結構描述，請選取​ Create schema ​工作區右上角的​Schemas。

Create a schema對話方塊隨即顯示。 在此對話方塊中，您可以選擇透過新增欄位和欄位群組來手動建立結構描述，或者您可以上傳CSV檔案並使用ML演演算法來產生結構描述。 從對話方塊中選取結構描述建立工作流程。

[Beta]{class="badge informative"}手動或ML輔助的結構描述建立 manual-or-assisted

若要瞭解如何使用ML演演算法根據上傳的檔案來建議結構描述結構，請參閱機器學習輔助結構描述建立指南。 本UI指南著重於手動建立工作流程。

選擇基底類別 choose-a-class

Create schema工作流程隨即顯示。 接著，選擇結構描述的基底類別。 您可以在XDM Individual Profile與XDM ExperienceEvent的核心類別之間選擇，或者，如果這些類別不適合您的用途，請選擇Other。 Other類別選項可讓您建立新類別，或從其他預先存在的類別中選擇。

如需這些類別的詳細資訊，請參閱XDM individual profile和XDM ExperienceEvent檔案。 在本教學課程中，請選取​XDM Individual Profile，然後選取​Next。

命名並檢閱 name-and-review

選取類別之後，Name and review區段就會顯示。 您可以在此段落中提供名稱和說明，以識別您的結構描述。 決定結構描述的名稱時，有幾個重要考量事項需要考慮：

此教學課程撰寫結構描述以擷取與熟客方案成員相關的資料，因此結構描述命名為"Loyalty Members"。

結構​描述的基本結構（由類別提供）會顯示在畫布中，供您檢閱及驗證選取的類別和結構描述結構。

在文字欄位中輸入人性化的Schema display name。 接下來，輸入適當的說明來協助識別您的結構描述。 當您檢閱了結構描述結構並對設定感到滿意時，請選取「Finish」以建立結構描述。

撰寫結構描述 compose-your-schema

Schema Editor出現。 這是您將在其中撰寫結構描述的畫布。 當您進入編輯器時，會自動在畫布的​ Structure ​區段中建立自標名的結構描述，以及包含在您選取之基底類別中的標準欄位。 結構描述的指派類別也列在​ Class ​區段的​ Composition ​下。

新增欄位群組 field-group

您現在可以透過新增欄位群組來開始將欄位新增到結構描述。 欄位群組是一或多個欄位的群組，通常搭配使用來描述特定概念。 本教學課程使用欄位群組來說明熟客方案的成員，並擷取關鍵資訊，例如，姓名、生日、電話號碼、地址等。

若要新增欄位群組，請在​ Add ​子區段中選取​Field groups。

新的對話方塊隨即出現，顯示可用欄位群組的清單。 每個欄位群組僅供特定類別使用，因此對話方塊僅列出與您選取的類別（在此例中為XDM Individual Profile類別）相容的欄位群組。 如果您使用標準XDM類別，欄位群組清單將會根據使用人氣聰明地排序。

您可以選取左側邊欄中的其中一個篩選器，將標準欄位群組清單縮小至特定產業，例如零售、金融服務及醫療保健。

從清單中選取欄位群組後，該群組就會顯示在右側邊欄中。 您可以視需要選取多個欄位群組，在確認前將每個欄位群組新增到右側欄的清單中。 此外，圖示會顯示在目前所選欄位群組的右側，可讓您預覽其所提供的欄位結構。

預覽欄位群組時，右側邊欄會提供欄位群組的結構描述詳細資訊。 您還可以瀏覽提供的畫布中的欄位群組欄位。 當您選取不同欄位時，右側欄會更新，顯示有關問題欄位的詳細資訊。 完成預覽後選取​ Back ​以返回欄位群組選取對話方塊。

在本教學課程中，請選取​ Demographic Details ​欄位群組，然後選取​Add field group。

結構畫布會重新出現。 Field groups​區段現在列出「Demographic Details」，而​ Structure ​區段包含欄位群組貢獻的欄位。 您可以在​ Field groups ​區段下選取欄位群組名稱，以反白顯示它在畫布中提供的特定欄位。

此欄位群組在頂層名稱person下貢獻了數個資料型別為"Person"的欄位。 這組欄位說明個人的相關資訊，包括姓名、出生日期和性別。

請注意，name欄位的資料型別為「Full name」，這表示它也會描述一般概念，並包含與名稱相關的子欄位，例如名字、姓氏、尊稱和字尾。

選取畫布中的不同欄位，以顯示這些欄位對結構描述結構貢獻的任何其他欄位。

新增更多欄位群組 field-group-2

您現在可以重複相同的步驟來新增另一個欄位群組。 這次檢視​ Add field group ​對話方塊時，請注意「Demographic Details」欄位群組已變成灰色，且無法選取其旁邊的核取方塊。 這可防止您不小心複製已包含在目前結構描述中的欄位群組。

在本教學課程中，請從清單中選取標準欄位群組​ Personal Contact Details ​和​Loyalty Details，然後選取​ Add field groups ​以將它們新增至結構描述。

畫布會重新出現，新增的欄位群組列在​ Field groups ​區段的​ Composition ​下，其複合欄位已新增至結構描述結構。

定義自訂欄位群組 define-field-group

Loyalty Members結構描述旨在擷取和熟客方案會員相關的資料，而您新增至結構描述的標準Loyalty Details欄位群組提供了其中的大部分，包括方案型別、點、加入日期等。

但是，在某些情況下，您可能會想要包含標準欄位群組未涵蓋的其他自訂欄位，以便實現您的使用案例。 如果新增自訂忠誠度欄位，您有兩個選項：

若要建立新的欄位群組，請選取​ Add ​子區段中的​Field groups，就像之前一樣，但這次請選取靠近出現的對話方塊頂端的​Create New Field group。 接著，系統會要求您提供新欄位群組的顯示名稱和說明。 在本教學課程中，將新欄位群組命名為"Custom Loyalty Details"，然後選取​Add field groups。

"Custom Loyalty Details"現在應該出現在畫布左側的​ Field groups ​下，但尚未有與其關聯的欄位，因此​ Structure ​下未出現任何新欄位。

新增欄位至欄位群組 field-group-fields

現在您已建立「Custom Loyalty Details」欄位群組，是時候定義欄位群組將貢獻給結構描述的欄位了。

若要開始，請選取畫布中結構描述名稱旁的​ 加號(+) ​圖示。

畫布中會顯示「Untitled Field」預留位置，而右側邊欄會更新，顯示欄位的設定選項。

在此案例中，結構描述需要物件型別欄位，以詳細描述人員目前的熟客方案。 使用右側邊欄中的控制項，開始建立型別為"loyaltyTier"的Object欄位，其將用於儲存您的相關欄位。

在​ Assign to ​底下，您必須選取要指派欄位的欄位群組。 請記住，所有結構描述欄位都屬於類別或欄位群組，由於此結構描述使用標準類別，因此您唯一的選項是選取欄位群組。 開始輸入名稱「Custom Loyalty Details」，然後從清單中選取欄位群組。

完成後，選取​Apply。

變更已套用，且新建立的loyaltyTier物件隨即顯示。 由於這是自訂欄位，因此會自動巢狀內嵌在您組織租使用者ID名稱空間中的物件，前面會加上底線（在此範例中為_tenantId）。

選取​ 物件旁的 ​加號(+)loyaltyTier圖示以開始新增子欄位。 新欄位預留位置隨即顯示，畫布右側會顯示​ Field properties ​區段。

每個欄位都需要下列資訊：

loyaltyTier物件的第一個欄位將是名為id的字串，代表忠誠會員目前層級的ID。 每個忠誠會員的層級ID將是唯一的，因為該公司會根據不同因素為每個客戶設定不同的忠誠度層級臨界值。 將新欄位的型別設定為"String"，則​ Field properties ​區段會填入多個套用限制的選項，包括預設值、格式和最大長度。 如需瞭解詳細資訊，請參閱資料驗證欄位最佳實務的檔案。

由於id將是隨機產生的自由字串，因此不需要進一步的限制。 選取​ Apply ​以套用您的變更。

新增更多欄位至欄位群組 field-group-fields-2

現在您已新增id欄位，您可以新增其他欄位來擷取忠誠度等級資訊，例如：

若要將每個欄位新增至結構描述，請選取​ 物件旁的 ​加號(+)loyalty圖示，並填入必要資訊。

完成時，loyaltyTier物件將包含id、currentThreshold、nextThreshold和effectiveDate的欄位。

新增列舉欄位至欄位群組 enum

在Schema Editor中定義欄位時，有一些可套用至基本欄位型別的額外選項，以便針對欄位可包含的資料提供進一步的限制。 下表說明這些限制的使用案例：

在本教學課程中，結構描述中的loyaltyTier物件需要新的列舉欄位來說明階層類別，其中值只能是四個可能選項之一。 若要將此欄位新增到結構描述，請選取​ 物件旁的 ​加號(+)loyaltyTier圖示，並填入​ Field name ​和​ Display name ​的必要欄位。 針對​Type，選取「String」。

中新增並反白含有階層類別物件的結構描述編輯器

選取欄位型別後，會出現其他核取方塊，包括​Array、Enum & Suggested Values、Identity​和​ Relationship ​的核取方塊。

選取​ Enum & Suggested Values ​核取方塊，然後選取​Enum。 您可以在此輸入每個可接受的熟客方案等級類別的​Value （在駝峰式大小寫中）和​Display Name （標題大小寫中為選擇性、方便讀者的名稱）。

完成所有欄位屬性後，選取​ Apply ​將tierClass欄位新增至loyaltyTier物件。

將多欄位物件轉換為資料型別 datatype

loyaltyTier物件現在包含數個欄位，並代表在其他結構描述中可能有用的通用資料結構。 Schema Editor可讓您透過將這些物件的結構轉換為資料型別，輕鬆套用可重複使用的多欄位物件。

資料型別允許一致地使用多欄位結構，並且比欄位群組提供更大的彈性，因為它們可以在結構描述內的任何位置使用。 這是透過將欄位的​ Type ​值設定為Schema Registry中定義的任何資料型別的值來完成的。

若要將loyaltyTier物件轉換為資料型別，請在畫布中選取loyaltyTier欄位，然後選取​ Convert to new data type ​下編輯器右側的​Field properties。

系統會顯示通知，確認物件已成功轉換。 在畫布中，您現在可以看到loyaltyTier欄位現在有連結圖示，而右邊欄表示它有"Loyalty Tier"資料型別。

在未來的結構描述中，您現在可以將欄位指派為「Loyalty Tier」型別，而且它會自動包含ID、階層類別、點臨界值和有效日期的欄位。

搜尋和篩選結構描述欄位

除了其基底類別提供的欄位外，您的結構描述現在包含多個欄位群組。 使用較大的結構描述時，您可以選取左側邊欄中欄位群組名稱旁邊的核取方塊，將顯示的欄位篩選為您感興趣的欄位群組所提供的欄位。

如果您在結構描述中尋找特定欄位，也可以使用搜尋列依名稱篩選顯示的欄位，無論這些欄位是在哪個欄位群組下提供。

將結構描述欄位設定為身分欄位 identity-field

結構提供的標準資料結構可用於識別跨多個來源屬於同一個人的資料，以允許各種下游使用案例，例如細分、報表、資料科學分析等。 為了根據個別身分拼接資料，索引鍵欄位必須在適用的結構描述中標示為Identity欄位。

Experience Platform可讓您透過使用​ Identity ​中的Schema Editor核取方塊輕鬆表示身分欄位。 不過，您必須根據資料的性質，判斷哪個欄位最適合作為身分使用。

例如，可能有數千名忠誠計畫成員屬於相同的忠誠度等級，而數個成員可能共用相同的實體地址。 不過，在此案例中，註冊時，熟客方案的每位成員都會提供其個人電子郵件地址。 由於個人電子郵件地址通常由一人管理，因此欄位personalEmail.address （由Personal Contact Details欄位群組提供）是身分欄位的理想候選者。

選取畫布中的personalEmail.address欄位，Identity​核取方塊會顯示在​ Field properties ​下方。 核取方塊和選項，將此專案設定為​ Primary identity ​顯示。 也請選取此方塊。

接下來，您必須從下拉式清單中的預先定義名稱空間清單提供​Identity namespace。 由於此欄位是客戶的電子郵件地址，請從下拉式清單中選取"Email"。 選取​ Apply ​以確認personalEmail.address欄位的更新。

套用變更後，personalEmail.address的圖示會顯示指紋符號，表示它現在是身分欄位。 此欄位也會列在​ Identities ​下的左側邊欄中。

現在，所有擷取至personalEmail.address欄位的資料將用於協助識別該個人，並將該客戶的單一檢視拼接在一起。 若要進一步瞭解如何在Experience Platform中使用身分，請檢閱Identity Service檔案。

啟用結構描述以用於Real-Time Customer Profile profile

Real-Time Customer Profile利用Experience Platform中的身分資料提供每個個別客戶的整體檢視。 此服務會針對客戶在與Experience Platform整合的任何系統中進行的每次互動，建立健全且全方位客戶屬性設定檔以及時間戳記帳戶。

若要啟用結構描述以搭配Real-Time Customer Profile使用，它必須定義主要身分。 如果您嘗試在未先定義主要身分的情況下啟用結構描述，將會收到錯誤訊息。

若要啟用「熟客會員」結構描述以用於Profile，請先在畫布中選取結構描述標題。

在編輯器的右側，會顯示有關結構的資訊，包括其顯示名稱、說明和型別。 除了此資訊之外，還有​ Profile ​切換按鈕。

選取​Profile，畫面會顯示彈出視窗，要求您確認要啟用Profile的結構描述。

選取​ Enable ​以確認您的選擇。 您可以視需要再次選取​ Profile ​切換以停用結構描述，但一旦在啟用Profile時儲存結構描述，就無法再停用它。

更多動作 more

在架構編輯器中，您還可以執行快速動作以複製架構的JSON結構或刪除架構。 選取檢視頂端的More，以顯示包含快速動作的下拉式清單。

刪除結構描述 delete-a-schema

可以使用More動作從UI中的結構描述編輯器刪除，也可以從Browse索引標籤中的結構描述詳細資料中刪除。 在某些情況下，無法刪除結構描述。 如果符合下列條件，則無法刪除結構描述：

複製 JSON 結構 copy-json-structure

選取​ Copy JSON structure ​為結構描述資料庫中的任何結構描述產生匯出裝載。 此動作會將JSON結構複製到剪貼簿。 接著，您就可以使用匯出的JSON將結構描述及任何相關資源匯入不同的沙箱或組織。 如此可在不同環境之間的模式輕鬆且有效率地共用和重複使用結構描述。

後續步驟和其他資源

現在您已經完成撰寫結構描述，您可以在畫布中看到完整的結構描述。 選取「Save」，結構描述將會儲存到Schema Library，以供Schema Registry存取。

您的新結構描述現在可用於將資料內嵌至Experience Platform。 請記住，一旦使用結構描述來擷取資料後，只能進行加總變更。 如需結構描述版本設定的詳細資訊，請參閱結構描述組合的基本知識。

您現在可以依照在上定義結構描述關聯性的教學課程，在UI中新增關聯性欄位至「忠誠會員」結構描述。

您也可以使用Schema Registry API來檢視及管理「忠誠會員」結構描述。 若要開始使用API，請先閱讀Schema Registry API 開發人員指南。

視訊資源

以下影片說明如何在Experience Platform UI中建立簡單結構描述。

以下影片旨在讓您更瞭解如何使用欄位群組和類別。

附錄

下列章節提供使用Schema Editor的額外資訊。

建立新類別 create-new-class

Experience Platform可讓您根據組織獨有的類別來定義結構描述。 若要瞭解如何建立新類別，請參閱在UI中建立和編輯類別的指南。

變更結構描述的類別 change-class

您可以在儲存結構描述之前，在初始構成程式期間隨時變更結構描述的類別。

若要瞭解如何變更結構描述的類別，請參閱在UI中管理結構描述的指南。