使用 UI 建立和編輯資料類型 ui-create-and-edit
在體驗資料模型(XDM)中,資料型別是包含多個子欄位的可重複使用欄位。 雖然資料型別與結構描述欄位群組類似,因為其允許一致地使用多欄位結構,但資料型別更靈活,因為它們可以包含在結構描述結構中的任意位置,而欄位群組只能新增到根層級。
Adobe Experience Platform提供許多標準資料型別,可用於涵蓋各種常見的體驗管理使用案例。 不過,您也可以定義自己的自訂資料型別,以滿足獨特的業務需求。
本教學課程涵蓋在Platform使用者介面中建立和編輯自訂資料型別的步驟。
先決條件 prerequisites
本指南需要實際瞭解XDM系統。 請參閱XDM總覽,瞭解XDM在Experience Platform生態系統中的角色簡介,以及結構描述組合基本概念,瞭解資料型別對XDM結構描述的貢獻。
雖然本指南並非必要專案,但建議您也按照有關在UI中構成結構描述的教學課程,熟悉Schema Editor的各種功能。
開啟資料型別的Schema Editor data-type
在Platform UI中,選取左側導覽中的 結構描述 以開啟結構描述工作區,然後選取 資料型別 索引標籤。 畫面隨即顯示可用資料型別清單。 系統會根據資料型別的建立方式自動篩選資料型別清單。 預設設定會顯示Adobe定義的資料型別。 您還可以篩選清單以顯示您的組織建立的清單。
從這裡,您有以下選項:
建立新的資料型別 create
從 資料型別 索引標籤中,選取 建立資料型別。
Schema Editor隨即顯示,顯示畫布中新資料型別的目前結構。 在編輯器的右側,您可以為資料型別提供顯示名稱和可選說明。 請確定您為您的資料型別提供唯一且簡潔的名稱,因為這是將資料型別新增至結構描述時識別資料型別的方式。
本教學課程會建立描述餐廳屬性的資料型別,因此該資料型別的顯示名稱為「餐廳」。
從這裡,您可以跳到下一節,開始將欄位新增到新資料型別。
篩選資料型別 filter
可用資料類型清單已根據其建立方式預先進行篩選。選取選項按鈕以在標準與自訂選項之間選擇。 Standard選項會顯示Adobe建立的實體,而Custom選項則會顯示在您的組織內建立的實體。
編輯現有的資料型別 edit
只能編輯您的組織定義的自訂資料型別。 選取 自訂 以僅顯示貴組織擁有的自訂資料型別。
從清單中選取您要編輯的資料型別,以開啟右側邊欄,顯示資料型別的詳細資訊。 您還可以從詳細資料面板下載範例檔案、複製JSON結構或將資料型別新增到套件中。
在右側邊欄中選取資料型別的名稱,以在Schema Editor中開啟其結構。
新增欄位至資料型別 add-fields
若要開始將欄位新增至資料型別,請在畫布的根層級欄位旁選取 加號(+) 圖示。 下方會顯示新欄位,而右側邊欄會更新,以顯示新欄位的控制項。
使用右側邊欄中的控制項來設定新欄位的詳細資訊。 請參閱在UI中定義欄位的指南,以瞭解如何設定欄位並將其新增至資料型別的具體步驟。
餐廳資料型別需要字串欄位來代表餐廳名稱。 因此,欄位名稱設為"name",型別設為"String"。 選取 套用 以套用變更至欄位。
視需要繼續新增更多欄位至資料型別。 範例Restaurant資料型別現在有品牌、座位容量和樓層空間的額外欄位。
除了基本欄位之外,您也可以在自訂資料型別中巢狀內嵌其他資料型別。 例如,「餐廳」資料型別需要欄位來代表屬性的實體位址。 在此案例中,您可以新增指派為標準資料型別"郵寄地址"的「地址」欄位。
這說明了資料型別在描述您的資料方面可以有多大的彈性:資料型別可以使用欄位,這些欄位也是資料型別,其本身可以包含進一步的資料型別等等。 這可讓您在XDM結構描述中抽象化並重複使用通用資料模式,更輕鬆地表示複雜的資料結構。
完成新增欄位至資料型別後,請選取 儲存 以儲存變更並將資料型別新增至Schema Library。
將資料型別新增到結構描述 add-data-type
建立資料型別後,您就可以開始在結構描述中使用它。 由於XDM結構描述是由類別和零個或多個欄位群組所組成,因此資料型別提供的欄位無法直接新增到結構描述。 反之,它們必須包含在類別或欄位群組中。
首先,請依照將欄位新增至類別或將欄位新增至欄位群組的相關步驟進行。 或者,您可以開始將欄位直接新增到結構描述,並從那裡選擇父類別或欄位群組。 當您為新欄位選擇 型別 時,請從下拉式選單中選取您的資料型別名稱。
將多欄位物件轉換為資料型別 convert
當您在Schema Editor中建立具有多個子欄位的物件型別欄位時,可以將該欄位轉換為資料型別,以便在不同的類別或欄位群組中使用該相同的欄位結構。
若要將物件型別欄位轉換為資料型別,請選取畫布中的欄位。 在轉換欄位之前,請確定 顯示名稱 描述物件將包含的資料,因為這會成為資料型別的名稱。 當您準備好要轉換欄位時,請在右側邊欄中選取 轉換成新資料型別。
畫布會將欄位的資料型別從"物件"更新為新資料型別。 定義新欄位時,可以從 Type 下拉式清單中選取此資料型別,以在其他類別和欄位群組中重複使用此結構。
後續步驟 next-steps
本指南說明如何使用Platform UI建立及編輯資料型別。 如需結構描述工作區功能的詳細資訊,請參閱結構描述工作區概觀。
若要瞭解如何使用Schema Registry API管理資料型別,請參閱資料型別端點指南。