在UI中定義XDM欄位
Adobe Experience Platform使用者介面中的Schema Editor可讓您在自訂體驗資料模型(XDM)類別和結構描述欄位群組中定義自己的欄位。 本指南涵蓋在UI中定義XDM欄位的步驟,包括每個欄位型別的可用設定選項。
先決條件
本指南需要實際瞭解XDM系統。 請參閱XDM總覽,瞭解XDM在Experience Platform生態系統中的角色簡介,以及結構描述組合的基本知識,瞭解類別和欄位群組如何對XDM結構描述貢獻欄位。
雖然本指南並非必要專案,但建議您也按照有關在UI中構成結構描述的教學課程,熟悉Schema Editor的各種功能。
選取要新增欄位的資源 select-resource
若要在UI中定義新的XDM欄位,您必須先在Schema Editor中開啟結構描述。 視您在Schema Library中目前可用的結構描述而定,您可以選擇建立新的結構描述或選取要編輯的現有結構描述。
開啟Schema Editor後,畫布中就會顯示要新增欄位的控制項。 這些控制項會顯示在結構描述名稱旁,以及已定義在所選類別或欄位群組下的任何物件型別欄位旁。
若要新增欄位至資源,請在畫布中選取結構描述名稱旁的 加號(+) 圖示,或選取您想定義其下欄位的物件型別欄位旁的圖示。
視您是將欄位直接新增到結構描述或其組成類別和欄位群組而定,新增欄位的必要步驟將會有所不同。 本檔案的其餘部分著重於如何設定欄位的屬性,無論該欄位出現在結構描述中的何處。 如需有關欄位可以新增到結構描述的不同方式的詳細資訊,請參閱結構描述UI指南中的下列區段:
定義欄位的屬性 define
選取 加號(+) 圖示後,未命名的欄位 預留位置會顯示在畫布中。
在 欄位屬性 下的右側邊欄中,您可以設定新欄位的詳細資料。 每個欄位都需要下列資訊:
欄位的不重複、描述性名稱。 請注意,一旦結構描述已儲存,欄位名稱就無法變更。 此值用於識別及參考程式碼和其他下游應用程式中的欄位
最好以camelCase撰寫此名稱。 它可包含英數、破折號或底線字元,但 不能 以底線開頭。
- 正確:
fieldName
- 可接受:
field_name2
,Field-Name
,field-name_3
- 不正確:
_fieldName
若要深入瞭解特定型別的欄位屬性,請參閱定義欄位概觀。
您也可以選擇為每個欄位提供說明和附註。 使用 Description 欄位來新增內容並描述對應資料型別的功能。 這有助於實施的可維護性和可讀性。 您也可以新增附註以補充初始說明。 這可提供更細微且具體的資訊,以協助開發人員在程式碼基底的情境下,有效瞭解、維護及使用地圖。 |
完成欄位設定後,請選取 套用。
畫布更新以顯示新新增的欄位,該欄位位於以您唯一租使用者ID命名的物件中(在以下範例中顯示為_tenantId
)。 新增到結構描述的所有自訂欄位會自動放置在此名稱空間中,以防止與Adobe提供的類別和欄位群組中的其他欄位衝突。 現在,右側邊欄會列出欄位路徑以及其他屬性。
您可以繼續依照上述步驟,將更多欄位新增至結構描述。 一旦儲存結構描述後,如果對結構描述進行任何變更,也會儲存其基底類別和欄位群組。
特定型別的欄位屬性 type-specific-properties
定義新欄位時,根據您為欄位選擇的 型別,右側邊欄中可能會顯示其他組態選項。 下表概述這些額外的欄位屬性及其相容型別:
{width="100" modal="regular"}
注意:任何透過API建立的對應資料型別,若不是String或Integer型別,則會顯示為'Complex'資料型別。 您無法透過UI建立'複雜'資料型別。
特殊欄位型別 special
右邊欄提供數個核取方塊,可指定所選欄位的特殊角色。 其中部分選項的使用案例涉及有關您的資料模型化策略以及您打算如何使用下游平台服務的重要考量。
若要深入瞭解這些特殊型別,請參閱下列檔案:
雖然從技術上講不是特殊欄位型別,但建議您造訪有關定義物件型別欄位的指南,以進一步瞭解如何在結構描述結構時定義巢狀子欄位。
後續步驟
本指南概述如何在UI中定義XDM欄位。 請記住,欄位只能透過使用類別和欄位群組新增到結構描述中。 若要進一步瞭解如何在UI中管理這些資源,請參閱建立和編輯類別和欄位群組的指南。
如需結構描述工作區功能的詳細資訊,請參閱結構描述工作區概觀。