探索UI中的結構描述資源

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

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

查詢結構描述資源 lookup

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

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

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

在結構描述工作區的瀏覽索引標籤上,您可以篩選結構描述詳細目錄。 使用​ 包含在設定檔 ​切換功能,只顯示已啟用在即時客戶設定檔中使用的結構描述。 使用​ 顯示臨機操作結構描述 ​切換功能,篩選使用名稱空間為僅供單一資料集使用的欄位所建立的結構描述清單。

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

在結構描述工作區的Relationship標籤上,您可以根據四個條件篩選關係清單。 篩選器包含Source結構描述、目的地結構描述、Source類別和目的地類別。 下表提供篩選的說明。

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

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

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

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

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

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

在畫布中探索XDM資源 explore

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

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

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

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

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

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

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

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

系統產生的欄位 system-fields

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

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

資料類型 data-types

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

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

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

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

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

欄位屬性 field-properties

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

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

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

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

身分欄位 identity

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

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

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

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

關係欄位 relationship

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

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

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

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

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

後續步驟

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

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