將標準資料模型網站移轉至增強型資料模型 (預覽版)

[本主題是發行前版本文件，並可能在未來變更。]

在本文中，您將瞭解如何將現有標準資料模型網站移轉至增強型資料模型。

重要

• 此功能是預覽功能。
• 預覽功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。

先決條件

• 您必須安裝 Microsoft Power Platform CLI 版本 1.31.6 或更心版本才能將網站移轉至增強型資料模型。 其他資訊：安裝最新的 Power Platform CLI
• Dataverse 基本入口網站套件 9.3.2307.x 或更新版本。 
• Power Pages 核心套件 1.0.2309.63 或更新版本。 其他資訊：更新 Power Pages 解決方案
• 您需要了解如何使用 Power Pages 中的 Power Platform CLI 來完成移轉步驟。 如果您不熟悉 Power Pages 中的 Power Platform CLI，您可能需要查看此 Power Platform CLI 教學課程，並參考用於使用 Power Pages 的 PAC CLI 命令。

步驟 1： 下載並檢查現有標準網站中繼資料的自訂

1. 開啟命令提示字元。

2. 使用下列指令向 Power Platform 環境的 Dataverse 組織進行驗證，以下載用於移轉的網站記錄。

   pac auth create -u [Dataverse URL]

   範例

   pac auth create -u https://contoso-org.crm.dynamics.com

   其他資訊：建立 PAC 驗證

3. 使用以下命令產生目前組織中的網站清單。

   pac powerpages list

   詳細資訊： PAC 電源頁面清單

4. 使用以下命令下載自訂報告。

   pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]

   範例

   pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"

如果在下載的報表中找到任何自訂，請按照報表中的指導在移轉到增強型資料模型後進行修復。 詳細資訊：將網站從標準模型移轉到增強型資料模型時網站自訂的注意事項

步驟 2： 將網站資料從標準資料模型移轉到增強型資料模型

使用以下命令將網站資料移轉到增強型資料模型。

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]

模型可以有 3 個值：

• configurationData：移轉網站的中繼資料。 詳細資訊：用於儲存設定資料的資料表清單

• configurationDataReferences：移轉網站的交易資料。 詳細資訊：用於儲存非設定資料的資料表清單

• 全部：移轉兩種類型的資料。

範例

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all

移轉工具會驗證解決方案。 如果存在標準資料模型解決方案，但沒有針對上述範本的相應增強型資料模型解決方案，則會顯示警告：Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

有一些特定的範本，例如計劃註冊以及安排和管理會議，需要比對增強型資料模型套件，以確保移轉的網站正常運作。 若要獲取這些增強型資料模型套件，必須為相應的範本建立一個新網站 (應為增強型資料模型啟用環境)，以提供增強型資料模型相容的移轉解決方案。

支援的移轉範本

支援移轉具有以下範本的網站：

• 入門配置 1-5
• 應用程式處理
• 空白頁面
• 方案註冊
• 排程及管理會議

步驟 3： 確認移轉狀態

使用以下命令驗證網站的移轉狀態：

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus

範例

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus

注意

如果您的網站移轉花費的時間比預期長，可能是因為資料量太大。 如果命令提示字元關閉，請打開新的命令提示字元，並使用此步驟中的命令來確認網站的狀態。

步驟 4. 成功移轉資料後更新網站資料模型版本

使用以下命令更新網站資料模型版本：

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]

注意

• 您可以透過瀏覽至網站 URL 後附加「/_services/about」的網站來找到入口網站識別碼。 若要查看這些選項，使用者應擁有指派了所有 網站存取權限的 Web 角色。
• 網站資料模型版本更新後，將停用連結到標準資料模型的網站記錄。 反之，該網站現在將參考與增強型資料模型關聯的網站記錄。
• 使用者應具有以下任一角色，才能使用 updateDatamodelVersion 或 revertToStandardDataModel 參數執行移轉命令。 因為這將執行管理動作以將您的網站切換到增強型資料模型，反之亦然。
  • 系統管理員
  • Dynamics 365 管理員
  • Power Platform 管理員
  • 全域管理員

範例

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e

將移轉的網站從增強型資料模型還原為標準資料模型

使用以下命令在移轉後將標準資料模型網站還原為增強型資料模型：

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]

注意

當您將移轉的網站從增強型資料模型切換回標準資料模型時，與增強型資料模型關聯的網站記錄將會停用，標準資料模型的網站記錄將重新啟動。

範例

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e

將生產網站從標準資料模型移轉到增強型資料模型

在移轉生產網站之前，建議先建立生產網站的完整副本。 我們還建議在非工作時間執行生產網站移轉。

使用以下步驟將您的生產網站移轉到增強型資料模型：

1. 使用 PAC CLI migrate-datamodel 命令在複製環境中的網站上嘗試移轉。
2. 將網站設定資料新增到受控解決方案並將其匯入生產環境。
3. 使用 PAC CLI 命令移轉非設定資料，並透過更新生產的資料模型版本來完成移轉。

注意

對於移轉，來源網站識別碼和生產網站識別碼相同。

將網站從標準模型移轉到增強資料模型時網站自訂的注意事項

本節提供從標準資料模型到增強型資料模型的網站移轉的修復自訂指南。

Adx 中繼資料表上有五種類型的網站自訂：

• Adx 中繼資料表上的自訂欄
• 自訂資料表和 Adx 資料表之間的關係
• Liquid 程式碼片段中的 Adx 資料表參考
• 擷取 XML 中的 Adx 資料表參考
• Adx 資料表上的自訂工作流程和外掛程式

注意

所有與自訂相關的修復都將在移轉到增強型資料模型後完成。

Adx 中繼資料表上的自訂欄

若要在增強型資料模型中修復此自訂，請在系統資料表和新的自訂資料表之間建立關係，並將資料移轉到新資料表。

標準資料模型：adx_webpage 資料表包含自訂欄作為 contoso_pagetype。

增強型資料模型：建立一個名為 contoso_webpage 的新資料表。 這將包括一個名為 contoso_pagetype 的欄和一個與 powerpagescomponent 關聯的 contoso_webpage_id 查詢欄。 利用資料工作區建立資料表。

自訂資料表和 Adx 資料表之間的關係

若要修復增強型資料模型中的此自訂，請在自訂資料表和系統資料表之間建立關係。

標準資料模型：adx_webpage 資料表與 contoso_pagelogs 資料表之間有一個名為 adx_webpage_contoso_pagelogs 的關係。

增強型資料模型：與 contoso_webpage 資料表建立一個名為 powerpagecomponent_contoso_pagelogs 的新關係。 利用資料工作區建立資料表。

Liquid 程式碼片段中的 Adx 資料表參考

若要修復增強型資料模型中的此自訂，請將 Liquid 程式碼中的 adx 資料表參考替換為增強資料模型虛擬資料表 mspp 參考。 或者，您可以使用網站元件 (邏輯名稱 powerpagecomponent) 表以及元件類型 (邏輯名稱 powerpagecomponenttype) 屬性來擷取相應的參考。

標準資料模型：entities Liquid 標籤用於存取 {% assign app_weblinks= entities['adx_weblinks'] %} 程式碼中的網路連結值。

增強型資料模型：不要透過 entities Liquid 標籤使用網路連結，而是使用各自的 Liquid 物件。 直接 entities[adx_weblinks]。 在這種情況下，entities['adx_weblinks'] 可以取代為 weblinks Liquid 物件。

擷取 XML 中的 Adx 資料表參考

若要修復增強型資料模型中的此自訂，請將擷取 xml 中的 adx 資料表參考取代為增強型資料模型虛擬資料表直接參考。 或者，您可以使用網站元件 (邏輯名稱 powerpagecomponent) 表以及元件類型 (邏輯名稱 powerpagecomponenttype) 屬性來擷取相應的參考。

標準資料模型：在擷取 xml 查詢中使用資料表名稱 adx_webrole。

{% fetchxml app_webroles %}
<fetch>
 <entity name='adx_webrole'>
  <attribute name='adx_name'/>
 <entity>
</fetch>
{% endfetchxml %}

增強型資料模型：使用網站元件 (邏輯名稱 powerpagecomponent) 搭配元件類型 (邏輯名稱 powerpagecomponenttype) 屬性來擷取相應的參考。

{% fetchxml app_webroles %}
<fetch>
 <entity name='powerpagecomponent'>
  <attribute name='adx_name'/>
  <filter type='and'>
   <condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
  <entity>
</fetch>
{% endfetchxml %}

網站元件類型和值

元件類型	數值
發行狀態	7
網頁	2
網頁檔案	3
網頁連結組	4
Web 連結	5
頁面範本	6
內容片段	7
Web 範本	8
網站設定	9
網頁存取控制規則	10
Web 角色	11
網站存取	12
網站標記	13
基本表單	15
基本表單中繼資料	16
清單	17
資料表權限	18
進階表單	19
進階表單步驟	20
進階表單中繼資料	21
投票位置	24
廣告位置	26
Bot 消費者	27
資料行權限設定檔	28
資料行權限	29
重新導向	30
發佈狀態轉換規則	31
捷徑	32
雲端流程	33
UX 元件	34

Adx 資料表上的自訂工作流程和外掛程式

若要在增強型資料模型中修復此自訂，需要在網站各自的資料表上重構並重新註冊工作流程和外掛程式邏輯。

例如，如果使用者將工作流程/外掛程式作為標準資料模型中的網頁 (邏輯名稱 adx_webpage) 表註冊到主要實體，則必須將工作流程/外掛程式中的程式碼修改為網站元件 (邏輯名稱 powerpagecomponent) 表及其增強型資料模型的屬性。

已知問題

移轉命令僅處理從標準資料模型到增強型資料模型的一批 5K 記錄。