在UI中定義XDM欄位

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

先決條件

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

雖然本指南並非必要,但建議您也參照在UI🔗中撰寫架構的教學課程,熟悉Schema Editor的各種功能。

選擇要向添加欄位的資源

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

開啟Schema Editor後,使用左側邊欄選取您要定義欄位的類別或欄位群組。 如果資源是貴組織定義的自訂資源,畫布中會顯示新增或編輯欄位的控制項。 這些控制項會出現在架構名稱旁邊,以及已在所選類或欄位組下定義的任何對象類型欄位。

注意

如果您選取的類別或欄位群組是Adobe提供的核心資源,則無法編輯,因此將不會顯示上述控制項。 如果您要新增欄位的架構是根據核心XDM類別,且不包含任何自訂欄位群組,您可以建立新欄位群組以改為新增至架構。

若要向資源新增欄位,請選取畫布中架構名稱旁或您要定義欄位之下之物件類型欄位旁的​加號(+)​圖示。

定義資源的欄位

選取​加號(+)​圖示後,畫布中會出現​新欄位,位於與您的唯一租用戶ID命名的根層級物件內(在以下範例中顯示為_tenantId)。 通過自定義類和欄位組添加到架構的所有欄位都會自動放置在此命名空間中,以防止與Adobe提供的類和欄位組中的其他欄位發生衝突。

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

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

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

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

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

注意

視您為欄位選取的​類型​而定,右側邊欄中可能會顯示其他設定控制項。 有關這些控制項的詳細資訊,請參閱類型特定欄位屬性上的部分。

右側邊欄也提供用於指定特殊欄位類型的核取方塊。 如需詳細資訊,請參閱特殊欄位類型的區段。

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

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

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

注意

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

類型特定欄位屬性

定義新欄位時,視您為欄位選擇的​Type​而定,其他設定選項可能會顯示在右側欄中。 下表列出這些附加欄位屬性及其相容類型:

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

特殊欄位類型

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

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

雖然從技術上來說不是特殊欄位類型,但建議您參閱defining object-type fields上的指南,以進一步了解如果您的架構結構,如何定義巢狀子欄位。

後續步驟

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

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

本頁內容