Show Menu
主題×

使用 Schema Editor

Adobe Experience Platform使用者介面可讓您在稱為的互動式 Experience Data Model 視覺畫布中建立和管理(XDM)結構 Schema Editor。 本教學課程介紹如何使用建立模式 Schema Editor。
為了進行示範,本教學課程中的步驟包括建立描述客戶忠誠度方案成員的範例架構。 雖然您可以使用這些步驟來建立不同的架構,但建議您先遵循建立範例架構的步驟,以瞭解其功能 Schema Editor。
如果您偏好使用 Schema Registry API來編寫架構,請先閱讀開發人員指南 Schema Registry ,再嘗試使用API 建立架構的教學課程 使用 Schema Registry API建立結構

快速入門

本教學課程需要對架構建立中涉及的Adobe Experience Platform各個方面有深入的瞭解。 在開始本教學課程之前,請先閱讀說明檔案,瞭解下列概念:

瀏覽結構工作區中的現 有結構

UI中 的 「結構描述」工作區 Platform 提供了結構的可視化效果 Schema Library,允許您查看管理組織可用的結構描述。 工作區也包含畫 Schema Editor布,您可在此教學課程中,在畫布上編寫架構。
登入後, Experience Platform在左側導 覽中選取「方 案」 ​。 「瀏 」頁籤顯示可查看和自定義的方案清單( Schema Library表示方案)。 該清單包括方案所基於的名稱、類型、類和行為(記錄或時間序列),以及上次修改方案的日期和時間。
選取搜尋列旁的篩選圖示,以針對註冊表中的所有資源(包括類別、混合和資料類型)使用篩選功能。 您也可以根據資源是否歸Adobe或您的組織所有,以及是否已啟用供使用,來進行篩選 Real-time Customer Profile。

建立架構並命名架構

要開始合成方案,請選 「方案」工作區右上角的「創 建方案 」。 此時會出現下拉式功能表,提供您選擇核心類別 XDM Individual Profile 和 XDM ExperienceEvent的選項。 如果這些類不符合您的目的,您也可以選擇「瀏覽」( Browse )以從其他可用類中選擇, 或者建立新類
在本教學課程中,請選擇「 XDM個別描述檔」
將出 Schema Editor 現。 這是您將在其中構成架構的畫布。 由於您選擇了標準XDM類作為架構的基礎,因此當您到達編輯器時,將自動在畫布的「結構」部分中建立未命名的架構,並基於該類在所有架構中包含的標準欄位。 ​方案的已分配類也列在「合成」部 分的 「類 」下
在保 存架構之前,您可以在初始合成過程中的任意點更改架構類 ,但應該非常小心。 Mixins僅與特定類別相容,因此變更類別會重設畫布和您新增的任何欄位。
使用編輯器右側的欄位,提供架構的顯示名稱和選用說明。 輸入名稱后,畫布會更新以反映架構的新名稱。
在決定架構的名稱時,需要考慮幾個重要事項:
  • 架構名稱應簡短且具說明性,以便稍後可輕鬆找到架構。
  • 架構名稱必須是唯一的,這表示它也應足夠具體,以免日後重複使用。 例如,如果您的組織針對不同品牌有不同的忠誠度方案,最好將方案命名為「品牌A忠誠度成員」,以便輕鬆區分您稍後可能定義的其他忠誠度相關方案。
  • 您也可以使用結構描述來提供與結構描述相關的任何其他上下文資訊。
本教程將構建一個方案,以便接收與忠誠度方案成員相關的資料,因此,該方案名為「忠誠度成員」。

新增混音

您現在可以新增mix,開始將欄位新增至您的架構。 混音是一組一個或多個欄位,通常一起用於描述特定概念。 本教學課程使用mixin來描述忠誠度計畫的成員,並擷取關鍵資訊,例如姓名、生日、電話號碼、地址等。
若要新增混音,請在 Mixins子區段中 ,選 「新增」。
隨即出現新對話方塊,顯示可用混音清單。 每個混音都僅用於特定類,因此對話框僅列出與您選擇的類(在本例中為類)相容的混 XDM Individual Profile 音。 如果您使用標準XDM類別,則會根據使用人氣,智慧地排序混合清單。
從清單中選取混音,會使混音出現在右側邊欄中。 您可以視需要選取多個混音,在確認前先將每個混音新增至右側邊欄的清單。 此外,目前選取混音的右側會出現一個圖示,可讓您預覽其提供的欄位結構。
在預覽混音時,在右側導軌中提供混音的結構的詳細描述。 您也可以瀏覽所提供畫布中的mixin欄位。 當您選取不同欄位時,右側欄位會更新,以顯示相關欄位的詳細資訊。 在預 覽完成時 ,選取「上一步」,返回混音選擇對話方塊。
在本教學課程中,選取「描述檔 人員詳細資料 」混合,然後選 取「新增混合」
結構畫布會重新出現。 Mixins 區段現在會列 出「Profile person details」(描述檔人員詳細資訊),而Structure ​區段則包含mixin貢獻的欄位。 您可以在「 Mixins 」區段下選取mixin的名稱,以反白顯示它在畫布中提供的特定欄位。
此混音在頂層名稱下提供數個欄位, person 資料類型為「Person」。 此欄位群組說明個人的相關資訊,包括姓名、出生日期和性別。
請記住,欄位可能使用在中定義的標量類型(例如字串、整數、陣列或日期),以及任何資料類型(表示共同概念的欄位群組) Schema Registry。
請注意, name 欄位的資料類型為「Full name」,這表示它也說明一個通用概念,並包含與名稱相關的子欄位,例如名字、姓氏、字首和字尾。
選擇畫布中的不同欄位,以顯示它們對架構結構所貢獻的其他欄位。

新增另一個混音

您現在可以重複相同的步驟來新增另一個混音。 此時,當您檢視「 Add mixin 」(新增混音)對話方塊時,請注意,「Profile person details」混音已變灰,且旁邊的核取方塊無法選取。 這可防止意外複製您已包含在目前架構中的混音。
在本教學課程中,從對話方Profile personal details塊中選取「」混音,然後選取「 新增混音 」將其新增至架構。
新增後,畫布會重新顯示。 「Profile personaldetails 」現在會列在「Composition 」(合成)區段的「 Mixins 」(設定檔個人詳細資訊)下,而「 ​Structure」(結構)下則會新增家庭位址、行動電話等欄位。
與欄位類 name 似,您剛新增的欄位代表多欄位概念。 例如, homeAddress 資料類型為「郵遞區號」, mobilePhone 資料類型為「電話號碼」。 您可以選取每個欄位以展開這些欄位,並查看資料類型中包含的其他欄位。

定義新混音

「忠誠會員」架構旨在擷取與忠誠度方案成員相關的資料,因此需要某些特定的忠誠度相關欄位。 沒有可用的標準混音包含必要的欄位,因此您需要定義新的混音。
此時,當您開啟「新增 Mixin」對話方塊 ,請選 取「建立新Mixin」 。 接著會要求您提供混 音的顯示名 稱和說 明。
和類名一樣,混音名應簡短,說明混音對架構的貢獻。 這些名稱也是唯一的,因此您將無法重複使用名稱,因此必須確保它足夠具體。
在本教學課程中,請將新混音命名為「忠誠度詳細資」。
取「新增 mixin」以返回 Schema Editor。 「Loyalty Details」(忠誠度詳細資訊)現在應會顯示在畫布左側的 Mixins下方,但是目前尚無相關欄位,因此「結構」下方不會顯示新 欄位

新增欄位至混音

現在您已建立「Loyalty Details」混音,是時候定義混音將對結構貢獻的欄位了。
首先,在「混音」區段中選取混音 名稱 。 執行此操作後,mixin的屬性會顯示在編輯器的右側,而「結構」( Structure )下的架構名稱旁會出現「添加欄位 」按鈕
擇「 」旁的「添加」欄位Loyalty Members,在結構中建立新節點。 此節點(在此範例中稱為"_tenantId")代表您IMS組織的租用戶ID,前面加上底線。 租用戶ID的存在表示您新增的欄位包含在您組織的命名空間中。
換言之,您新增的欄位對您的組織而言是獨一無二的,而且會儲存在您 Schema Registry 組織只能存取的特定區域。 您定義的欄位必須一律新增至您的租用戶名稱空間,以避免與其他標準類別、混合、資料類型和欄位的名稱產生衝突。
該命名空間節點內部有一個「新欄位」。 這是「忠誠度詳細資訊」混合的開始。
使用編輯器右側的控制項,首先建立類型為 loyalty "Object"的欄位,以用來保存您的忠誠度相關欄位。 完成後,選擇「應 用」
將應用更改,並顯示新建立 loyalty 的對象。 選取 物件旁的 「新增欄位」,以新增其他與忠誠度相關的欄位。 「新欄位」隨即出現,畫布的右側 會顯示「欄位屬性 」區段。
每個欄位都需要下列資訊:
  • 欄位名稱: 欄位的名稱,用駝峰寫的。 範例:loyaltyLevel
  • 顯示名稱: 欄位名稱,以標題大寫寫。 範例:忠誠度等級
  • 類型: 欄位的資料類型。 這包括基本標量類型和中定義的任何資料類型 Schema Registry。 範例: 字串Integer NeterBoolean​, Person, Person Address, Phone number,等等。
  • 說明: 該欄位的可選說明應包括在句子中,最多200個字元。
對象的第一個 Loyalty 欄位將是名為的字串 loyaltyId 。 將新欄位的類型設定為"String"時, Field "部分會填入幾個用於應用約束的選項,包括 Default value Format Gramixt、Maximum lengthContributes。
根據所選資料類型,可使用不同的約束選項。 由於 loyaltyId 會是電子郵件地址,所以請從「格式」下拉式選單中選取「電子郵件 ​」。 選擇 應用 ,以應用更改。

新增更多欄位至混音

現在您已新增欄位, loyaltyId 您可以新增其他欄位來擷取與忠誠度相關的資訊,例如:
  • 點(整數)
  • 會員登記(日期)
每個欄位都會新增,方 法是選取物件上的 「新 loyalty 增」欄位並填入所需資訊。
完成後,「忠誠度」物件將包含忠誠度ID、點數和成員間隔的欄位。

新增列舉欄位至混音

在中定義欄位時 Schema Editor,有一些附加選項可以應用於基本欄位類型,以便對欄位可以包含的資料提供進一步的約束。 下表說明了這些約束的使用案例:
約束
說明
必填
指出資料擷取需要此欄位。 任何根據此架構上傳至資料集且不包含此欄位的資料,在擷取時都會失敗。
陣列
指出欄位包含一組值,每個值都指定了資料類型。 例如,在資料類型為"String"的欄位上使用此限制會指定欄位將包含字串陣列。
Enum
指出此欄位必須包含可能值列舉清單中的其中一個值。
身份
指出此欄位是身分欄位。 有關身分欄位的詳細資訊,請 參閱本教學課程
關係
雖然方案關係可以通過使用union方案和來推斷 Real-time Customer Profile,但這僅適用於共用相同類的方案。 關係 約束表示 ,此欄位引用基於不同類的方案的主標識,這表示兩個方案之間的關係。 如需詳細資訊,請 參閱定義關係 的教學課程。
在本教學課程中, "loyalty" 架構中的物件需要新的列舉欄位,以說明客戶的「忠誠度等級」,其中值只能是四個可能選項之一。 要將此欄位添加到方案中,請選擇對 像旁邊的 「添加欄位」, loyalty 並填寫「欄位名 」和「顯 示名」的必需欄位 。 對於 類型 ,選擇「字串」。
選取欄位類型後,會顯示其他核取方塊,包括 Array Enum ​和 Identity的核取方塊
選擇 Enum 複選框以開啟 Enum值部分 。 您可以在此輸入每個可 接受的忠誠度等級的Value (camelCase中)和 Label (Title Case中的可選Reader友好名稱)。
完成所有欄位屬性後,選擇 應用 ,將「loyaltyLevel」欄位添加到對 loyalty 像。

將多欄位物件轉換為資料類型

loyalty 物件現在包含數個忠誠度特定欄位,並代表通用資料結構,可在其他結構中派上用場。 可 Schema Editor 讓您將這些物件的結構轉換為資料類型,以輕鬆套用可重複使用的多欄位物件。
資料類型允許一致地使用多欄位結構,並提供比混音更大的靈活性,因為它們可以在架構中的任意位置使用。 若要這麼做,請將欄位的「類 」值設為中定義之任何資料類型的值 Schema Registry。
要將對 loyalty 像轉換為資料類型,請選擇「結構」下的字 loyalty 段,然後選擇「 Convert to new data type 」(轉換為新資料類型),位於編輯器右側的 Field properties Compress下。 出現綠色快顯,確認物件已成功轉換。
現在,當您查看「結構 」下方時 ,您會看到欄位的資料類型為「 loyalty Loyalty」,欄位旁邊有小型鎖定圖示,表示它們不再是個別欄位,而是多欄位資料類型的一部分。
在未來的架構中,您現在可以指派 Type "Loyalty"欄位,並自動包含ID、忠誠度等級、成員自由和點數的欄位。

搜尋和篩選結構欄位

您的架構現在除了其基本類別提供的欄位外,還包含數個混音。 使用較大的結構時,您可以選擇左側導軌中混音名稱旁的核取方塊,將顯示的欄位篩選為您感興趣的混音所提供的欄位。
如果您在架構中尋找特定欄位,也可以使用搜尋列來依名稱篩選顯示的欄位,而不論其下提供何種混音。

將架構欄位設定為身份欄位

架構所提供的標準資料結構可用於跨多個來源識別屬於同一個人的資料,允許各種下游使用案例,例如分段、報告、資料科學分析等。 為了根據個別身分來接合資料,索引鍵欄位必須標示為適用結構 中的 「身分欄位」。
Experience Platform 使您可以透過使用中的「身分」核取方塊,輕鬆地 標示身分 欄位 Schema Editor。 不過,您必鬚根據資料的性質,判斷哪個欄位最適合做為身分識別。
例如,可能有數千個忠誠度方案會員屬於相同的「忠誠度等級」,但忠誠度方案的每個會員都有一個獨特的 loyaltyId (在此例中為個別會員的電子郵件地址)。 每個成員 loyaltyId 的唯一識別碼使其成為身份欄位的良好候選者,但 loyaltyLevel 不是。
下面介紹的步驟介紹如何將身份描述符添加到現有模式欄位。 除了在架構本身的結構中定義身份欄位外,您還可以使用一個欄位來 identityMap 改為包含身份資訊。
如果您打算使 identityMap 用,請記住,它將覆蓋您直接添加到架構的任何主要標識。 有關詳細資訊, identityMap 請參 閱架構構成指南的 「基礎」部分。
在編輯器 的「結構 」部分,選擇該欄位,並在「欄位屬性」 loyaltyId 下顯示「 Identity 」複選 。 選中該框並顯示將其設定為主標識 的選項 。 也選擇此框。
每個架構只能包含一個主標識欄位。 一旦將方案欄位設定為主標識,如果您稍後嘗試將方案中的另一個標識欄位設定為主標識,將會收到錯誤消息。
接下來,您必須從下拉式清 單中預先定義的名稱空間清單中 ,提供Identity命名空間。 由 loyaltyId 於是客戶的電子郵件地址,請從下拉式清單中選擇「電子郵件」。 選擇 應用 ,確認對欄位的更 loyaltyId 新。
有關標準名稱空間及其定義的清單,請參閱文 Identity Service 檔
套用變更後,指令的圖示 loyaltyId 會顯示指紋符號,表示它現在是識別欄位。 此外,左側邊欄 Loyalty Details 中的混音會列出其下方的識別欄位,讓您輕鬆判斷架構中哪個混音會提供該架構的識別欄位。
現在,所有包含在欄位 loyaltyId 中的資料都將用來協助識別該個人,並將該客戶的單一檢視結合在一起。 若要進一步瞭解在中使用身 Experience Platform份,請檢閱 Identity Service檔案

啟用模式以用於 Real-time Customer Profile

即時客戶個人檔案 利用身分資料, Experience Platform 提供每位客戶的全貌。 此服務可建立強穩、360°的客戶屬性描述檔,以及客戶在與之整合的任何系統上,所有互動的時間戳記帳戶 Experience Platform。
要啟用與一起使用的模式, Real-time Customer Profile它必須定義主標識。 如果您嘗試啟用方案而未先定義主要身分,則會收到錯誤訊息。
要啟用「忠誠成員」結構以用於 Profile,請首先在編輯器的「結Loyalty Members構 」部分中選擇「 」。
在編輯器的右側,會顯示有關架構的資訊,包括其顯示名稱、說明和類型。 除了此資訊外,還有「描述檔 切換 」按鈕。
選擇 描述檔 ,然後出現一個快顯視窗,要求您確認您要為其啟用架構 Profile。
在模式啟用並保存後, Real-time Customer Profile 便無法禁用它。
選取「 啟用 」以確認您的選擇。 如果您願意,可以再次選擇 Profile toggle以禁用該架構,但一旦在啟用時保存了該 Profile 架構,就不能再禁用它。

後續步驟和其他資源

現在,您已完成架構合成,您就可以在畫布中看到完整的架構。 選擇 保存 ,並將模式保存到中 Schema Library,使模式可由訪問 Schema Registry。
您的新架構現在可用來將資料內嵌至 Platform。 請記住,一旦使用架構來收錄資料,則只能進行加性變更。 有關方案 版本化的詳細資訊 ,請參閱方案構成的基本資訊。
您現在可以遵循在UI中定 義結構關係的教學課程 ,在「忠誠度成員」結構中新增關係欄位。
「忠誠度成員」結構也可供使用 Schema Registry API檢視和管理。 若要開始使用API,請先閱讀開發人員 Schema Registry API 指南

視訊資源

下 Platform 列影片中顯示的UI已過時。 請參閱上述檔案以取得最新的UI螢幕擷取和功能。
以下視訊說明如何在UI中建立簡單的 Platform 架構。

以下影片旨在強化您對使用混合與類別的瞭解。

附錄

以下各節提供有關使用的附加資訊 Schema Editor。

Create a new class

Experience Platform 提供了根據組織唯一的類定義方案的靈活性。
在「方 」工作區中,選 擇「建立方案 」,然後從下拉式 清單中選擇「瀏覽 」。
此時將出現一個對話框,允許您從可用類清單中進行選擇。 在對話框頂部,選擇「創 建新類」 。 然後,您可以為新類指定顯示名稱 (類的簡短、描述性、唯一且用戶友好的名稱)、 Description 、和 Behavior (「 ​HoperRecord」或「Time Series」),用於方案將定義的資料。
當建立實作組織定義之類的架構時,請記住混合僅可用於相容類。 由於您定義的類別是新的,因此「新增混音」對話方塊中沒有列出相 容的混音 。 您需要選擇「建立新 混音」 ,並定義混音以用於該類別。 下次構建實施新類的模式時,將列出您定義的混合併可供使用。

更改方案的類

可以在保存模式之前,在初始合成過程中的任意點更改模式的類。
重新指派架構的類別時應格外小心。 Mixins僅與特定類別相容,因此變更類別會重設畫布和您新增的任何欄位。
若要重新指派類別,請 在畫布的左側 ,選取「指派」。
此時會出現一個對話框,其中顯示所有可用類的清單,包括您的組織定義的任何類(所有者是「Customer」)以及Adobe定義的標準類。
從清單中選擇一個類,在對話框的右側顯示其說明。 您也可以選取「預 覽類別結構 」,以查看與類別相關聯的欄位和中繼資料。 選擇 分配類 ,繼續。
隨即開啟新對話方塊,要求您確認您要指派新類別。 選擇 指派 ,以確認。
在確認類別變更後,畫布將重設,而所有的構圖進度都將遺失。