探索UI中的結構描述資源

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

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

查詢結構描述資源 lookup

在Platform UI中,選取左側導覽中的​ 結構描述。 結構描述工作區提供​ 瀏覽 ​索引標籤以探索您組織中的所有結構描述,以及其他專用索引標籤以分別探索​ 類別欄位群組 ​和​ 資料型別

篩選圖示( 篩選圖示影像 )在左側邊欄中顯示控制項,以縮小列出的結果。 顯示的控制項會因所列的資源型別而異。

例如,若要篩選清單以僅顯示Adobe提供的標準資料型別,請分別在​ 型別 ​和​ 所有者 ​區段下選取​ 資料型別 ​和​ Adobe

包含在設定檔 ​切換可讓您篩選結果,以僅顯示用於已啟用即時客戶設定檔之結構描述中的資源。 顯示臨時結構描述 ​切換會篩選使用僅供單一資料集使用的名稱空間欄位建立的結構描述清單。

反白顯示篩選面板的結構描述工作區瀏覽索引標籤。

在​ 類別欄位群組 ​或​ 資料型別 ​標籤上列出資源時,您可以選取​ Adobe ​以僅顯示標準資源,或選取​ 客戶 ​以僅顯示貴組織建立的資源。

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

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

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

在畫布中探索XDM資源 explore

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

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

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

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

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

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

系統產生的欄位 system-fields

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

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

資料類型 data-types

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

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

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

欄位屬性 field-properties

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

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

身分欄位 identity

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

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

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

關係欄位 relationship

如果您正在檢查包含關聯性欄位的結構描述,該欄位將會列在左側邊欄的​ 關聯性 ​下。 在左側邊欄中選取關係欄位名稱,以顯示畫布中的欄位,無論其巢狀深度為何。

關聯性欄位在畫布中也以唯一方式反白顯示,顯示該欄位連結到的參考結構描述名稱。 如果您選取關係欄位的名稱,即可在右側邊欄中檢視參照結構描述主要身分的身分名稱空間。

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

後續步驟

本檔案說明如何在Experience Platform UI中探索現有的XDM資源。 如需結構描述工作區和Schema Editor不同功能的詳細資訊,請參閱結構描述工作區概觀

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