将现有站点迁移到 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 中使用：

• Power Pages 的 Microsoft Power Platform CLI 支持
• 教程：将 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. 运行上传命令以用 Bootstrap 版本 3 文件夹替换版本 5 文件夹。 在 pac 页面 bootstrap-migrate 中了解更多。
2. 打开门户管理应用并删除 Site/BootstrapV5Enabled 站点设置。 更多信息请参阅配置网站站点设置。
3. 清除服务器端缓存。 更多信息请参阅服务器端缓存如何在 Power Pages 中工作。

另请参见

• Bootstrap 概览
• 使用 Bootstrap 版本 5 创建新网站
• 管理 CSS 文件