在 UI 中建立和編輯類別 ui-create-and-edit

在Adobe Experience Platform中,結構描述的類別會定義結構描述將包含的資料的行為方面(記錄或時間序列)。 除此之外,類別會說明基於該類別的所有結構描述所需包含的最小通用屬性數量,並提供合併多個相容資料集的方法。

Adobe提供幾個標準(「核心」)體驗資料模型(XDM)類別,包括XDM個人設定檔XDM ExperienceEvent。 除了這些核心類別之外,您也可以建立自己的自訂類別,以說明貴組織更具體的使用案例。

本檔案概述如何在Experience PlatformUI中建立、編輯及管理自訂類別。

先決條件 prerequisites

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

雖然本指南並非必要,但建議您也按照有關在UI中構成結構描述的教學課程,熟悉結構描述編輯器的各種功能。

快速入門 getting-started

在Platform UI中,選取左側導覽中的​ 結構描述 ​以開啟結構描述工作區,然後選取​ 類別 ​索引標籤。 會顯示可用類別的清單。

在結構描述工作區類別和結構描述的類別標籤內的類別已反白。

篩選類別 filter

系統會根據類別的建立方式自動篩選類別清單。 預設設定會顯示由Adobe定義的類別。 您還可以篩選清單以顯示您的組織建立的清單。 選取選項按鈕以在標準與自訂選項之間選擇。 Standard選項會顯示Adobe建立的實體,而Custom選項則會顯示在您的組織內建立的實體。

結構描述工作區的類別索引標籤中反白顯示標準和自訂。

TIP
使用搜尋功能,根據類別名稱篩選或尋找類別。 如需詳細資訊,請參閱探索XDM資源的指南。

建立新類別 create

在Platform UI中建立類別的方法有兩種:透過​ Create class ​或​ Create schema

建立類別

從結構描述工作區的類別索引標籤中選取​ 建立類別

含有建立類別的結構描述工作區的類別索引標籤已強調顯示

建立類別對話方塊就會顯示。 輸入類別的顯示名稱和描述,然後使用選項按鈕選擇您類別的預期行為。 類別可以是記錄型別,或時間序列型別。 選取​ 建立 ​以確認您的選擇,並返回類別標籤。

反白顯示建立的建立類別對話方塊。

您建立的類別可以使用,並列在類別檢視中。

最近建立之類別反白顯示之結構描述工作區的類別標籤。

建立結構描述

或者,您可以手動建立結構描述來建立類別。 從結構描述工作區的類別索引標籤中選取​ 建立結構描述

含有建立結構描述的結構描述工作區的類別索引標籤已強調顯示

在出現的建立結構描述對話方塊中選取​ 手動

NOTE
如果您使用ML輔助結構描述建立工作流程,則可上傳檔案並使用ML演演算法產生建議的結構描述。 在該結構描述建立工作流程中,您不需要指定結構描述的基底類別。 若要瞭解ML如何根據csv檔案建議結構描述結構,請參閱機器學習輔助結構描述建立指南

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

架構建立工作流程隨即顯示。 在結構描述詳細資料區段中,選取​ 其他。 可用的類別清單隨即顯示。 選取​ 建立類別

在結構描述詳細資料區段中反白顯示Other的建立結構描述工作流程。

建立類別對話方塊就會顯示。 輸入類別的顯示名稱和描述,然後使用選項按鈕選擇您類別的預期行為。 類別可以是記錄型別,或時間序列型別。 選取​ 建立 ​以確認您的選擇,並返回類別標籤。

反白顯示建立的建立類別對話方塊。

類別清單會在結構描述詳細資料區段中重新整理,並且您新建立的類別會自動選取。 選取​ 下一步 ​以繼續建立您的結構描述。

已選取新類別並反白顯示下一步的結構描述詳細資料區段。

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

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

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

將欄位新增至類別 add-fields

一旦您在結構描述編輯器中開啟了使用自訂類別的結構描述,您就可以開始將欄位新增到類別中。 若要新增欄位,請選取結構描述名稱旁的​ 加號(+) ​圖示。

IMPORTANT
當建置實作由您的組織定義之類別的結構描述時,請記住,結構描述欄位群組只能與相容的類別搭配使用。 由於您定義的類別是新的,因此在​ 新增欄位群組 ​對話方塊中並未列出相容的欄位群組。 反之,您需要建立新的欄位群組以便與該類別搭配使用。 下次當您撰寫實作新類別的結構描述時,將會列出您定義的欄位群組並可供使用。

結構描述編輯器,其新增按鈕已反白顯示。

IMPORTANT
請記住,您新增到類別的任何欄位都將用於使用該類別的所有結構描述。 因此,您應該仔細考慮哪些欄位在所有結構描述使用案例中都將很有用。 如果您考慮新增一個欄位,而此欄位可能只會在此類別下的某些結構描述中使用,建議您改為建立欄位群組,將其新增至這些結構描述。

畫布中會出現​ 未命名的欄位 ​預留位置,而右邊欄會更新以顯示控制項,以設定欄位的屬性。 在​ 指派給 ​下,選取​ 類別

結構描述編輯器的畫布中有未命名的欄位,其指派給Class欄位屬性已選取並反白顯示。

請參閱在UI中定義欄位的指南,以瞭解如何設定欄位並將其新增到類別的特定步驟。 繼續將所需數量的欄位新增至類別。 完成後,選取​ 儲存 ​以儲存結構描述和類別。

在結構描述編輯器的畫布上新建立的結構描述,並反白顯示儲存。

如果您先前已建立採用此類別的結構描述,則新新增的欄位會自動出現在這些結構描述中。

編輯類別(#edit-a-class)

NOTE
只有貴組織定義的自訂類別才能完全編輯和自訂。 對於由Adobe定義的核心類別,只能在個別結構描述的內容中編輯其欄位的顯示名稱。 如需詳細資訊,請參閱編輯結構描述欄位的顯示名稱一節。
儲存自訂類別並用於資料擷取後,之後只能對其執行附加變更。 如需詳細資訊,請參閱結構描述演化🔗的規則。

您可以透過架構工作流程編輯類別,方法是編輯擴充類別的現有架構,或手動建立架構。 無法直接編輯類別。 從結構描述工作區的瀏覽索引標籤中,選取現有類別或​ 建立結構描述

結構描述編輯器含有現有的類別和建立結構描述已反白顯示。

如果您選擇建立新的結構描述,請參閱建立結構描述一節以取得詳細資料。 當您完成建立結構描述後(或選取現有結構描述後),會出現結構描述編輯器。 若要更新現有的類別欄位,請從結構描述結構中選取該欄位。 欄位的資訊將顯示在右側邊欄中。 確定指派給
已選取選項​ 類別,否則您的更新將不會影響類別。

結構描述編輯器已選取並反白欄位,且右邊欄已顯示,反白顯示指派給。

對欄位進行任何需要的變更,在右側邊欄中向下捲動以選取「套用」以儲存您的變更。

IMPORTANT
您對欄位所做的任何更新都將套用至採用此類別的所有結構描述,並遵循結構描述演化規則

結構描述編輯器已選取欄位,且右邊欄已公開,醒目提示套用。

若要新增欄位,請依照新增欄位至類別指南。 完成後,選取​ 儲存 ​以儲存結構描述和類別。

結構描述編輯器儲存已反白顯示。

變更結構描述的類別 schema

您可以在儲存架構之前,於初始建立程式期間隨時變更架構的類別。 但是,應謹慎執行此操作,因為欄位群組僅與特定類別相容。 變更類別會重設畫布和您已新增的任何欄位。
如需詳細資訊,請參閱建立和編輯結構描述的指南。

後續步驟 next-steps

本檔案說明如何使用Platform UI建立和編輯類別。 如需結構描述工作區功能的詳細資訊,請參閱結構描述工作區概觀

若要瞭解如何使用Schema Registry API管理類別,請參閱類別端點指南

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