在 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

在結構描述工作區中,選取右上角的​建立結構描述。 「選取結構描述型別」下拉式功能表出現,其中包含Standard或Relational結構描述的選項。

反白顯示建立結構描述的結構描述工作區,並顯示選取結構描述型別下拉式清單。

建立關聯式結構描述 create-relational-schema

AVAILABILITY
Adobe Journey Optimizer 協調的行銷活動​授權持有人可使用Data Mirror和關聯式結構描述。 視您的授權和功能啟用而定,它們也可作為Customer Journey Analytics使用者的​ 有限版本 ​提供。 請聯絡您的Adobe代表以取得存取權。

選取​ 關聯式 ​以定義結構化、關聯式樣式的綱要,對記錄進行微調控制。 關聯式結構描述透過主要和外部索引鍵支援主索引鍵強制、記錄層級版本設定和結構描述層級關係。 它們也針對使用變更資料擷取的增量擷取進行最佳化,並支援用於Campaign Orchestration、Data Distiller和B2B實作的多種資料模型。

若要深入瞭解,請參閱Data Mirror關聯式結構描述概觀。

手動建立 create-manually

AVAILABILITY
DDL檔案上傳僅適用於Adobe Journey Optimizer Orchestrated行銷活動授權持有者。 您的UI外觀可能會有所不同。

建立關聯式結構描述​對話方塊就會顯示。 您可以選擇​ 手動建立 ​或 上傳DDL檔案 來定義結構描述結構。

在​ 建立關聯式結構描述 ​對話方塊中,選取​手動建立,然後選取​下一步

已選取建立關聯式結構描述對話方塊,其中有手動建立並反白顯示下一步。

關聯式結構描述詳細資料​頁面就會顯示。 輸入結構描述顯示名稱和選擇性說明,然後選取​ 完成 ​以建立結構描述。

具有結構描述顯示名稱、描述和完成的關聯式結構描述詳細資料頁面已反白顯示。

結構描述編輯器開啟,並顯示用於定義結構描述結構的空白畫布。 您可以照常新增欄位。

新增版本識別碼欄位 add-version-identifier

若要啟用版本追蹤並支援變更資料擷取,您必須在結構描述中指定版本識別碼欄位。 在結構描述編輯器中,選取加號( A加號圖示。 ) 圖示來新增欄位。

輸入欄位名稱,例如updateSequence,然後選擇​ 日期時間 ​或​ 數字 ​的資料型別。

在右邊欄中,啟用​ 版本識別碼 ​核取方塊,然後選取​ 套用 ​以確認欄位。

已新增包含名為updateSequence之DateTime欄位的結構描述編輯器,且已選取版本識別碼核取方塊。

IMPORTANT
關聯式結構描述必須包含版本識別碼欄位,以支援記錄層級更新和變更資料擷取擷取。

若要定義關係,請在結構描述編輯器中選取​新增關係,以建立結構描述層級的主索引鍵/外部索引鍵關係。 如需詳細資訊,請參閱有關新增結構描述層級關係的教學課程。

接下來,繼續進行定義主索引鍵,並視需要新增其他欄位。 如需如何在Experience Platform來源中啟用變更資料擷取的指引,請參閱變更資料擷取擷取指南

NOTE
儲存後,結構描述屬性側邊欄中的Type欄位會指出這是關聯式結構描述。這也會在結構描述詳細目錄檢視的詳細資訊側邊欄中指明。
結構描述編輯器畫布顯示空白的關聯式結構描述結構,且在結構描述屬性側邊欄中顯示關聯式型別。

上傳DDL檔案 upload-ddl-file

AVAILABILITY
DDL檔案上傳僅適用於Adobe Journey Optimizer Orchestrated行銷活動授權持有者。

使用此工作流程透過上傳DDL檔案來定義結構描述。 在​ 建立關聯式結構描述 ​對話方塊中,選取​上傳DDL檔案,然後從您的系統拖曳本機DDL檔案或選取​選擇檔案。 Experience Platform會驗證結構,如果檔案上傳成功,會顯示綠色核取記號。 選取​ 下一步 ​以確認上傳。

已選取上傳DDL檔案,且顯示檔案上傳區域的建立關聯式結構描述對話方塊,包括選擇檔案按鈕和拖放區域。

選取要匯入的實體和欄位對話方塊會出現,讓您預覽結構描述。 檢閱結構描述結構,並使用選項按鈕和核取方塊來確保每個實體都有指定的主索引鍵和版本識別碼。

IMPORTANT
資料表結構必須包含​ 主索引鍵 ​和​版本識別碼,例如日期時間或數字型別的updateSequence欄位。
對於變更資料擷取擷取,也需要名稱為_change_request_type且型別為String的特殊資料行,才能啟用增量處理。 此欄位指出資料變更的型別(例如,u (更新插入)或d (刪除))。

雖然在內嵌期間是必要的,但控制項資料行(例如_change_request_type)並未儲存在結構描述中,也不會出現在最終的結構描述結構中。 如果一切看起來都正確,請選取​ 完成 ​以建立結構描述。

NOTE
DDL上傳支援的檔案大小上限為10MB。

![選取要匯入的實體和欄位]對話方塊,其中已顯示匯入的欄位並反白顯示完成。(…/…/images/ui/resources/schemas/entities-and-files-to-import.png)

結構會在結構編輯器中開啟,您可以在儲存前調整結構。

接下來,繼續進行新增其他欄位,並視需要新增其他結構描述層級關係

如需如何在Experience Platform來源中啟用變更資料擷取的指引,請參閱變更資料擷取擷取指南

建立標準結構描述 create-standard-schema

從結構描述型別選單中選取​Standard。 建立結構描述對話方塊就會顯示。 在此對話方塊中,選擇結構描述建立工作流程。 您可以新增欄位和欄位群組來手動建立結構描述,或上傳CSV檔案來自動產生結構描述。

​ 建立結構描述對話方塊,並反白顯示結構描述建立工作流程選項。

[Beta]{class="badge informative"}手動或ML輔助的結構描述建立 manual-or-assisted

若要瞭解如何使用ML演演算法來建議以csv檔案為基礎的結構描述結構,請參閱機器學習輔助的結構描述建立指南。 本UI指南著重於手動建立工作流程。

手動建立結構描述 manual-creation

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

​ 建立結構描述工作流程顯示三個基底類別選項,並反白顯示下一步。

選擇​ 其他 ​時,會顯示可用類別的清單。 您可以在此處瀏覽及篩選預先存在的類別。

已選取Other且顯示可用類別清單的建立結構描述工作流程。

選取選項按鈕,根據類別是自訂或標準類別來篩選類別。 您也可以根據產業來篩選可用的結果,或使用搜尋欄位來搜尋特定類別。

使用搜尋列自訂和產業反白顯示建立結構描述工作流程。

為了協助您決定適當的類別,每個類別都有資訊和預覽圖示。 資訊圖示( 資訊圖示。 ) 會開啟對話方塊,提供類別及其關聯產業的說明。

已開啟類別資訊工具提示的建立結構描述工作流程,其中顯示類別描述和相關產業。

預覽圖示( 預覽圖示。 ) 開啟包含架構圖表及其屬性的類別的預覽對話方塊。

類別預覽對話方塊,顯示選取類別的結構描述圖表和屬性。

選取任何列以選擇類別,然後選取​ 下一步 ​以確認您的選擇。

從可用類別資料表中選取類別並反白顯示下一步的建立結構描述工作流程。

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

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

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

隨即顯示「結構描述編輯器」,其結構描述結構顯示在畫布中。 如有需要,您現在可以開始新增欄位至類別

結構描述編輯器在畫布中顯示新建立的結構描述的基底結構。

編輯現有結構描述 edit

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

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

結構描述工作區瀏覽索引標籤,其結構描述名稱已反白顯示,以供選取和編輯。

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

選取結構描述後,Schema Editor會出現,其結構描述結構顯示在畫布中。 您現在可以使用下節中所述的工具和選項自訂架構。

自訂結構 customize-schema

在架構編輯器中開啟架構後,您就可以自訂其結構、欄位和顯示屬性。 本節介紹根據您的特定需求量身打造結構描述時可用的主要自訂選項。

使用下列連結直接導覽至此區段內的主要自訂工作:

顯示名稱切換 display-name-toggle

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

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

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

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

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

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

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

結構描述編輯器在左側邊欄的欄位群組區段中,使用新增按鈕強調顯示。

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

​ 新增欄位群組對話方塊顯示依熱門程度欄排序的可用欄位群組。

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

此新增欄位群組對話方塊,在左側邊欄中選取產業篩選器,並反白顯示產業欄。

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

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

包含作用中搜尋列的新增欄位群組對話方塊,並顯示標準欄位結果。

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

​ 新增欄位群組對話方塊,其中包含使用核取方塊選取的欄位群組,以及顯示在右側邊欄中的選取群組。

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

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

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

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

結構描述編輯器顯示畫布中新加入的欄位群組欄位。

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

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

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

將欄位群組新增到結構描述後,您可以從欄位群組中全域移除欄位,或在目前結構描述中本機隱藏欄位。 瞭解這些動作之間的差異至關重要,以避免意外的結構描述變更。

IMPORTANT
選取​ 移除 ​會從欄位群組本身刪除欄位,影響使用該欄位群組的​ 所有 結構描述。
除非您想要​ 從包含欄位群組 ​的每個結構描述中移除欄位,否則請勿使用此選項。

若要從欄位群組刪除欄位,請在畫布中選取該欄位,然後在右側邊欄中選取​移除。 此範例顯示來自​ 人口統計詳細資料 ​群組的taxId欄位。

結構描述編輯器在畫布中選取了欄位,並在右側邊欄中反白顯示移除。

若要隱藏結構描述中的多個欄位,而不將其從欄位群組本身移除,請使用​ 管理相關欄位 ​選項。 從畫布的群組選取任何欄位,然後在右側邊欄中選取​管理相關欄位

結構描述編輯器,在畫布中選取了欄位群組欄位,並在右側邊欄中反白顯示管理相關欄位。

會出現一個對話方塊,顯示欄位群組的結構。 使用核取方塊來選取或取消選取您要包含的欄位。

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

選取​ 確認 ​以更新畫布並反映您選取的欄位。

結構描述編輯器畫布在確認管理相關欄位對話方塊中的欄位可見性變更後,顯示更新的結構描述結構。

移除或棄用欄位時的欄位行為 field-removal-deprecation-behavior

請使用下表來瞭解每個動作的範圍。

動作
僅適用於目前的結構描述
修改欄位群組
影響其他結構描述
說明
移除欄位
從欄位群組中刪除欄位。 這會將其從使用該群組的所有結構描述中移除。
管理相關欄位
僅隱藏目前結構描述中的欄位。 欄位群組保持不變。
棄用欄位
在欄位群組中將此欄位標示為已棄用。 任何結構描述中都不再提供此功能。
NOTE
記錄型和事件型結構描述中的這種行為都是一致的。

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

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

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

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

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

將欄位新增到結構描述 add-fields-to-schema

結構編輯器提供多種將欄位新增到結構描述結構的方法。 選擇最符合您特定需求的方法。

使用下列連結來閱讀將欄位新增至結構描述的特定方法:

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

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

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

將標準欄位新增到結構描述 add-standard-fields

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

結構描述編輯器畫布已新增未命名的欄位預留位置,而欄位設定控制項顯示在右側邊欄中。

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

結構描述編輯器右邊欄顯示建議的標準欄位符合輸入的欄位名稱查詢。

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

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

結構描述編輯器欄位設定面板,其標準欄位預覽已開啟,且新增圖示已反白顯示。

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

結構描述編輯器畫布顯示新增到結構描述結構的標準欄位,其父欄位可見,且欄位群組列在左側邊欄中。

將自訂欄位新增到結構描述 add-custom-fields

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

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

結構描述編輯器畫布在根層級新增了未命名的欄位預留位置,在右側邊欄新增了欄位設定控制項。

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

結構描述編輯器右側邊欄已輸入自訂欄位名稱,且欄位名稱建議中反白顯示新增欄位選項。

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

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

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

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

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

結構描述編輯器右側邊欄已選取指派給欄位群組選項,且欄位群組名稱輸入欄位已反白顯示。

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

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

結構描述編輯器右邊欄顯示新的自訂欄位組態,並反白顯示套用。

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

結構描述編輯器畫布顯示新增到租使用者ID名稱空間下的新自訂欄位,而相關的欄位群組列在左側邊欄中。

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

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

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

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

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

結構描述編輯器右邊欄顯示指派給自訂類別的新欄位,並反白顯示套用。

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

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

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

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

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

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

結構描述編輯器畫布在標準欄位群組物件旁反白顯示加號圖示,以新增自訂欄位。

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

結構描述編輯器警告對話方塊會提示確認轉換標準欄位群組,並反白顯示繼續建立欄位群組。

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

結構描述編輯器畫布顯示重新命名為Extended尾碼的標準欄位群組,以及未命名的預留位置欄位。

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

結構描述編輯器畫布顯示新增到轉換後的標準欄位群組中的租使用者ID名稱空間下的新自訂欄位。

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

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

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

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

結構描述編輯器,在畫布中選取了欄位,並在右側邊欄中反白顯示顯示名稱欄位。

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

結構描述編輯器畫布顯示更新的欄位顯示名稱,並反白顯示儲存。

管理結構描述 manage-schemas

可從Experience Platform UI中的兩個主要位置使用結構描述管理工作。 根據您使用結構描述的位置,選擇適當的工作流程。

從瀏覽檢視管理結構描述 manage-from-browse

本節會記錄​ 瀏覽 ​標籤中可用的結構描述動作;如需結構描述探索、篩選及組織的相關資訊,請參閱探索XDM資源

結構描述工作區瀏覽索引標籤會開啟結構描述列的省略符號選單,顯示內嵌動作,包括編輯、刪除、套用標籤和管理標籤。

下列章節說明​ 瀏覽 ​標籤中可用的結構描述管理動作。 可透過每個結構描述列旁邊的省略符號(…)選單存取這些動作。

動作
說明
編輯結構描述屬性
修改基本結構資訊,包括顯示名稱、說明和標籤,而不開啟結構編輯器。 如需詳細指示,請參閱編輯結構描述屬性
刪除結構描述
從您的組織移除結構描述。 僅適用於未針對即時客戶個人檔案啟用的結構描述,且沒有關聯的資料集。 如需詳細指示,請參閱刪除結構描述
套用標籤 (資料控管)
指派資料使用標籤,以根據隱私權政策和合規性要求來分類結構描述。 在結構描述層級套用的標籤會傳播到從該結構描述建立的所有資料集。 如需詳細指示,請參閱套用資料治理標籤
建立資料集
從選取的結構描述建立新的資料集。 如需詳細指示,請參閱建立資料集
管理標籤
新增或移除結構描述組織的使用者定義標籤。 如需詳細指示,請參閱管理標籤
移至資料夾
將結構描述移至資料夾階層。 如需詳細指示,請參閱移至資料夾
新增到封裝
將結構描述包含在沙箱工具套件中,以便跨環境部署。 如需詳細指示,請參閱新增至封裝
複製JSON結構
將結構的完整JSON表示法複製到剪貼簿。 如需詳細指示,請參閱複製JSON結構
下載範例檔案
產生並下載符合結構描述結構的範例資料檔案。 如需詳細指示,請參閱下載範例檔案
NOTE
範例檔案是用於測試結構描述結構,不應包含生產資料。

編輯結構描述屬性 edit-schema-properties

將您直接導向結構描述編輯器,並預先填入結構描述。

刪除結構描述 delete-schema

從您的組織移除結構描述。 刪除僅適用於尚未針對Real-Time Customer Profile啟用且沒有關聯資料集的結構描述。 刪除後,該結構描述將無法復原。

套用資料治理標籤 apply-data-governance-labels

直接前往結構描述工作區標籤標籤。 如需完整指示,請參閱管理結構描述檔案的資料使用標籤。

建立資料集 create-dataset

AVAILABILITY
此動作僅適用於標準(非關聯)結構描述。

開啟​ 從結構描述 ​建立資料集對話方塊,並預先填入來源結構描述名稱。 輸入資料集​名稱,並選擇性地輸入​描述,然後選取​ 建立資料集 ​以建立資料集。

透過Name和Description強調欄位和建立資料集按鈕的從結構描述對話方塊建立資料集。

資料集建立後,會在資料集工作區中開啟。

管理標籤 manage-tags

開啟新增或移除標籤對話方塊,您可以在其中指派或移除結構描述中的使用者定義標籤。 指派給結構的標籤會出現在結構描述詳細目錄中,並可用於篩選。 如需標籤式組織的詳細資訊,請參閱探索XDM資源

移動到資料夾 move-to-folder

開啟移動對話方塊,您可以在此選取目的地資料夾或建立新資料夾。 組織成資料夾的結構描述會顯示在左側欄的資料夾階層中。 如需資料夾式組織的詳細資訊,請參閱探索XDM資源

新增至套件 add-to-package

將結構描述包含在沙箱工具套件中,以便跨環境部署。 結構描述必須符合套件資格要求。 包含結構的套件可以在沙箱之間匯出和匯入。

複製 JSON 結構 copy-json-structure

將結構的完整JSON表示法複製到剪貼簿。 輸出符合儲存在結構描述登入中的結構描述結構,可用於API操作或結構描述共用。

下載範例檔案 download-sample-file

產生並下載符合結構描述結構的範例資料檔案。 此檔案包含在結構描述中定義的每個欄位的範例值。 範例檔案僅供測試結構描述結構之用,不應包含生產資料。

從方案編輯器管理方案 manage-from-editor

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

反白顯示更多按鈕的結構描述編輯器,並顯示快速動作下拉式清單。

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

完成結構描述 finalize-schema

完成自訂結構描述結構和欄位後,您可能需要採取其他步驟以準備用於生產。 這些最終設定步驟可確保您的架構正確與Experience Platform服務整合。

啟用即時客戶設定檔的結構描述 profile

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

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

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

結構描述編輯器在左側邊欄中選取結構描述名稱,並在右側邊欄中反白顯示設定檔切換按鈕。

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

設定檔的啟用確認彈出視窗,並反白顯示啟用按鈕。

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

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

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

結構描述編輯器右側邊欄顯示設定檔切換為已啟用狀態。

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

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

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

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

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

結構描述編輯器畫布左側反白顯示指派按鈕。

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

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

顯示可用類別的指派類別對話方塊,其中已顯示選取的類別描述,並反白顯示指派類別。

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

類別重新指派確認對話方塊中反白顯示指派按鈕。

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

後續步驟 next-steps

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

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

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

recommendation-more-help
experience-platform-help-xdm