在 UI 中建立和編輯綱要 create-edit-schemas-in-ui
本指南概述如何在Adobe Experience Platform UI中建立、編輯及管理貴組織的Experience Data Model (XDM)方案。
先決條件 prerequisites
本指南需要實際瞭解XDM系統。 請參閱XDM總覽,瞭解XDM在Experience Platform生態系統中的角色簡介,以及結構描述組合基本概念,瞭解結構描述建構方式的總覽。
建立新結構描述 create
在結構描述工作區中,選取右上角的 建立結構描述。
建立結構描述工作流程隨即顯示。 您可以選取 個別設定檔、體驗事件 或 其他,接著選取 下一步 以確認您的選擇,為結構描述選擇基底類別。 如需這些類別的詳細資訊,請參閱XDM個別設定檔和XDM ExperienceEvent檔案。
選取類別之後,名稱和檢閱區段就會顯示。 您可以在此段落中提供名稱和說明,以識別您的結構描述。URL結構描述的基本結構(由類別提供)會顯示在畫布中,供您檢閱及驗證選取的類別和結構描述結構。
在文字欄位中輸入人性化的結構描述顯示名稱。 接下來,輸入適當的說明來協助識別您的結構描述。 當您檢閱了結構描述結構並對您的設定感到滿意時,請選取 完成 以建立結構描述。
結構描述 瀏覽索引標籤出現。 您最近建立的結構描述現在列於結構描述資料庫中,並可在Schema Editor中編輯。
編輯現有結構描述 edit
若要編輯現有結構描述,請選取 瀏覽 標籤,然後選取您要編輯的結構描述名稱。 您也可以使用搜尋列來縮小可用選項清單的範圍。
選取結構描述後,Schema Editor會出現,其結構描述結構顯示在畫布中。 您現在可以新增欄位群組到結構描述(或是新增這些群組中的個別欄位)、編輯欄位顯示名稱或編輯現有的自訂欄位群組 (如果結構描述採用任何群組)。
更多動作 more
在結構編輯器中,您還可以執行快速動作以複製結構描述的JSON結構,或刪除結構(如果尚未為即時客戶個人檔案啟用或具有關聯的資料集)。 選取檢視頂端的更多,以顯示包含快速動作的下拉式清單。
複製JSON結構功能可讓您檢視當您仍在建置結構描述和資料管道時,範例裝載的外觀。 在架構中有複雜的物件對應結構(例如身分對應)的情況下,此功能特別實用。
顯示名稱切換 display-name-toggle
為方便起見,架構編輯器提供切換功能,以在原始欄位名稱與較容易讀取的顯示名稱之間變更。 此彈性可改善欄位發現能力及結構描述的編輯。 此切換位於架構編輯器檢視的右上角。
標準欄位群組的顯示名稱是由系統產生,但可以自訂,如顯示名稱區段中所述。 顯示名稱會反映在多個UI檢視中,包括對應和資料集預覽。 預設設定為關閉,且會依欄位名稱的原始值顯示欄位名稱。
將欄位群組新增到結構描述 add-field-groups
在Schema Editor中開啟結構描述後,您就可以使用欄位群組將欄位新增到結構描述。 若要開始,請選取左側邊欄中 欄位群組 旁的 新增。
此時會出現一個對話方塊,顯示您可以為結構描述選取的欄位群組清單。 由於欄位群組僅與一個類別相容,因此只會列出與結構描述所選類別相關聯的欄位群組。 依預設,列出的欄位群組會根據其在您組織內的使用人氣排序。
如果您知道要新增欄位的一般活動或業務區域,請在左側邊欄中選取一或多個垂直產業類別,以篩選顯示的欄位群組清單。
您也可以使用搜尋列來協助找出您想要的欄位群組。 名稱與查詢相符的欄位群組會出現在清單頂端。 在 標準欄位 下,會顯示包含描述所需資料屬性的欄位群組。
選取您要新增至結構描述的欄位群組名稱旁的核取方塊。 您可以從清單中選取多個欄位群組,每個選取的欄位群組都會顯示在右側邊欄中。
選擇欄位群組後,選取 新增欄位群組 以將其新增到結構描述。
Schema Editor會重新出現,畫布中會顯示欄位群組提供的欄位。
移除從欄位群組新增的欄位 remove-fields
將欄位群組新增到結構描述後,您可以移除任何不需要的欄位。
在下列範例中,已將標準欄位群組 人口統計詳細資料 新增到結構描述。 若要移除單一欄位(例如taxId
),請選取畫布中的欄位,然後在右側邊欄中選取 移除。
如果您想要移除多個欄位,可以整體管理欄位群組。 在畫布中選取屬於群組的欄位,然後在右側邊欄中選取 管理相關欄位。
會出現一個對話方塊,顯示相關欄位群組的結構。 在此,您可以使用提供的核取方塊來選取或取消選取所需的欄位。 在您滿意後,請選取 確認。
畫布會重新出現,架構結構中只會顯示選取的欄位。
新增自訂欄位至欄位群組 add-fields
將欄位群組新增到結構描述後,您可以為該群組定義其他欄位。 但是,在一個結構描述中新增到欄位群組的任何欄位也會出現在採用相同欄位群組的所有其他結構描述中。
此外,如果將自訂欄位新增到標準欄位群組,則該欄位群組將轉換為自訂欄位群組,並且原始標準欄位群組將不再可用。
如果您想要將自訂欄位新增到標準欄位群組,請參閱下方的區段以取得特定指示。 如果您要將欄位新增到自訂欄位群組,請參閱欄位群組UI指南中編輯自訂欄位群組的相關章節。
如果您不想變更任何現有的欄位群組,可以建立新的自訂欄位群組來定義其他欄位。
將個別欄位新增到結構描述 add-individual-fields
如果您想避免針對特定使用案例新增整個欄位群組,結構描述編輯器可讓您將個別欄位直接新增到結構描述。 您可以從標準欄位群組新增個別欄位,或是改為新增您自己的自訂欄位。
新增標準欄位 add-standard-fields
您可以將標準欄位群組中的欄位直接新增到結構描述,而無需預先知道其對應的欄位群組。 若要將標準欄位新增到結構描述,請在畫布中選取結構描述名稱旁的加號(+)圖示。 結構描述結構中出現 未命名的欄位 預留位置,且右側邊欄更新以顯示設定欄位的控制項。
在 欄位名稱 下,開始輸入您要新增的欄位名稱。 系統會自動搜尋符合查詢的標準欄位,並在 建議的標準欄位 下列出它們,包括它們所屬的欄位群組。
雖然有些標準欄位會共用相同的名稱,但其結構可能會依其來源欄位群組而有所不同。 如果標準欄位巢狀內嵌在欄位群組結構的父物件中,則新增子欄位時,父欄位也會包含在結構描述中。
選取標準欄位旁的預覽圖示( )以檢視其欄位群組的結構,並更瞭解其巢狀化方式。 若要將標準欄位新增至結構描述,請選取加號圖示( )。
畫布更新以顯示新增到結構描述的標準欄位,包括它巢狀內嵌在欄位群組結構下的任何父欄位。 欄位群組的名稱也會列在左側邊欄的 欄位群組 下。 如果您想要從相同的欄位群組新增更多欄位,請在右側邊欄中選取 管理相關欄位。
新增自訂欄位 add-custom-fields
與標準欄位的工作流程類似,您也可以將自己的自訂欄位直接新增到結構描述。
若要將欄位新增至結構描述的根層級,請在畫布中選取結構描述名稱旁的加號(+)圖示。 結構描述結構中出現 未命名的欄位 預留位置,且右側邊欄更新以顯示設定欄位的控制項。
開始輸入您要新增的欄位名稱,系統就會自動開始搜尋相符的標準欄位。 若要建立新的自訂欄位,請選取附加 (新欄位) 的頂端選項。
為欄位提供顯示名稱和資料型別後,下一步是將欄位指派給父XDM資源。 如果您的結構描述使用自訂類別,您可以選擇將欄位新增到指派的類別或欄位群組。 但是,如果您的結構描述使用標準類別,則只能將自訂欄位指派給欄位群組。
將欄位指派給自訂欄位群組 add-to-field-group
在 指派給 下,選取 欄位群組。 如果您的結構描述使用標準類別,這是唯一可用的選項,並且預設會選取此選項。
接下來,您必須選取要與新欄位產生關聯的欄位群組。 在提供的文字輸入中開始鍵入欄位群組的名稱。 如果您有任何符合輸入的現有自訂欄位群組,它們將會顯示在下拉式清單中。 或者,您可以鍵入唯一名稱來建立新的欄位群組。
從清單中選取欄位群組後,選取 套用。
新欄位已新增到畫布中,並且已在您的租使用者識別碼下命名,以避免與標準XDM欄位衝突。 與新欄位相關聯的欄位群組也出現在左側邊欄的 欄位群組 下。
將欄位指派給自訂類別 add-to-class
在 指派給 下,選取 類別。 下列輸入欄位會以目前結構描述的自訂類別名稱取代,表示新欄位將會指派給此類別。
繼續視需要設定欄位,並在完成後選取 套用。
正在為新欄位選取
新欄位已新增到畫布中,並且已在您的租使用者識別碼下命名,以避免與標準XDM欄位衝突。 在左側邊欄中選取類別名稱,會顯示新欄位作為類別結構的一部分。
將自訂欄位新增至標準欄位群組的結構 custom-fields-for-standard-groups
如果您使用的結構描述具有由標準欄位群組提供的物件型別欄位,您可以將自己的自訂欄位新增到該標準物件。
若要開始,請選取標準欄位群組所提供之物件根目錄旁的加號(+)圖示。
系統會顯示警告訊息,提示您確認是否要轉換標準欄位群組。 選取 繼續建立欄位群組 以繼續。
畫布會重新出現,新欄位會有一個未命名的預留位置。 請注意,標準欄位群組的名稱已附加"(Extended)",表示已從原始版本修改它。 從這裡,使用右側邊欄中的控制項來定義欄位的屬性。
套用變更後,新欄位會顯示在標準物件的租使用者ID名稱空間下。 此巢狀名稱空間可防止欄位群組內的欄位名稱衝突,以避免使用相同欄位群組的其他結構描述發生變更。
啟用即時客戶設定檔的方案 profile
即時客戶設定檔會合併來自不同來源的資料,以建構每個個別客戶的完整檢視。 若要讓結構描述擷取的資料參與此程式,您必須啟用結構描述以在Profile中使用。
若要啟用結構描述,請從左側邊欄中選取結構描述名稱開始,然後在右側邊欄中選取「設定檔」切換按鈕。
此時畫面會顯示彈出視窗,警告您一旦啟用並儲存結構描述,就無法停用它。 選取 啟用 以繼續。
畫布會重新出現,並啟用設定檔切換。
若要完成程式,請選取 儲存 以儲存結構描述。
結構描述現在已啟用以用於即時客戶個人檔案。 當Platform根據此結構描述將資料內嵌到資料集時,該資料將合併到您的整合設定檔資料中。
編輯結構欄位的顯示名稱 display-names
指派類別並將欄位群組新增至結構描述後,您可以編輯任何結構描述欄位的顯示名稱,無論這些欄位是由標準或自訂XDM資源提供。
若要編輯綱要欄位的顯示名稱,請選取畫布中的欄位。 在右邊欄中,在 顯示名稱 下提供新名稱。
在右側邊欄中選取「套用」,畫布會更新以顯示欄位的新顯示名稱。 選取 儲存 將變更套用至結構描述。
變更結構描述的類別 change-class
您可以在儲存結構描述之前,在初始構成程式期間隨時變更結構描述的類別。
若要重新指派類別,請在畫布左側選取 指派。
會出現一個對話方塊,其中顯示所有可用類別的清單,包括貴組織定義的任何類別(擁有者為"Customer")以及Adobe定義的標準類別。
從清單中選取類別,以在對話方塊的右側顯示其說明。 您也可以選取 預覽類別結構 以檢視與類別關聯的欄位和中繼資料。 選取 指派類別 以繼續。
隨即開啟新的對話方塊,要求您確認要指派新類別。 選取 指派 以進行確認。
確認類別變更後,畫布將會重設,並且所有構成進度將會遺失。
後續步驟 next-steps
本檔案說明在Platform UI中建立和編輯結構描述的基本知識。 強烈建議您檢閱結構描述建立教學課程,以取得在UI中建立完整結構描述的完整工作流程,包括建立自訂欄位群組和獨特使用案例的資料型別。
如需結構描述工作區功能的詳細資訊,請參閱結構描述工作區概觀。
若要瞭解如何在Schema Registry API中管理結構描述,請參閱結構描述端點指南。