在 UI 中建立和編輯綱要 create-edit-schemas-in-ui

本指南概述如何在Adobe Experience Platform UI中建立、編輯及管理貴組織的Experience Data Model (XDM)方案。

IMPORTANT
XDM結構描述是極為可自訂的,因此建立結構描述的相關步驟可能會因您想要結構描述擷取的資料型別而異。 因此,本檔案僅涵蓋您可以在UI中與結構描述進行的基本互動,並排除自訂類別、結構描述欄位群組、資料型別和欄位等相關步驟。
如需結構描述建立程式的完整導覽,請連同結構描述建立教學課程一起建立完整的範例結構描述,並熟悉Schema Editor的許多功能。

先決條件 prerequisites

本指南需要實際瞭解XDM系統。 請參閱XDM總覽,瞭解XDM在Experience Platform生態系統中的角色簡介,以及結構描述組合基本概念,瞭解結構描述建構方式的總覽。

建立新結構描述 create

NOTE
本節說明如何在UI中手動建立新結構描述。 如果您正在將CSV資料擷取至Platform,您可以選擇將該資料對應到AI產生的建議所建立的XDM結構描述(目前為測試版),而無需自行手動建立結構描述。

在結構描述工作區中,選取右上角的​ 建立結構描述

反白顯示建立結構描述的結構描述工作區。

建立結構描述工作流程隨即顯示。 您可以選取​ 個別設定檔體驗事件 ​或​ 其他,接著選取​ 下一步 ​以確認您的選擇,為結構描述選擇基底類別。 如需這些類別的詳細資訊,請參閱XDM個別設定檔XDM ExperienceEvent檔案。

使用三個類別選項和下一步反白顯示的建立結構描述工作流程。

選取類別之後,名稱和檢閱區段就會顯示。 您可以在此段落中提供名稱和說明,以識別您的結構描述。​URL結構描述的基本結構(由類別提供)會顯示在畫布中,供您檢閱及驗證選取的類別和結構描述結構。

在文字欄位中輸入人性化的結構描述顯示名稱。 接下來,輸入適當的說明來協助識別您的結構描述。 當您檢閱了結構描述結構並對您的設定感到滿意時,請選取​ 完成 ​以建立結構描述。

使用結構描述顯示名稱、描述和完成反白顯示建立結構描述工作流程的名稱和檢閱區段。

結構描述 瀏覽索引標籤出現。 您最近建立的結構描述現在列於結構描述資料庫中,並可在Schema Editor中編輯。

顯示您最近建立之結構描述的結構描述工作區瀏覽標籤。

編輯現有結構描述 edit

NOTE
一旦結構描述已儲存並用於資料擷取中,就只能對其執行加總變更。 如需詳細資訊,請參閱結構描述演化🔗的規則。

若要編輯現有結構描述,請選取​ 瀏覽 ​標籤,然後選取您要編輯的結構描述名稱。 您也可以使用搜尋列來縮小可用選項清單的範圍。

反白結構描述的結構描述工作區。

TIP
您可以使用工作區的搜尋和篩選功能來協助您更輕鬆地尋找結構。 如需詳細資訊,請參閱探索XDM資源的指南。

選取結構描述後,Schema Editor會出現,其結構描述結構顯示在畫布中。 您現在可以新增欄位群組到結構描述(或是新增這些群組中的個別欄位)、編輯欄位顯示名稱編輯現有的自訂欄位群組 (如果結構描述採用任何群組)。

更多動作 more

在結構編輯器中,您還可以執行快速動作以複製結構描述的JSON結構,或刪除結構(如果尚未為即時客戶個人檔案啟用或具有關聯的資料集)。 選取檢視頂端的更多,以顯示包含快速動作的下拉式清單。

複製JSON結構功能可讓您檢視當您仍在建置結構描述和資料管道時,範例裝載的外觀。 在架構中有複雜的物件對應結構(例如身分對應)的情況下,此功能特別實用。

結構描述編輯器的[更多]按鈕反白顯示,並顯示下拉式選項。

顯示名稱切換 display-name-toggle

為方便起見,架構編輯器提供切換功能,以在原始欄位名稱與較容易讀取的顯示名稱之間變更。 此彈性可改善欄位發現能力及結構描述的編輯。 此切換位於架構編輯器檢視的右上角。

NOTE
從欄位名稱到顯示名稱的變更純粹是裝飾性的,不會變更任何下游資源。

結構描述編輯器顯示反白顯示欄位的顯示名稱。

標準欄位群組的顯示名稱是由系統產生,但可以自訂,如顯示名稱區段中所述。 顯示名稱會反映在多個UI檢視中,包括對應和資料集預覽。 預設設定為關閉,且會依欄位名稱的原始值顯示欄位名稱。

將欄位群組新增到結構描述 add-field-groups

NOTE
本節說明如何將現有欄位群組新增至結構描述。 如果您想要建立新的自訂欄位群組,請改為參閱建立和編輯欄位群組的指南。

在Schema Editor中開啟結構描述後,您就可以使用欄位群組將欄位新增到結構描述。 若要開始,請選取左側邊欄中​ 欄位群組 ​旁的​ 新增

結構描述編輯器已反白顯示欄位群組區段中的新增。

此時會出現一個對話方塊,顯示您可以為結構描述選取的欄位群組清單。 由於欄位群組僅與一個類別相容,因此只會列出與結構描述所選類別相關聯的欄位群組。 依預設,列出的欄位群組會根據其在您組織內的使用人氣排序。

反白顯示熱門程度欄的新增欄位群組對話方塊。

如果您知道要新增欄位的一般活動或業務區域,請在左側邊欄中選取一或多個垂直產業類別,以篩選顯示的欄位群組清單。

以產業篩選器強調的新增欄位群組對話方塊,以及強調的產業欄。

NOTE
如需XDM中特定產業資料模型最佳實務的詳細資訊,請參閱有關產業資料模型的檔案。

您也可以使用搜尋列來協助找出您想要的欄位群組。 名稱與查詢相符的欄位群組會出現在清單頂端。 在​ 標準欄位 ​下,會顯示包含描述所需資料屬性的欄位群組。

使用標準欄位搜尋函式的新增欄位群組對話方塊已反白顯示。

選取您要新增至結構描述的欄位群組名稱旁的核取方塊。 您可以從清單中選取多個欄位群組,每個選取的欄位群組都會顯示在右側邊欄中。

反白顯示核取方塊選取功能的新增欄位群組對話方塊。

TIP
對於任何列出的欄位群組,您可以暫留或聚焦在資訊圖示( )上,以檢視欄位群組擷取的資料型別的簡短說明。 您也可以選取預覽圖示( )來檢視欄位群組提供的欄位結構,然後再決定將其新增至結構描述。

選擇欄位群組後,選取​ 新增欄位群組 ​以將其新增到結構描述。

已選取欄位群組且新增欄位群組反白顯示的新增欄位群組對話方塊。

Schema Editor會重新出現,畫布中會顯示欄位群組提供的欄位。

顯示具有範例結構描述的Schema Editor。

NOTE
在結構描述編輯器中,標準(Adobe產生的)類別和欄位群組會以掛鎖圖示( 掛鎖圖示表示。 。掛鎖會顯示在類別或欄位群組名稱旁的左側邊欄中,也會顯示在架構圖表中,屬於系統產生資源之一部分的任何欄位旁邊。
結構描述編輯器反白顯示掛鎖圖示

將欄位群組新增到結構描述之後,您可以視您的需求,選擇性移除現有的欄位新增自訂欄位到這些群組。

移除從欄位群組新增的欄位 remove-fields

將欄位群組新增到結構描述後,您可以移除任何不需要的欄位。

NOTE
從欄位群組中移除欄位只會影響正在處理的結構描述,不會影響欄位群組本身。 如果您移除一個結構描述中的欄位,這些欄位仍然可在採用相同欄位群組的所有其他結構描述中使用。

在下列範例中,已將標準欄位群組​ 人口統計詳細資料 ​新增到結構描述。 若要移除單一欄位(例如taxId),請選取畫布中的欄位,然後在右側邊欄中選取​ 移除

反白顯示移除的Schema Editor。 此動作移除單一欄位。

如果您想要移除多個欄位,可以整體管理欄位群組。 在畫布中選取屬於群組的欄位,然後在右側邊欄中選取​ 管理相關欄位

標示有管理相關欄位的Schema Editor。

會出現一個對話方塊,顯示相關欄位群組的結構。 在此,您可以使用提供的核取方塊來選取或取消選取所需的欄位。 在您滿意後,請選取​ 確認

包含所選欄位和確認的管理相關欄位對話方塊已強調顯示。

畫布會重新出現,架構結構中只會顯示選取的欄位。

欄位已新增

新增自訂欄位至欄位群組 add-fields

將欄位群組新增到結構描述後,您可以為該群組定義其他欄位。 但是,在一個結構描述中新增到欄位群組的任何欄位也會出現在採用相同欄位群組的所有其他結構描述中。

此外,如果將自訂欄位新增到標準欄位群組,則該欄位群組將轉換為自訂欄位群組,並且原始標準欄位群組將不再可用。

如果您想要將自訂欄位新增到標準欄位群組,請參閱下方的區段以取得特定指示。 如果您要將欄位新增到自訂欄位群組,請參閱欄位群組UI指南中編輯自訂欄位群組的相關章節。

如果您不想變更任何現有的欄位群組,可以建立新的自訂欄位群組來定義其他欄位。

將個別欄位新增到結構描述 add-individual-fields

如果您想避免針對特定使用案例新增整個欄位群組,結構描述編輯器可讓您將個別欄位直接新增到結構描述。 您可以從標準欄位群組新增個別欄位,或是改為新增您自己的自訂欄位

IMPORTANT
即使結構描述編輯器在功能上允許您直接將個別欄位新增到結構描述,這不會變更XDM結構描述中的所有欄位必須由其類別或與該類相容的欄位群組提供。 如以下各節所說明,當所有個別欄位新增到結構描述中時,作為關鍵步驟,它們仍會與類別或欄位群組相關聯。

新增標準欄位 add-standard-fields

您可以將標準欄位群組中的欄位直接新增到結構描述,而無需預先知道其對應的欄位群組。 若要將標準欄位新增到結構描述,請在畫布中選取結構描述名稱旁的加號(+)圖示。 結構描述結構中出現​ 未命名的欄位 ​預留位置,且右側邊欄更新以顯示設定欄位的控制項。

欄位預留位置

在​ 欄位名稱 ​下,開始輸入您要新增的欄位名稱。 系統會自動搜尋符合查詢的標準欄位,並在​ 建議的標準欄位 ​下列出它們,包括它們所屬的欄位群組。

建議的標準欄位

雖然有些標準欄位會共用相同的名稱,但其結構可能會依其來源欄位群組而有所不同。 如果標準欄位巢狀內嵌在欄位群組結構的父物件中,則新增子欄位時,父欄位也會包含在結構描述中。

選取標準欄位旁的預覽圖示( 預覽圖示 )以檢視其欄位群組的結構,並更瞭解其巢狀化方式。 若要將標準欄位新增至結構描述,請選取加號圖示( 加號圖示 )。

新增標準欄位

畫布更新以顯示新增到結構描述的標準欄位,包括它巢狀內嵌在欄位群組結構下的任何父欄位。 欄位群組的名稱也會列在左側邊欄的​ 欄位群組 ​下。 如果您想要從相同的欄位群組新增更多欄位,請在右側邊欄中選取​ 管理相關欄位

標準欄位已新增

新增自訂欄位 add-custom-fields

與標準欄位的工作流程類似,您也可以將自己的自訂欄位直接新增到結構描述。

若要將欄位新增至結構描述的根層級,請在畫布中選取結構描述名稱旁的加號(+)圖示。 結構描述結構中出現​ 未命名的欄位 ​預留位置,且右側邊欄更新以顯示設定欄位的控制項。

根目錄自訂欄位

開始輸入您要新增的欄位名稱,系統就會自動開始搜尋相符的標準欄位。 若要建立新的自訂欄位,請選取附加​ (新欄位) ​的頂端選項。

新欄位

為欄位提供顯示名稱和資料型別後,下一步是將欄位指派給父XDM資源。 如果您的結構描述使用自訂類別,您可以選擇將欄位新增到指派的類別欄位群組。 但是,如果您的結構描述使用標準類別,則只能將自訂欄位指派給欄位群組。

將欄位指派給自訂欄位群組 add-to-field-group

NOTE
本節僅涵蓋如何將欄位指派給自訂欄位群組。 如果您想改用新的自訂欄位來擴充標準欄位群組,請參閱將自訂欄位新增至標準欄位群組一節。

在​ 指派給 ​下,選取​ 欄位群組。 如果您的結構描述使用標準類別,這是唯一可用的選項,並且預設會選取此選項。

接下來,您必須選取要與新欄位產生關聯的欄位群組。 在提供的文字輸入中開始鍵入欄位群組的名稱。 如果您有任何符合輸入的現有自訂欄位群組,它們將會顯示在下拉式清單中。 或者,您可以鍵入唯一名稱來建立新的欄位群組。

選取欄位群組

WARNING
如果您選取現有的自訂欄位群組,則採用該欄位群組的任何其他結構描述在您儲存變更後,也將繼承新新增的欄位。 因此,如果您想要此型別的傳輸,請僅選取現有的欄位群組。 否則,您應該選擇建立新的自訂欄位群組。

從清單中選取欄位群組後,選取​ 套用

套用欄位

新欄位已新增到畫布中,並且已在您的租使用者識別碼下命名,以避免與標準XDM欄位衝突。 與新欄位相關聯的欄位群組也出現在左側邊欄的​ 欄位群組 ​下。

租使用者識別碼

NOTE
依預設,所選自訂欄位群組提供的其餘欄位會從結構描述中移除。 如果要將其中一些欄位新增到結構描述中,請選取屬於該群組的欄位,然後在右側邊欄中選取​ 管理相關欄位

將欄位指派給自訂類別 add-to-class

在​ 指派給 ​下,選取​ 類別。 下列輸入欄位會以目前結構描述的自訂類別名稱取代,表示新欄位將會指派給此類別。

正在為新欄位指派選取類別選項。

繼續視需要設定欄位,並在完成後選取​ 套用

正在為新欄位選取 套用。

新欄位已新增到畫布中,並且已在您的租使用者識別碼下命名,以避免與標準XDM欄位衝突。 在左側邊欄中選取類別名稱,會顯示新欄位作為類別結構的一部分。

套用至自訂類別結構的新欄位,以畫布表示。

將自訂欄位新增至標準欄位群組的結構 custom-fields-for-standard-groups

如果您使用的結構描述具有由標準欄位群組提供的物件型別欄位,您可以將自己的自訂欄位新增到該標準物件。

WARNING
在一個結構描述中新增到欄位群組的任何欄位也會出現在採用相同欄位群組的所有其他結構描述中。 此外,如果將自訂欄位新增到標準欄位群組,則該欄位群組將轉換為自訂欄位群組,並且原始標準欄位群組將不再可用。
如果您參與此功能的測試版,您將會收到一個對話方塊,通知您之前已自訂的標準欄位群組。 選取​ 認可 ​後,列出的資源就會轉換為自訂欄位群組。
轉換標準欄位群組的確認對話方塊

若要開始,請選取標準欄位群組所提供之物件根目錄旁的加號(+)圖示。

新增欄位至標準物件

系統會顯示警告訊息,提示您確認是否要轉換標準欄位群組。 選取​ 繼續建立欄位群組 ​以繼續。

確認欄位群組轉換

畫布會重新出現,新欄位會有一個未命名的預留位置。 請注意,標準欄位群組的名稱已附加"(Extended)",表示已從原始版本修改它。 從這裡,使用右側邊欄中的控制項來定義欄位的屬性。

欄位已新增至標準物件

套用變更後,新欄位會顯示在標準物件的租使用者ID名稱空間下。 此巢狀名稱空間可防止欄位群組內的欄位名稱衝突,以避免使用相同欄位群組的其他結構描述發生變更。

欄位已新增至標準物件

啟用即時客戶設定檔的方案 profile

即時客戶設定檔會合併來自不同來源的資料,以建構每個個別客戶的完整檢視。 若要讓結構描述擷取的資料參與此程式,您必須啟用結構描述以在Profile中使用。

IMPORTANT
為了啟用Profile的結構描述,它必須定義主要身分欄位。 如需詳細資訊,請參閱定義身分欄位的指南。

若要啟用結構描述,請從左側邊欄中選取結構描述名稱開始,然後在右側邊欄中選取「設定檔」切換按鈕。

此時畫面會顯示彈出視窗,警告您一旦啟用並儲存結構描述,就無法停用它。 選取​ 啟用 ​以繼續。

畫布會重新出現,並啟用設定檔切換。

IMPORTANT
由於結構描述尚未儲存,如果您改變主意,要讓結構描述參與即時客戶設定檔,就沒有回訪點:儲存啟用的結構描述後,就無法再停用它。 再次選取​ 設定檔 ​切換以停用結構描述。

若要完成程式,請選取​ 儲存 ​以儲存結構描述。

結構描述現在已啟用以用於即時客戶個人檔案。 當Platform根據此結構描述將資料內嵌到資料集時,該資料將合併到您的整合設定檔資料中。

編輯結構欄位的顯示名稱 display-names

指派類別並將欄位群組新增至結構描述後,您可以編輯任何結構描述欄位的顯示名稱,無論這些欄位是由標準或自訂XDM資源提供。

NOTE
請記住,屬於標準類別或欄位群組的欄位顯示名稱只能在特定結構描述的內容中編輯。 換言之,變更一個結構描述中標準欄位的顯示名稱不會影響其他採用相同關聯類別或欄位群組的結構描述。
一旦您變更了結構描述的欄位顯示名稱,這些變更就會立即反映在基於該結構描述的現有資料集中。

若要編輯綱要欄位的顯示名稱,請選取畫布中的欄位。 在右邊欄中,在​ 顯示名稱 ​下提供新名稱。

在右側邊欄中選取「套用」,畫布會更新以顯示欄位的新顯示名稱。 選取​ 儲存 ​將變更套用至結構描述。

變更結構描述的類別 change-class

您可以在儲存結構描述之前,在初始構成程式期間隨時變更結構描述的類別。

WARNING
為結構描述重新指派類別時應格外小心。 欄位群組僅與某些類別相容,因此變更類別將會重設畫布以及您新增的任何欄位。

若要重新指派類別,請在畫布左側選取​ 指派

會出現一個對話方塊,其中顯示所有可用類別的清單,包括貴組織定義的任何類別(擁有者為"Customer")以及Adobe定義的標準類別。

從清單中選取類別,以在對話方塊的右側顯示其說明。 您也可以選取​ 預覽類別結構 ​以檢視與類別關聯的欄位和中繼資料。 選取​ 指派類別 ​以繼續。

隨即開啟新的對話方塊,要求您確認要指派新類別。 選取​ 指派 ​以進行確認。

確認類別變更後,畫布將會重設,並且所有構成進度將會遺失。

後續步驟 next-steps

本檔案說明在Platform UI中建立和編輯結構描述的基本知識。 強烈建議您檢閱結構描述建立教學課程,以取得在UI中建立完整結構描述的完整工作流程,包括建立自訂欄位群組和獨特使用案例的資料型別。

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

若要瞭解如何在Schema Registry API中管理結構描述,請參閱結構描述端點指南

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