使用 UI 建立和編輯資料類型 ui-create-and-edit

在體驗資料模型(XDM)中,資料型別是包含多個子欄位的可重複使用欄位。 雖然資料型別與結構描述欄位群組類似,因為其允許一致地使用多欄位結構,但資料型別更靈活,因為它們可以包含在結構描述結構中的任意位置,而欄位群組只能新增到根層級。

Adobe Experience Platform提供許多標準資料型別,可用於涵蓋各種常見的體驗管理使用案例。 不過,您也可以定義自己的自訂資料型別,以滿足獨特的業務需求。

NOTE
如果欄位定義為特定資料型別,則無法在另一個結構描述中以不同的資料型別建立相同的欄位。 此限制適用於您組織的租使用者。

本教學課程涵蓋在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

NOTE
在已啟用用於即時客戶個人檔案的結構描述中使用現有資料型別後,此後只能對該資料型別進行非破壞性變更。 如需詳細資訊,請參閱結構描述演化🔗的規則。

只能編輯您的組織定義的自訂資料型別。 選取​ 自訂 ​以僅顯示貴組織擁有的自訂資料型別。

從清單中選取您要編輯的資料型別,以開啟右側邊欄,顯示資料型別的詳細資訊。 您還可以從詳細資料面板下載範例檔案、複製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管理資料型別,請參閱資料型別端點指南

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07