在UI中定義XDM欄位

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

先決條件

本指南需要實際瞭解XDM系統。 請參閱 XDM概觀 介紹XDM在Experience Platform生態系統內的角色，以及 結構描述組合基本概念 以瞭解類別和欄位群組如何為XDM結構描述貢獻欄位。

雖然本指南不需要，但建議您也參閱以下主題的相關教學課程： 在UI中構成結構描述 熟悉 Schema Editor.

選取要新增欄位的資源

若要在UI中定義新的XDM欄位，您必須先在 Schema Editor. 根據您目前在「 」中可用的結構描述 Schema Library，您可以選擇 建立新結構描述 或 選取要編輯的現有結構描述.

一旦您擁有 Schema Editor 開啟，畫布中會顯示新增欄位的控制項。 這些控制項會顯示在結構描述名稱旁邊，也會顯示在選取的類別或欄位群組下定義的任何物件型別欄位旁邊。

警告

如果您嘗試將欄位新增到由標準欄位群組提供的物件，該欄位群組將轉換為自訂欄位群組，並且原始欄位群組將不再可用。 請參閱以下小節： 新增欄位至標準欄位群組 如需詳細資訊，請參閱結構描述UI指南。

若要將新欄位新增至資源，請選取 加(+) 圖示來定義結構描述名稱，或位於要定義其下欄位的物件型別欄位旁。

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

定義欄位的屬性

選取 加(+) 圖示，一個 未命名的欄位 預留位置會顯示在畫布中。

在右邊欄中，於 欄位屬性，您可以設定新欄位的詳細資訊。 每個欄位都需要下列資訊：

欄位屬性 說明
欄位名稱 欄位的唯一描述性名稱。 請注意，一旦結構描述已儲存，欄位名稱就無法變更。 此值用於識別和參考程式碼和其他下游應用程式中的欄位

最好是以camelCase撰寫名稱。 它可包含英數、破折號或底線字元，但它 可能不會 以底線開頭。
  • 正確： fieldName
  • 可接受： field_name2， Field-Name， field-name_3
  • 不正確： _fieldName
顯示名稱 欄位的顯示名稱。 這是將用於表示結構描述編輯器畫布中欄位的名稱。 可使用將欄位名稱變更為顯示名稱 顯示名稱切換.
類型 欄位將包含的資料型別。 從此下拉式功能表中，您可以選取 標準純量型別 受XDM支援，或多重欄位之一 資料型別 之前在中定義的 Schema Registry.

您也可以選取 進階型別搜尋 搜尋和篩選現有資料型別，更輕鬆地找到所需型別。

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

注意

根據 型別 您為欄位選取了，其他設定控制項可能會顯示在右側邊欄中。 請參閱以下小節： 型別特定欄位屬性 以取得這些控制項的詳細資訊。

右邊欄也提供用於指定特殊欄位型別的核取方塊。 請參閱以下小節： 特殊欄位型別 以取得詳細資訊。

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

畫布會更新以顯示新新增的欄位，該欄位位於以您唯一租使用者ID命名的物件內(如下所示 _tenantId （在以下範例中）。 新增到結構描述的所有自訂欄位會自動放置在此名稱空間中，以防止與Adobe提供的類別和欄位群組中的其他欄位衝突。 右側邊欄現在會列出欄位路徑以及其他屬性。

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

注意

您對一個結構描述的欄位群組或類別所做的任何變更，都將反映在採用它們的所有其他結構描述中。

型別特定欄位屬性

定義新欄位時，其他設定選項可能會顯示在右側邊欄中，具體取決於 型別 您為欄位選擇。 下表概述這些額外的欄位屬性及其相容型別：

欄位屬性 相容型別 說明
預設值 字串， 兩次， 長， 整數， 短， 位元組， 布林值 如果在擷取期間未提供其他值，則為指派給此欄位的預設值。 此值必須符合欄位選取的型別。

預設值不會在擷取時儲存在資料集中，因為它們會隨著時間變更。 從資料集讀取資料時，下游平台服務和應用程式會推斷結構描述中設定的預設值。 例如，在使用「查詢服務」查詢資料時，如果屬性具有NULL值，但預設值設定為 5 在結構描述層級，預期查詢服務將傳回 5 而非NULL。 請注意，目前並非所有AEP服務都有這種行為。
模式 字串 A 規則運算式 此欄位的值必須符合以便在擷取期間被接受。
格式 字串 從預先定義的字串格式清單中選取值必須符合的格式。 可用的格式包括：
最小長度 字串 為了在內嵌期間接受值，字串必須包含的最小字元數。
長度上限 字串 若要讓值在擷取期間被接受，字串必須包含的最大字元數。
最小值 雙倍 內嵌期間接受的Double的最小值。 如果擷取的值與此處輸入的值完全相符，則會接受該值。 使用此限制時， 「專屬最小值「條件約束必須保留空白。
最大值 雙倍 在內嵌期間接受的Double最大值。 如果擷取的值與此處輸入的值完全相符，則會接受該值。 使用此限制時， 「獨佔最大值「條件約束必須保留空白。
專屬最小值 雙倍 在內嵌期間接受的Double最大值。 如果擷取的值與此處輸入的值完全相符，則會拒絕該值。 使用此限制時， 「最小值「 （非獨佔）限制必須保留空白。
獨佔最大值 雙倍 在內嵌期間接受的Double最大值。 如果擷取的值與此處輸入的值完全相符，則會拒絕該值。 使用此限制時， 「最大值「 （非獨佔）限制必須保留空白。

特殊欄位型別

右邊欄提供數個核取方塊，可指定所選欄位的特殊角色。 其中一些選項的使用案例涉及有關您的資料模型化策略以及您打算如何使用下游Platform服務的重要考量。

若要深入瞭解這些特殊型別，請參閱下列檔案：

雖然從技術上講不是特殊欄位型別，但建議您造訪本指南 定義物件型別欄位 以進一步瞭解如何在結構描述結構時定義巢狀子欄位。

後續步驟

本指南提供如何在UI中定義XDM欄位的概觀。 請記住，欄位只能透過使用類別和欄位群組新增到結構描述。 若要進一步瞭解如何在UI中管理這些資源，請參閱建立和編輯指南 類別 和 欄位群組.

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

本頁內容