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

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

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

與列舉相反,建議值 ​選項允許為字串欄位表示一組建議值,這些建議值不會限制它可以擷取的值。 建議值反而會影響將字串欄位加入為屬性時,分段UI中可用的預先定義值。

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

影像顯示UI中字串欄位已啟用列舉與建議值選項

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

定義列舉 enum

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

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

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

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

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

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

定義建議值 suggested-values

選取​ 列舉和建議值,然後選取​ 建議值,以顯示其他控制項。 從這裡,選取​ 新增列 ​以開始新增建議值。

顯示UI中選取之[建議值]選項的影像

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

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

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

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

管理標準欄位的建議值

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

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

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

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

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

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

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

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

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

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

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

  • 任何其他建議值皆為聯合中的​ APPENDED
  • 相同列舉索引鍵的建議值更新為聯合中的​ UPDATED

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

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

驗證限制

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

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

後續步驟

本指南說明如何在UI中定義字串欄位的列舉和建議值。 有關如何使用結構描述登入API管理列舉和建議值的資訊,請參閱下列教學課程

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

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