文件Experience Platform體驗資料模型 (XDM) 指南

探索UI中的結構描述資源

Last update: Wed Mar 25 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員

在Adobe Experience Platform中，所有Experience Data Model (XDM)結構描述資源都儲存在Schema Library中，包括Adobe提供的標準資源以及您組織定義的自訂資源。 在Experience Platform UI中，您可以檢視Schema Library中任何現有結構描述、類別、欄位群組或資料型別的結構和欄位。 這在計畫和準備資料擷取時特別有用，因為UI會提供關於這些XDM資源提供的每個欄位的預期資料型別和使用案例的資訊。

本教學課程涵蓋在Experience Platform UI中探索現有結構描述、類別、欄位群組和資料型別的步驟。

查詢結構描述資源 lookup

在Experience Platform UI中，選取左側導覽中的​Schemas。 Schemas工作區提供​ Browse ​索引標籤以探索您組織中的所有結構描述，以及其他專用索引標籤以分別探索​Classes、Field groups、Data types​和​Relationships。

包含數個反白索引標籤的結構描述工作區。

篩選圖示（ 篩選圖示影像 ）在左側邊欄中顯示控制項，以縮小列出的結果。 資源篩選器可分別用於​ Browse ​和​ Relationships ​標籤上的結構描述和關係。

在Browse工作區的Schemas索引標籤上，您可以篩選結構描述詳細目錄。 使用​ Included in Profile ​切換可僅顯示已啟用在即時客戶個人檔案中使用的結構描述。 使用​ Show adhoc schemas ​切換來篩選使用名稱空間為僅供單一資料集使用的欄位建立的結構描述清單。

反白顯示篩選面板的Schemas工作區Browse索引標籤。

在Relationship工作區的Schemas標籤上，您可以根據四個條件篩選關係清單。 篩選器包括Source schema、Destination schema、Source class和Destination class。 下表提供篩選的說明。

篩選
說明
Source schema
若要檢視所選結構描述是起點或「來源」的所有關係，請從Source schema下拉式選單中選取結構描述。
Destination schema
若要檢視所選結構描述為目標或「目的地」的所有關係，請從Destination schema下拉式選單中選取結構描述。
Source class
若要根據起始結構描述的類別篩選關係，請從Source class下拉式選單中選取類別。
Destination class
若要顯示以特定類別的結構描述結尾的關係，請從Destination class下拉式選單中選取類別。

反白顯示篩選區段的[關係]索引標籤。

您也可以使用搜尋列進一步縮小結果的範圍。

搜尋欄位反白顯示的[結構描述]工作區的[瀏覽]索引標籤。

搜尋結果中顯示的資源會先依標題比對排序，然後依說明比對排序。 反過來，符合這些類別的單字越多，資源在清單中顯示的位置就越高。

找到要探索的資源後，從清單中選取其名稱，以在畫布中檢視其結構。

管理結構描述、類別、欄位群組和資料型別：動作和刪除 xdm-resource-actions

當您需要管理或刪除XDM資源，或動作（例如刪除）無法使用，而您需要瞭解原因時，請使用此區段。

在何處尋找動作（內嵌與詳細資訊頁面） where-to-find-actions

若要執行刪除、匯出或複製資源等動作，請使用下列其中一個進入點：

在​Browse、Classes、Field groups​和​ Data types ​索引標籤上，管理動作在兩個位置都可使用：

  • 內嵌在資料表​中：每個資源列都包含一個動作功能表（例如，…），可讓您直接存取可用的動作。

結構描述清查會顯示每個資源的省略符號選單中的內嵌動作。

  • 資源詳細檢視：若要存取詳細檢視中的完整動作，您必須選取​ 自訂（租使用者定義的） ​資源。 標準（Adobe提供）資源的動作有限，不會顯示刪除、複製JSON結構或新增到封裝等選項。 從詳細目錄選取自訂資源以開啟其詳細資料檢視，然後使用頁面標頭中的​ More ​功能表來存取相同的可用動作。

資源詳細資料檢視標題顯示[更多]功能表，其中包含可用的動作，例如[刪除]、[複製JSON結構]和[下載範例檔案]。

這些動作在支援的資源型別（結構描述、類別、欄位群組和資料型別）的兩個進入點之間是一致的。

可用動作 available-actions

根據資源型別和您的許可權，可能提供下列動作：

  • Delete — 從您的組織永久移除自訂資源（當限制允許時）。 如果封鎖刪除，請參閱限制。
  • Download sample file — 根據資源結構產生範例資料檔案。 逐步： 產生範例XDM資料。
  • Copy JSON structure — 複製JSON格式的資源定義，以重複使用、匯出或檢查。 逐步： 匯出XDM結構描述。
  • Add to package — 將資源包含在沙箱套件中，以便跨沙箱匯出或匯入。 逐步執行：將物件匯出至封裝。

下列專案適用於不同的資源型別：

  • 對於​ 自訂（租使用者定義的） ​結構描述、類別、欄位群組和資料型別，上述所有動作都可使用。

  • 針對​ 標準（Adobe定義） ​類別、欄位群組和資料型別：

    • 只有​ Download sample file ​可用。
    • 刪除、複製JSON結構​和​ 新增至封裝 ​無法使用。

刪除行為 delete-behavior

當您想要移除不再需要的自訂資源時，請使用​ Delete ​動作。

IMPORTANT
刪除資源會將其從組織中永久移除，且無法復原。 由於使用方式、許可權或系統限制，無法刪除某些資源。

若要刪除資源：

  1. 在表格中找出資源或開啟其詳細資料檢視。
  2. 選取動作功能表（…​或​More）。
  3. 選擇「Delete」。
  4. 再次選取​Delete，確認對話方塊中的動作。

資源在確認後將從您的組織中永久移除。

如果資源無法進行刪除，此選項會以工具提示的形式顯示並停用，說明無法執行動作的原因。

結構描述清查已停用的刪除內嵌動作工具提示，說明此限制。

限制（資料集、設定檔、RBAC、租使用者與全域） delete-constraints

如果無法使用或停用​ Delete ​等動作，通常是因為下列條件之一：

  • 許可權(RBAC)：您必須有必要的許可權（例如​Manage Schemas）才能執行管理動作。 如果缺少許可權，動作會顯示為停用，並附上工具提示。 若要瞭解許可權的設定方式，請參閱存取控制UI概觀。

  • 資料集關聯：無法刪除一或多個資料集所使用的資源（例如與資料集關聯的結構描述）。 若要識別及移除資料集相依性，請參閱刪除資料集。

  • 設定檔啟用：無法刪除為即時客戶設定檔啟用的結構描述。 如需設定檔啟用如何影響結構描述的指引，請參閱規劃即時客戶設定檔啟用。

  • 租使用者與全域資源：可以刪除租使用者定義的（自訂）資源（受條件約束），但無法刪除標準（Adobe提供的）類別、欄位群組和資料型別。

這些限制會直接反映在UI中。 當動作無法使用時，其會顯示為停用，並包含說明特定限制的工具提示。

如果您無法刪除資源，請檢閱上述條件以決定您是否需要更新許可權、移除相依性或調整您的資料模型。

如需畫布中的其他結構描述編輯工作流程，請參閱在UI中建立和編輯結構描述。

在畫布中探索XDM資源 explore

選取資源後，其結構會在畫布中開啟。

顯示Commerce資料型別的資料型別工作區畫布。

所有包含子屬性的物件型別欄位首次出現在畫布中時，預設會收合。 若要顯示任何欄位的子屬性，請選取其名稱旁的圖示。

資料型別工作區畫布具有展開的欄位和強調的子屬性。

標準類別和欄位群組指標 standard-class-and-field-group-indicator

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

結構描述編輯器反白顯示掛鎖圖示

請參閱將自訂欄位新增到標準欄位群組檔案以取得指引。 您無法編輯標準類別。

系統產生的欄位 system-fields

某些欄位名稱的前置字元為底線，例如_repo和_id。 這些代表系統將在擷取資料時自動產生並指派之欄位的預留位置。

因此，大部分這些欄位在擷取至Experience Platform時應該從資料結構中排除。 此規則的主要例外是_{TENANT_ID}欄位，在您組織下建立的所有XDM欄位都必須位於該欄位之下。

資料類型 data-types

對於畫布中顯示的每個欄位，其對應的資料型別會顯示在名稱旁邊，以指出該欄位預期擷取的資料型別。

畫布上顯示的郵寄地址資料型別及其相關聯的資料型別已反白顯示。

任何附加了方括弧([])的資料型別都代表該特定資料型別的陣列。 例如，String[]​的資料型別表示欄位需要字串值的陣列。 Payment Item[]​的資料型別表示符合Payment Item資料型別的物件陣列。

如果陣列欄位是以物件型別為基礎，您可以在畫布中選取其圖示，以顯示每個陣列專案的預期屬性。

畫布中的物件反白顯示陣列欄位，並顯示每個陣列專案的預期屬性。

Field properties field-properties

當您選取畫布中任何欄位的名稱時，右邊欄會更新，以在​ Field properties ​下顯示該欄位的詳細資訊。 其中包括欄位預期使用案例、預設值、模式、格式、欄位是否為必填等內容的說明。

從Commerce資料型別中選取的欄位，其欄位屬性已反白顯示。

如果您要檢查的欄位是列舉欄位，右側邊欄也會顯示欄位預期會收到的可接受值。

結構描述編輯器已選取欄位，且欄位屬性邊欄中反白顯示的列舉值和顯示名稱。

身分識別欄位 identity

檢查包含身分欄位的結構描述時，這些欄位會列在左側邊欄中，位於類別或欄位群組（提供這些欄位給結構描述）下方。 在左側邊欄中選取身分欄位名稱，以顯示畫布中的欄位，無論其巢狀深度為何。

畫布中的身分欄位會以指紋圖示（ 指紋圖示影像 ）強調顯示。 如果您選取身分欄位名稱，則可以檢視其他資訊，例如身分名稱空間，以及該欄位是否為結構描述的主要身分。

結構描述編輯器在左側邊欄中反白顯示結構描述身分、在結構描述圖表中反白顯示的欄位，以及在欄位屬性中反白顯示的身分名稱空間。

NOTE
請參閱定義身分欄位的指南，以取得身分欄位及其與下游Experience Platform服務關係的詳細資訊。

關係欄位 relationship

如果您要檢查包含關聯性欄位的結構描述，該欄位將會列在​ Relationships ​下的左側邊欄中。 在左側邊欄中選取關係欄位名稱，以顯示畫布中的欄位，無論其巢狀深度為何。 關聯性欄位在畫布中也以唯一方式反白顯示，顯示該欄位連結到的參考結構描述名稱。 對於具有B2B功能的組織，在這些情況下，可以寫入自訂關係名稱並將顯示在畫布上。

結構描述編輯器，其關聯欄位和編輯關聯性已反白顯示。

若要檢視參考結構描述主要身分的身分名稱空間，請選取關聯性欄位，然後在​ Edit relationship ​側邊欄中選取Field properties。 關聯性的引數會顯示在顯示的Edit relationship對話方塊中。

顯示關聯性引數的[編輯關聯性]對話方塊。

請參閱有關在UI中建立關聯性的教學課程，以瞭解在XDM結構描述中使用關聯性的詳細資訊。

後續步驟

本檔案說明如何在Experience Platform UI中探索現有的XDM資源。 如需Schemas工作區與Schema Editor之不同功能的詳細資訊，請參閱Schemas工作區概觀。

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