在UI中定義XDM欄位

Adobe Experience Platform使用者介面中的Schema Editor可讓您在自訂的Experience Data Model(XDM)類別和混音中定義您自己的欄位。 本指南涵蓋在UI中定義XDM欄位的步驟,包括每個欄位類型的可用設定選項。

必要條件

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

雖然本指南不是必要的,但建議您也要遵循在UI](…/…/tutorials/create-schema-ui.md)中構成架構的[教學課程,以熟悉Schema Editor的各種功能。

選擇資源以將欄位添加到

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

開啟Schema Editor後,請使用左側導軌來選取您要定義欄位的類別或混音。 如果資源是由您的組織定義的自訂資源,則在畫布中會顯示新增或編輯欄位的控制項。 這些控制項會出現在方案名稱旁邊,以及已在所選類別或混合項下定義的任何物件類型欄位。

注意

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

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

定義資源的欄位

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

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

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

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

您也可以選取「進 階類型搜 尋」,以搜尋和篩選現有的資料類型,並更輕鬆地尋找所需類型。

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

注意

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

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

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

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

您可以繼續遵循上述步驟,將更多欄位新增至架構。 儲存架構後,如果對其進行任何變更,也會儲存其基本類別和混合。

注意

您對某個架構的mixin或類所做的任何更改都將反映在所有採用它們的其他架構中。

類型特定欄位屬性

定義新欄位時,根據您為欄位選擇的​Type,其他配置選項可能出現在右側邊欄中。 下表概述了這些附加欄位屬性及其相容類型:

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

特殊欄位類型

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

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

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

後續步驟

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

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free