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

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

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

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

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

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

定義列舉 enum

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

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

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

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

定義建議值 suggested-values

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

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

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

管理標準欄位的建議值

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

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

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

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

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

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

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

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

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

驗證限制

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

後續步驟

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

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