將現有網站移轉至 Bootstrap 版本 5

Bootstrap 版本 5 提供了新的功能和更新，讓您的 Power Pages 網站反應更快、更容易自訂。

重要

• 您可以將任何 Bootstrap 版本 3 網站移轉到版本 5，無論用於建立它們的範本為何。
• 將現有 Bootstrap 版本 3 網站移轉到版本 5 時，您可以使用標準資料模型或增強型資料模型。
• 請考慮使用開發人員網站測試移轉。
• 若要檢查 Bootstrap 的最新版本，請參閱您網站的 bootstrap.min.cssWeb 檔案。

若要移轉 Bootstrap 版本 3 網站，請依照下列步驟操作：

1. 下載網站資料夾。
2. 在該資料夾上執行移轉工具。
3. 檢查您的變更。
4. 上傳移轉後的網站記錄。
5. 清除伺服器端快取。

由於移轉步驟需要使用 Microsoft Power Platform CLI，因此請確保您了解如何在 Power Pages 中使用它：

• Microsoft Power Platform CLI 對 Power Pages 的支援
• 教學：將 Microsoft Power Platform CLI 與 Power Pages 結合使用
• pac pages

先決條件

• 安裝 Microsoft Power Platform CLI 版本 1.28.2 或更新版本。

• 如果您的網站使用 SVG 檔案，請確保 Power Platform 環境中的設定封鎖的附件文件副檔名系統設定允許「.svg」副檔名。

• 請考慮使用 Bootstrap 版本 3 建立兩個版本的 Power Pages 網站。 移轉其中一個網站並使用另一個作為參考與移轉後的網站進行比較。

下載網站資料夾

從 Microsoft Power Platform CLI 版本 1.27 開始，pac paportal 命令變更為 pac pages。 paportal 仍然有效，但我們建議您從現在起使用 powerpages。 這就是我們在以下說明中使用的形式。 如果您正在使用 Microsoft Power Platform CLI 版本 1.26.6，請確保您使用 pac paportal 代替 pac pages。

1. 開啟命令提示字元。

2. 輸入以下命令以針對您的 Power Platform 環境向 Dataverse 組織進行驗證：pac auth create -u [Dataverse URL]

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

   其他資訊：pac auth create

3. 輸入以下命令產生組織中的網站清單：pac pages list

   記下您計劃移轉之網站的 WebSiteId 。

   其他資訊：pac pages list

4. 輸入以下命令下載網站資料夾：pac pages download --path [PATH] -id [WebSiteId-GUID]

   範例：pac pages download --path "c:\pac-powerpages\downloads" -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

   對於 id 參數，請使用您在上一個步驟中記下的 WebSiteId。

   其他資訊：pac pages download

在資料夾上執行移轉工具

輸入以下命令以在您下載的網站資料夾上執行移轉工具：pac pages bootstrap-migrate -p "WebsiteFolderPath"

範例：pac pages bootstrap-migrate -p "c:\pac-powerpages\downloads\bootstrap-dev-site"

此指令會建立一個資料夾名稱後附加「V5」的資料夾。

如果您在升級至 Bootstrap 版本 5 時遇到問題或想要還原至 Bootstrap 版本 3，請參閱如何從 Bootstrap 版本 5 還原至版本 3。

檢閱變更

如果您在移轉之前建立了網站的副本，請將其與版本 5 的網站進行比較。

1. 打開您在上一個步驟中建立的 V5 資料夾。

2. 開啟 HTML 或 CSS 檔案。

3. 在 Visual Studio Code 中，按 Ctrl+Shift+P 開啟命令提示字元。 輸入 bootstrap diff。

4. 版本 3 檔案和版本 5 檔案開啟。 將滑鼠懸停在每個突出顯示的變更上以進行查看。

上傳移轉後的網站記錄

輸入以下命令將移轉的網站記錄上傳到組織：pac pages upload --path [Folder-location]

範例：pac pages upload --path C:\pac-portals\downloads\custom-portal\

其他資訊：pac pages upload

上傳記錄後，移轉的網站將是 Bootstrap 版本 5 網站。 建議您 再次將網站與版本 3 網站進行比對，並根據需要修改 Bootstrap 版本 5 網站。

清除伺服器端快取

清除中繼資料/設定和資料表的伺服器端快取。

如何從 Bootstrap 版本 5 還原到版本 3

要恢復到 Bootstrap 版本 3：

1. 執行上傳命令，將版本 5 資料夾替換為 Bootstrap 版本 3 資料夾。 如需進一步了解，請參閱 pac pages bootstrap-migrate。
2. 開啟入口網站管理應用程式，然後刪除 Site/BootstrapV5Enabled 網站設定。 如需進一步了解，請參閱設定網站的網站設定。
3. 清除伺服器端快取。 如需進一步了解，請參閱 Power Pages 中的伺服器端快取如何運作

另請參閱

• 啟動程序概觀
• 使用 Bootstrap 版本 5 建立新網站
• 管理 CSS 檔案