通过

多语言学习路径的配置选项

  • 项目

随着 SharePoint Online 通信网站的多语言功能的发布，学习路径现在在最新版本 v4 中提供对多种语言的支持。

安装方案

方案 1：我们不需要多语言支持

好消息，即使未在网站集中启用多语言页面功能，v4 也非常适合你。 通过升级，可以获得一些可能对你有用的更新，例如图像选择器 UI，用于为自定义播放列表选择图像，以及添加用于将默认图像更改为自定义子类别的 UI。 此外，还对查看器 Web 部件进行了一些其他小修复。 查看 更新解决方案中所述的升级说明。

方案 2：我们需要多语言支持，网站集的默认语言是我们的默认语言

好消息，v4 将支持你在网站集中启用多语言页面功能！ 为了获得最佳体验，请按照以下步骤升级解决方案：

  1. 导航到Microsoft 365 学习路径main网站集，这是网站页面库中具有CustomLearningAdmin.aspx页面的学习路径。
  2. 在现有 Microsoft 365 学习路径网站中启用多语言发布功能。 有关详细信息，请参阅以下说明： 创建多语言通信网站、页面和新闻。 只需启用想要支持的语言。 请注意， 不要 启用解决方案不支持的语言。 如果你这样做，你的用户最终将得到一个部分体验，其中菜单和Microsoft提供的内容以默认语言显示，并且你的自定义内容以不支持的语言显示，假设用户选择了该语言作为其默认语言。 学习路径支持的语言的完整列表，请参阅 学习路径的多语言支持概述。
  3. 按照 更新解决方案的说明进行操作，该解决方案将安装版本 4.x.x 的 Microsoft 365 学习路径解决方案。
  4. 导航到 Microsoft 365 学习路径网站集的网站页面库中的CustomLearningAdmin.aspx页，这会启动升级过程。 版本 4.x 包括新的升级体验，该体验记录正在处理的每个升级步骤。 通过添加到 ?forceUpdate=v3 管理页面 URL 的末尾，可以随时再次运行升级过程。 值 v3 指示要从哪个版本的学习路径进行升级。 例如：https://contoso.sharepoint.com/sites/M365LP/SitePages/CustomLearningAdmin.aspx?forceUpdate=v3。

方案 3：我们需要多语言支持，网站集的默认语言不是我们的默认语言

好消息和坏消息。 好消息是 v4 将支持你的方案;坏消息是，创建网站集后无法更改其默认语言。 如果没有自定义内容，则前进路径非常简单：

创建新的Microsoft 365 学习路径网站 - 无自定义内容

  1. 创建新的网站集，确保根据学习内容的默认语言为网站集选择默认语言 (称为 /NewLP) 。
  2. 在 /NewLP 网站中启用多语言发布功能。 有关详细信息，请参阅以下说明： 创建多语言通信网站、页面和新闻。 只需启用想要支持的语言。 请注意， 不要 启用解决方案不支持的语言。 如果你这样做，你的用户最终将得到一个部分体验，其中菜单和Microsoft提供的内容以默认语言显示，并且你的自定义内容以不支持的语言显示，假设用户选择了该语言作为其默认语言。 学习路径支持的语言的完整列表，请参阅 学习路径的多语言支持概述。
  3. 按照更新解决方案中概述的升级说明安装新的 customlearning.sppkg 文件。
  4. M365lpConfiguration.ps1运行 PowerShell 脚本，确保将 /NewLP 网站作为网站集传入。

    注意

    需要网站集管理员访问应用程序目录网站和 /NewLP 网站才能成功运行此脚本。

  5. 假设 PowerShell 脚本成功完成，应能够导航到启动升级过程的 /NewLP/site pages/CustomLearningAdmin.aspx 页。 版本 4 包括新的升级体验，该体验记录正在处理的每个升级步骤。 通过添加到 ?forceUpdate=v3 管理页面 URL 的末尾，可以随时再次运行升级过程。 值 v3 指示要从哪个版本的学习路径进行升级。 例如：https://contoso.sharepoint.com/sites/M365LP/SitePages/CustomLearningAdmin.aspx?forceUpdate=v3。

注意

如果不再需要旧的学习路径网站，一旦新网站的管理页面 CustomLearningAdmin.aspx 正常工作，就可以将其删除。

创建新的Microsoft 365 学习路径网站 - 自定义播放列表和资产

按照上述步骤重新建立学习路径网站后，需要努力移动 CustomPlaylists 列表和 CustomAssets 列表的内容。 还可以（可选）移动构成自定义资产的实际自定义页面（如果它们位于现有学习路径网站中），并且你的意图是删除它们。

此任务的难点在于，对于 CustomPlaylists 列表中的所有项目，CustomAssets 列表中列表项的 ID 都隐藏在每个 JSONData 播放列表列表项的字段中。 因此，仅将 CustomPlaylists 列表的内容从一个网站移动到另一个网站是不够的。 此外，CustomAssets 列表包含列表项字段中自定义资产页面 JSONData 的绝对 URL。 如果未移动资产，并且网站未重命名 (因此更改资产页面的绝对 URL) 则它可以保留。 但是，如果发生上述任一情况，则需要手动更正条目。

鉴于此类迁移的复杂性，建议考虑登记我们的学习路径合作伙伴之一，以帮助你进行这种转换。