在UI中定義XDM欄位

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

先決條件

本指南需要妥善了解XDM系統。 請參閱 XDM概觀 了解XDM在Experience Platform生態系統中的角色,以及 綱要構成基本知識 若要了解類別和欄位群組如何將欄位貢獻至XDM結構。

雖然本指南並非必要項目,但建議您也參照 在UI中合成架構 熟悉 Schema Editor.

選取要新增欄位的資源

若要在UI中定義新的XDM欄位,您必須先在 Schema Editor. 視您目前在 Schema Library,您可以選擇 建立新架構選擇要編輯的現有架構.

一旦您擁有 Schema Editor 開啟,畫布中會顯示新增或編輯欄位的控制項。 這些控制項會出現在架構名稱旁邊,以及已在所選類或欄位組下定義的任何對象類型欄位。

警告

如果嘗試將欄位添加到標準欄位組提供的對象中,該欄位組將轉換為自定義欄位組,原始欄位組將不再可用。 請參閱 將欄位添加到標準欄位組 如需詳細資訊,請參閱綱要UI指南。

若要將新欄位新增至資源,請選取 加號(+) 表徵圖,在畫布中的架構名稱旁邊,或在要定義欄位的對象類型欄位旁邊。

根據您是直接將欄位新增至架構或其組成類別和欄位群組,新增欄位的必要步驟會有所不同。 本檔案的其餘部分著重於如何設定欄位的屬性,而無論該欄位出現在架構中的何處。 如需將欄位新增至結構的不同方式的詳細資訊,請參閱結構UI指南中的下列章節:

定義欄位的屬性

選取 加號(+) 表徵圖, 新欄位 會顯示在畫布中,位於與您的不重複租用戶ID命名的物件中(如 _tenantId 在以下範例中)。 新增至結構的所有自訂欄位都會自動放置在此命名空間中,以防止與Adobe提供的類別和欄位群組中的其他欄位產生衝突。

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

欄位屬性 說明
欄位名稱 欄位的不重複、描述性名稱。 請注意,一旦儲存架構,就無法變更欄位的名稱。

名稱最好用camelCase寫。 它可能包含英數字元、破折號或底線字元,但它 不能 從底線開始。
  • 正確: fieldName
  • 可接受: field_name2, Field-Name, field-name_3
  • 錯誤: _fieldName
顯示名稱 這個田地的人性化名稱。
類型 欄位將包含的資料類型。 從此下拉式功能表中,您可以選取 標準標量類型 由XDM支援,或多欄位其中一個 資料類型 中 Schema Registry.

您也可以選取 進階類型搜尋 若要搜尋及篩選現有資料類型,並更輕鬆找出所需類型。

您也可以提供人類看得懂的選用 說明 至欄位,提供有關欄位預期使用案例的更多內容。

注意

類型 您為欄位選取的其他設定控制項可能會顯示在右側欄中。 請參閱 類型特定欄位屬性 以取得這些控制項的詳細資訊。

右側邊欄也提供用於指定特殊欄位類型的核取方塊。 請參閱 特殊欄位類型 以取得更多資訊。

完成欄位設定後,請選取 套用.

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

您可以繼續依照上述步驟,將更多欄位新增至結構。 儲存架構後,如果對架構進行任何變更,也會儲存其基類和欄位群組。

注意

您對某個架構的欄位群組或類別所做的任何變更,都會反映在採用這些變更的所有其他架構中。

類型特定欄位屬性

定義新欄位時,視 類型 您為欄位選擇。 下表列出這些附加欄位屬性及其相容類型:

欄位屬性 相容類型 說明
預設值 字串, 雙倍, 長, 整數, 簡短, 位元組, 布林值 如果擷取期間未提供其他值,則會指派給此欄位的預設值。 此值必須符合欄位的選取類型。
模式 字串 A 規則運算式 此欄位的值必須符合,才能在擷取期間接受。
格式 字串 從預先定義的字串格式清單中選取值必須符合的格式。 可用格式包括:
最小長度 字串 字串必須包含的最小字元數,該值在擷取期間才可接受。
長度上限 字串 字串必須包含的字元數上限,該值在擷取期間才可接受。
最小值 雙倍 擷取期間,要接受Double的最小值。 如果擷取的值與此處輸入的值完全相符,則接受該值。 使用此限制時,獨佔最小值「約束必須留空。
最大值 雙倍 擷取期間要接受Double的最大值。 如果擷取的值與此處輸入的值完全相符,則接受該值。 使用此限制時,獨佔最大值「約束必須留空。
獨佔最小值 雙倍 擷取期間要接受Double的最大值。 如果擷取的值與此處輸入的值完全相符,則拒絕該值。 使用此限制時,最小值「(非獨佔)約束必須留空。
獨佔最大值 雙倍 擷取期間要接受Double的最大值。 如果擷取的值與此處輸入的值完全相符,則拒絕該值。 使用此限制時,最大值「(非獨佔)約束必須留空。

特殊欄位類型

右側邊欄提供數個核取方塊,用以指定所選欄位的特殊角色。 其中某些選項的使用案例對於您的資料模型策略以及您要使用下游Platform服務的方式,會有重要考量。

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

雖然技術上不是特殊欄位類型,但也建議您參閱 定義對象類型欄位 若要進一步了解如果您的結構,定義巢狀子欄位。

後續步驟

本指南概略說明如何在UI中定義XDM欄位。 請記住,只能使用類和欄位組將欄位添加到架構中。 若要進一步了解如何在UI中管理這些資源,請參閱建立和編輯指南 欄位群組.

如需功能的詳細資訊,請參閱 結構 工作區,請參閱 結構 工作區概述.

本頁內容