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