在UI中定義XDM欄位

Adobe Experience Platform用戶介面中的Schema Editor允許您在自定義Experience Data Model(XDM)類和模式欄位組中定義自己的欄位。 本指南涵蓋在UI中定義XDM欄位的步驟,包括每個欄位類型的可用設定選項。

先決條件

本指南需要對XDM System有充分的瞭解。 有關XDM在Experience Platform生態系統中的角色介紹,請參閱XDM概述架構構成基礎,以瞭解類和欄位組如何將欄位貢獻給XDM架構。

雖然本指南不是必要的,但建議您也要遵循在UI🔗中構成架構的教學課程,以熟悉Schema Editor的各種功能。

選擇資源以將欄位添加到

要在UI中定義新的XDM欄位,必須首先在Schema Editor中開啟一個模式。 根據Schema Library中當前可用的方案,您可以選擇建立新方案選擇現有方案以編輯

開啟Schema Editor後,使用左側導軌選擇要為其定義欄位的類或欄位組。 如果資源是由您的組織定義的自訂資源,則在畫布中會顯示新增或編輯欄位的控制項。 這些控制項會顯示在方案名稱旁邊,以及已在選定類或欄位組下定義的任何對象類型欄位。

注意

如果您選擇的類或欄位組是Adobe提供的核心資源,則無法編輯它,因此將不顯示上述控制項。 如果要向中添加欄位的方案基於核心XDM類,且不包含任何自定義欄位組,則可以建立一個新欄位組以添加到方案。

要向資源添加新欄位,請在畫布中方案名稱旁選擇​加號(+)​表徵圖,或在要定義欄位的對象類型欄位旁選擇。

定義資源的欄位

在選取​plus(+)​圖示後,畫布中會出現​New field,位於與您唯一租用戶ID同名的根層級物件內(如下例中顯示為_tenantId)。 透過自訂類別和欄位群組新增至架構的所有欄位都會自動置於此命名空間中,以避免與Adobe提供類別和欄位群組中的其他欄位產生衝突。

在​Field properties​下方的右邊欄中,您可以設定新欄位的詳細資料。 每個欄位都需要下列資訊:

欄位屬性 說明
Field name 欄位的唯一描述性名稱。 請注意,儲存結構後,欄位的名稱便無法變更。

最理想的情況是,名稱應以camelCase寫入。它可能包含英數字元、破折號或底線字元,但​不能​以底線開頭。
  • 正確: fieldName
  • 可接受: field_name2Field-Namefield-name_3
  • 錯誤: _fieldName
Display name 這個田地的人性化名稱。
Type 欄位將包含的資料類型。 從此下拉菜單中,可以選擇XDM支援的標準標量類型中的一種,或者選擇以前在Schema Registry中定義的多欄位資料類型中的一種。

您也可以選取以 Advanced type search 搜尋和篩選現有的資料類型,並更輕鬆地找出所要的類型。

您也可以為欄位提供可選的人讀​Description,以提供欄位預定使用案例的更多內容。

注意

視您為欄位選取的​Type​而定,其他組態控制項可能會出現在右側導軌中。 有關這些控制項的詳細資訊,請參閱類型特定欄位屬性一節。

右邊欄還提供用於指定特殊欄位類型的複選框。 如需詳細資訊,請參閱特殊欄位類型一節。

完成欄位配置後,請選擇​Apply

畫布會更新以顯示欄位的名稱和類型,而右側欄現在除了列出欄位的其他屬性外,還會列出欄位的路徑。

您可以繼續遵循上述步驟,將更多欄位新增至架構。 保存結構後,如果對結構進行了任何更改,則也會保存其基本類和欄位組。

注意

對某個方案的欄位組或類所做的任何更改都將反映在所有採用它們的其他方案中。

類型特定欄位屬性

定義新欄位時,可能會在右邊欄中顯示其他配置選項,具體取決於您為該欄位選擇的​Type。 下表概述了這些附加欄位屬性及其相容類型:

欄位屬性 相容類型 說明
Default value String, Double, Long, Integer, Short, Byte, Boolean 如果擷取期間未提供其他值,則會指派給此欄位的預設值。 此值必須符合欄位的選定類型。
Pattern String 規則運算式,此欄位的值必須符合,才能在擷取期間被接受。
Format String 從預先定義的字串格式清單中選取值必須符合的格式。 可用格式包括:
Minimum length String 字串必須包含的字元數目下限,才能在擷取期間接受值。
Maximum length String 字串必須包含的字元數上限,才能在擷取期間接受值。
Minimum value Double 擷取期間接受Double的最小值。 如果收錄的值與此處輸入的值完全相符,則會接受該值。 使用此約束時,"Exclusive minimum value"約束必須留空。
Maximum value Double 擷取期間接受Double的最大值。 如果收錄的值與此處輸入的值完全相符,則會接受該值。 使用此約束時,"Exclusive maximum value"約束必須留空。
Exclusive minimum value Double 擷取期間接受Double的最大值。 如果收錄的值與此處輸入的值完全相符,則會拒絕該值。 使用此約束時,"Minimum value"(非獨佔)約束必須留空。
Exclusive maximum value Double 擷取期間接受Double的最大值。 如果收錄的值與此處輸入的值完全相符,則會拒絕該值。 使用此約束時,"Maximum value"(非獨佔)約束必須留空。

特殊欄位類型

右邊欄提供幾個複選框,用於為選定欄位指定特殊角色。 其中一些選項的使用案例涉及有關您的資料模型策略以及您打算如何使用下游平台服務的重要考量。

若要進一步瞭解這些特殊類型,請參閱下列檔案:

雖然技術上不是特殊欄位類型,但建議您造訪定義物件類型欄位的指南,以進一步瞭解如果架構結構,定義巢狀子欄位。

後續步驟

本指南提供如何在UI中定義XDM欄位的概觀。 請記住,欄位只能透過使用類別和欄位群組新增至結構。 若要進一步瞭解如何在UI中管理這些資源,請參閱有關建立和編輯欄位組的指南。

有關Schemas工作區功能的詳細資訊,請參閱Schemas工作區概述

本頁內容

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now