在 UI 中定義列舉和建議值 enums-and-suggested-values

在Experience Data Model (XDM)中,字串欄位可以獲得一組預先定義的接受或建議值,以便更好地控制哪些值會擷取到該欄位中,或其在分段中會如何表現。

列舉 將字串欄位可擷取的值限製為預先定義的集合。 如果您嘗試將資料內嵌至列舉欄位,但值不符合其設定中定義的任何值,則會拒絕內嵌。

相較於列舉, 建議值 選項可讓您針對不限制可內嵌值的字串欄位,表示一組建議值。 建議值反而會影響中可用的預先定義值 區段UI 將字串欄位納入為屬性時。

時間 定義新欄位 在Adobe Experience Platform使用者介面中,並將型別設定為 字串,您可以選擇定義 列舉建議值 用於該欄位。

此影像顯示為UI中字串欄位啟用的「列舉和建議值」選項

本文介紹如何在中定義列舉和建議值 方案 UI工作區。 如需列舉和建議值的快速概覽(包括如何在UI中設定它們及其下游效果),請觀看以下影片:

定義列舉 enum

選取 列舉和建議值,然後選取 列舉. 會出現其他控制項,可讓您指定列舉的值限制。 若要新增限制,請選取 新增列.

顯示在UI中選取的列舉選項的影像

欄中,您必須提供想要強制欄位使用的確切值。 您可以選擇提供人性化的 顯示名稱 也會影響分段中值的呈現方式。

繼續使用 新增列 將所需的限制和選用標籤新增至列舉,或選取刪除圖示( 刪除圖示的影像 )來移除之前新增的列。 完成後,選取 套用 將變更套用至結構描述。

此影像顯示為UI中的字串欄位填寫的列舉值和顯示名稱

畫布會更新以反映變更。 當您日後探索此結構時,可以檢視並編輯右側邊欄中列舉欄位的限制。

定義建議值 suggested-values

選取 列舉和建議值,然後選取 建議值 讓其他控制項出現。 從這裡,選擇 新增列 以開始新增建議值。

顯示在UI中選取的「建議值」選項的影像

顯示名稱 欄中,為值提供您想在分段UI中顯示的好記名稱。 若要新增更多建議值,請選取 新增列 依需要再次重複此程式。 若要移除先前新增的列,請選取 刪除圖示 相關列旁邊。

完成後,選取 套用 將變更套用至結構描述。

此影像顯示為UI中的字串欄位填寫的列舉值和顯示名稱

NOTE
欄位更新的建議值大約會延遲五分鐘,才會反映在分段UI中。

管理標準欄位的建議值

標準XDM元件中的某些欄位包含自己的建議值,例如 eventTypeXDM ExperienceEvent 類別. 雖然您可以為標準欄位建立其他建議值,但無法修改或移除組織未定義的任何建議值。 在UI中檢視標準欄位時,其建議值會顯示,但為唯讀。

此影像顯示為UI中的字串欄位填寫的列舉值和顯示名稱

若要為標準欄位新增建議值,請選取 新增列. 若要移除貴組織先前新增的建議值,請選取 刪除圖示 相關列旁邊。

此影像顯示為UI中的字串欄位填寫的列舉值和顯示名稱

列舉和建議值的演化規則 evolution

使用具有列舉欄位的結構描述將資料擷取到Platform後,對結構描述定義所做的任何進一步變更都必須符合系統中已存在的資料。 一般而言,對現有欄位進行的變更只能使該欄位生效 較少 限制性。 欄位不可設定得比原來更嚴格。

有關列舉和建議值,下列規則適用於擷取之後:

  • 可以 使用現有的建議值為標準和自訂欄位新增建議值。
  • 可以 從具有現有建議值的自訂欄位中移除建議值。
  • 可以 為現有的自訂列舉欄位新增列舉值。
  • 可以 將自訂欄位的列舉值切換為僅建議值,或將其轉換為沒有列舉或建議值的字串。 此切換一旦套用即無法復原。
  • 無法 從標準欄位中移除列舉值或建議值。
  • 無法 將列舉值新增到沒有現有列舉的欄位。
  • 無法 為自訂欄位移除少於所有現有列舉值。
  • 無法 從建議值切換為列舉。

合併列舉和建議值的規則 merging

如果多個結構描述使用具有不同設定的相同列舉欄位,而這些結構描述包含在聯合中,則某些規則會套用在如何協調列舉差異上。 確切的規則取決於參考相同標準欄位的結構描述(例如 eventType)或是否參照了不同欄位群組中的相同自訂欄位路徑。

如果參照相同的標準欄位:

  • 任何其他建議值為 已附加 在聯合中。
  • 相同列舉索引鍵的建議值更新為 已更新 在聯合中。

如果參照不同欄位群組中的相同自訂欄位路徑:

  • 任何其他建議值為 已附加 在聯合中。
  • 如果在多個結構描述中定義了相同的其他建議值,則這些值為 已合併 在聯合中。 換句話說,相同的建議值在合併後不會顯示兩次。

驗證限制

由於目前系統的限制,在兩種情況下,系統會在擷取期間未驗證列舉:

  1. 列舉定義於 陣列欄位.
  2. 列舉在結構描述階層中定義了一個以上的層級。

後續步驟

本指南說明如何在UI中定義字串欄位的列舉和建議值。 有關如何使用Schema Registry API管理列舉和建議值的資訊,請參閱以下內容 教學課程.

若要瞭解如何在中定義其他XDM欄位型別 Schema Editor,請參閱概述,位於 在UI中定義欄位.

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