在 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中,您可以使用欄位群組來新增欄位至結構描述。 若要開始,請選取 新增 旁邊 欄位群組 在左側邊欄中。
此時會出現一個對話方塊,顯示您可以為結構描述選取的欄位群組清單。 由於欄位群組僅與一個類別相容,因此只會列出與結構描述所選類別相關聯的欄位群組。 依預設,列出的欄位群組會根據其在您組織內的使用人氣排序。
如果您知道要新增欄位的一般活動或業務區域,請在左側邊欄中選取一或多個垂直產業類別,以篩選顯示的欄位群組清單。
您也可以使用搜尋列來協助找出您想要的欄位群組。 名稱與查詢相符的欄位群組會出現在清單頂端。 在 標準欄位,包含描述所需資料屬性之欄位的欄位群組隨即顯示。
選取您要新增至結構描述的欄位群組名稱旁的核取方塊。 您可以從清單中選取多個欄位群組,每個選取的欄位群組都會顯示在右側邊欄中。
![](./media_1a6d2e83eb0e9e0008767913bccf4fc4ac272b1bc.png?width=750&format=png&optimize=medium)
![](./media_1aedf01b8b2d54f198809e85437a9c3fc4c9bbdaf.png?width=750&format=png&optimize=medium)
選擇欄位群組後,選擇 新增欄位群組 以將它們新增至結構描述。
此 Schema Editor 會以畫布中顯示的欄位群組提供的欄位重新出現。
![掛鎖圖示。](./media_182eacb565600f2eae322d4e7ac11bb9d3e241084.png?width=750&format=png&optimize=medium)
![反白顯示掛鎖圖示的結構描述編輯器](./media_1d973f8ffd6b50aed643758d180f2a2cf2f3b11c1.png?width=750&format=png&optimize=medium)
移除從欄位群組新增的欄位 remove-fields
將欄位群組新增到結構描述後,您可以移除任何不需要的欄位。
在以下範例中,標準欄位群組 人口統計細節 已新增至結構描述。 若要移除單一欄位,例如 taxId
,選取畫布中的欄位,然後選取「 」 移除 在右側邊欄中。
如果您想要移除多個欄位,可以整體管理欄位群組。 在畫布中選取屬於群組的欄位,然後選取 管理相關欄位 在右側邊欄中。
會出現一個對話方塊,顯示相關欄位群組的結構。 在此,您可以使用提供的核取方塊來選取或取消選取所需的欄位。 滿意後,選取 確認.
畫布會重新出現,架構結構中只會顯示選取的欄位。
新增自訂欄位至欄位群組 add-fields
將欄位群組新增到結構描述後,您可以為該群組定義其他欄位。 但是,在一個結構描述中新增到欄位群組的任何欄位也會出現在採用相同欄位群組的所有其他結構描述中。
此外,如果將自訂欄位新增到標準欄位群組,則該欄位群組將轉換為自訂欄位群組,並且原始標準欄位群組將不再可用。
如果要將自訂欄位新增到標準欄位群組,請參閱 區段如下 以取得特定指示。 如果您新增欄位至自訂欄位群組,請參閱以下章節: 編輯自訂欄位群組 在欄位群組UI指南中。
如果您不想變更任何現有的欄位群組,您可以 建立新的自訂欄位群組 以定義其他欄位。
將個別欄位新增到結構描述 add-individual-fields
如果您想避免針對特定使用案例新增整個欄位群組,結構描述編輯器可讓您將個別欄位直接新增到結構描述。 您可以 從標準欄位群組新增個別欄位 或 新增您自己的自訂欄位 而非。
新增標準欄位 add-standard-fields
您可以將標準欄位群組中的欄位直接新增到結構描述,而無需預先知道其對應的欄位群組。 若要將標準欄位新增到結構描述,請選取加號(+)圖示加以識別(位於畫布中的結構描述名稱旁)。 一個 未命名的欄位 結構描述結構中會顯示預留位置,而右側邊欄會更新,顯示設定欄位的控制項。
在 欄位名稱,開始輸入您要新增的欄位名稱。 系統會自動搜尋符合查詢的標準欄位,並將其列在下 建議的標準欄位,包括他們所屬的欄位群組。
雖然有些標準欄位會共用相同的名稱,但其結構可能會依其來源欄位群組而有所不同。 如果標準欄位巢狀內嵌在欄位群組結構的父物件中,則新增子欄位時,父欄位也會包含在結構描述中。
選取預覽圖示(
畫布更新以顯示新增到結構描述的標準欄位,包括它巢狀內嵌在欄位群組結構下的任何父欄位。 欄位群組的名稱也會列在 欄位群組 在左側邊欄中。 如果您想從相同的欄位群組新增更多欄位,請選取 管理相關欄位 在右側邊欄中。
新增自訂欄位 add-custom-fields
與標準欄位的工作流程類似,您也可以將自己的自訂欄位直接新增到結構描述。
若要將欄位新增至結構的根層級,請選取加號(+)圖示加以識別(位於畫布中的結構描述名稱旁)。 一個 未命名的欄位 結構描述結構中會顯示預留位置,而右側邊欄會更新,顯示設定欄位的控制項。
開始輸入您要新增的欄位名稱,系統就會自動開始搜尋相符的標準欄位。 若要建立新的自訂欄位,請選取最上方的附加選項 (新欄位).
為欄位提供顯示名稱和資料型別後,下一步是將欄位指派給父XDM資源。 如果您的結構描述使用自訂類別,您可以選擇 將欄位新增到指派的類別 或 欄位群組 而非。 但是,如果您的結構描述使用標準類別,則只能將自訂欄位指派給欄位群組。
將欄位指派給自訂欄位群組 add-to-field-group
在 指派給,選取 欄位群組. 如果您的結構描述使用標準類別,這是唯一可用的選項,並且預設會選取此選項。
接下來,您必須選取要與新欄位產生關聯的欄位群組。 在提供的文字輸入中開始鍵入欄位群組的名稱。 如果您有任何符合輸入的現有自訂欄位群組,它們將會顯示在下拉式清單中。 或者,您可以鍵入唯一名稱來建立新的欄位群組。
從清單中選取欄位群組後,選取 套用.
新欄位會新增到畫布中,並在 租使用者ID 以避免與標準XDM欄位衝突。 與新欄位相關聯的欄位群組也會顯示在下方 欄位群組 在左側邊欄中。
將欄位指派給自訂類別 add-to-class
在 指派給,選取 類別. 下列輸入欄位會以目前結構描述的自訂類別名稱取代,表示新欄位將會指派給此類別。
繼續視需要設定欄位並選取 套用 完成後。
新欄位會新增到畫布中,並在 租使用者ID 以避免與標準XDM欄位衝突。 在左側邊欄中選取類別名稱,會顯示新欄位作為類別結構的一部分。
將自訂欄位新增至標準欄位群組的結構 custom-fields-for-standard-groups
如果您使用的結構描述具有由標準欄位群組提供的物件型別欄位,您可以將自己的自訂欄位新增到該標準物件。
![轉換標準欄位群組的確認對話方塊](./media_1eeda5336c2fc2516a51648588a901f94faf80786.png?width=750&format=png&optimize=medium)
若要開始,請選取加號(+)圖示,位於標準欄位群組提供的物件根目錄旁。
系統會顯示警告訊息,提示您確認是否要轉換標準欄位群組。 選取 繼續建立欄位群組 以繼續進行。
畫布會重新出現,新欄位會有一個未命名的預留位置。 請注意,標準欄位群組的名稱已附加"(延伸)」以表示它已從原始版本修改。 從這裡,使用右側邊欄中的控制項來定義欄位的屬性。
套用變更後,新欄位會顯示在標準物件的租使用者ID名稱空間下。 此巢狀名稱空間可防止欄位群組內的欄位名稱衝突,以避免使用相同欄位群組的其他結構描述發生變更。
為即時客戶個人檔案啟用結構 profile
即時客戶個人檔案 合併來自不同來源的資料,以建構每個個別客戶的完整檢視。 如果您希望結構描述擷取的資料參與此程式,您必須啟用結構描述以供使用 Profile.
若要啟用結構描述,請從左側邊欄中選取結構描述名稱開始,然後選取 個人資料 在右側邊欄中切換。
此時畫面會顯示彈出視窗,警告您一旦啟用並儲存結構描述,就無法停用它。 選取 啟用 以繼續。
畫布會重新出現,其中包含 個人資料 切換已啟用。
若要完成程式,請選取 儲存 以儲存結構。
結構描述現在已啟用以用於即時客戶個人檔案。 當Platform根據此結構描述將資料內嵌到資料集時,該資料將合併到您的整合設定檔資料中。
編輯結構欄位的顯示名稱 display-names
指派類別並將欄位群組新增至結構描述後,您可以編輯任何結構描述欄位的顯示名稱,無論這些欄位是由標準或自訂XDM資源提供。
若要編輯綱要欄位的顯示名稱,請選取畫布中的欄位。 在右邊欄中,於下方提供新名稱 顯示名稱.
選取 套用 而畫布會更新,顯示該欄位的新顯示名稱。 選取 儲存 將變更套用至結構描述。
變更結構描述的類別 change-class
您可以在儲存結構描述之前,在初始構成程式期間隨時變更結構描述的類別。
若要重新指派類別,請選取 指派 在畫布的左側。
會出現一個對話方塊,顯示所有可用類別的清單,包括貴組織定義的任何類別(擁有者為「客戶「)以及由Adobe定義的標準類別。
從清單中選取類別,以在對話方塊的右側顯示其說明。 您也可以選取 預覽類別結構 檢視與類別關聯的欄位和中繼資料。 選取 指派類別 以繼續。
隨即開啟新的對話方塊,要求您確認要指派新類別。 選取 指派 以確認。
確認類別變更後,畫布將會重設,並且所有構成進度將會遺失。
後續步驟 next-steps
本檔案說明在Platform UI中建立和編輯結構描述的基本知識。 強烈建議您檢閱 結構描述建立教學課程 適用於在UI中建置完整方案的完整工作流程,包括建立自訂欄位群組,以及獨特使用案例的資料型別。
如需功能的詳細資訊, 方案 工作區,請參閱 方案 工作區概觀.
若要瞭解如何在中管理結構描述 Schema Registry API,請參閱 結構描述端點指南.