学习路径手动设置

项目
04/07/2023

Microsoft 365 学习路径为需要以下方案之一支持的组织提供手动设置：

你的组织有一个专用于培训的已建立 SharePoint Online 新式通信网站，你希望将学习路径添加到该网站。在此方案中，尚未在网站上设置学习路径 Web 部件。
你希望在组织的某个 SharePoint 通信站点中安装多语言支持的学习路径。该网站有或将有一个默认语言，不是英语，是学习路径支持的语言之一。下面是学习路径支持的语言：
英语
中文（简体）
法语
德语
意大利语（意大利）
日语（日本）
葡萄牙语（巴西）
俄罗斯 (俄罗斯)
西班牙语

手动设置学习路径需要使用 Windows PowerShell 和 SharePoint Online Management Shell 的经验。下面概述了手动设置学习路径的步骤：

验证是否满足所有先决条件。
检查网站的默认语言设置。如果确定，请继续手动安装。如果需要其他默认语言设置，则需要创建新网站。
在 SharePoint 租户应用目录中安装 customlearning.sppkg 文件。
预配/标识用作 Microsoft 365 学习路径主站点的新式通信网站。
执行 PowerShell 脚本，该脚本将使用学习路径所依赖的项目配置租户。
导航到 CustomLearningAdmin.aspx 网站页以加载管理员 Web 部件以初始化自定义内容配置。

先决条件

若要确保成功手动设置学习路径 Web 部件，必须满足以下先决条件。

必须已设置并配置租户范围的应用目录。请参阅“设置Office 365租户并按照”创建应用目录“网站部分进行操作。
如果已预配租户范围的应用目录，则需要访问有权将包上传到它的帐户。通常，此帐户具有 SharePoint 管理员角色。
如果具有该角色的帐户不起作用，请转到 SharePoint 管理中心，找到应用目录网站集的网站集管理员，并以网站集管理员之一的身份登录，或者将失败的 SharePoint 管理员帐户添加到网站集管理员。
还需要访问 SharePoint 租户管理员帐户。

步骤 1 - 检查语言设置

作为手动安装过程的第一步，请检查站点语言设置。下面是可能的选项：

选项 1 - 不需要多语言支持

如果不希望对站点提供多语言支持，请确保已关闭。

在 SharePoint 通信网站中，选择 “设置>网站信息>”查看所有网站设置语言>设置。
将 “启用”页面和新闻设置为转换为多种语言 ，切换为 “关闭”。
单击“保存”。
继续执行步骤 2。

选项 2 - 需要多语言支持，并且默认语言正常

SharePoint 通信网站具有默认语言。默认语言确定查看学习路径的语言，包括学习路径管理页。在首次创建站点时设置默认语言设置，之后无法更改。继续手动设置之前，请确保目标站点的默认语言正常。

在 SharePoint 通信网站中，选择 “设置>网站信息>”查看所有网站设置语言>设置。
将 “启用”页面和新闻设置为转换为多种语言 ，切换到 “打开”。
- 如果可以使用“ 语言”下列表顶部显示的语言，可以添加其他语言，然后单击“ 保存”。继续执行步骤 2。
- 如果希望使用与为网站选择的语言不同的默认语言，则需要使用所需的语言创建新的 SharePoint 通信网站。继续执行选项 3。

选项 #3 - 需要多语言支持，但需要网站的不同默认语言

使用此选项，可以使用所需的默认语言创建新的 SharePoint Online 通信网站，然后设置网站的语言设置。

若要创建新的 SharePoint 通信网站，请参阅 SharePoint Online 中的“创建通信网站”。创建网站时，请务必将语言设置为学习路径所需的默认语言。
从创建的网站中，选择 “设置>网站信息>”查看所有网站设置语言>设置。
将 “启用”页面和新闻设置为转换为多种语言 ，切换到 “打开”。
如有必要，添加其他语言，然后单击 “保存”。
继续执行步骤 2。

![注意]如果需要将自定义内容从网站迁移到新创建的网站，请参阅本文档后面的“迁移自定义内容”部分。

步骤 2 - 从 GitHub 获取 Web 部件包和设置脚本

在安装过程中，需要 Microsoft 365 学习路径 Web 部件包和 PowerShell 安装脚本。

转到学习路径 GitHub 存储库。
单击 “下载 ”将 Web 部件包和脚本保存到本地驱动器。在此过程的后续步骤中，你将使用脚本和 Web 部件包。

步骤 2 - 将 Web 部件上传到租户应用目录

若要设置 Microsoft 365 学习路径，请将 customlearning.sppkg 文件上传到租户范围的应用目录并部署它。有关如何将应用添加到应用目录的详细说明，请参阅 “使用应用目录”使自定义业务应用可用于 SharePoint Online 环境。

步骤 3 - 预配/标识新式通信站点

标识现有的 SharePoint 通信网站，或在 SharePoint Online 租户中预配新网站。有关如何预配通信网站的详细信息，请参阅在 SharePoint Online 中创建通信网站，并按照步骤创建通信网站。

步骤 4 - 将 Microsoft 365 学习路径应用添加到站点

在 SharePoint 网站中，单击“系统”菜单，然后单击 “添加应用”。
在“应用”下，单击“从组织开始”，然后单击Office 365的学习路径。

步骤 5 - 设置网站的权限

确保为站点设置以下权限：

网站集管理员或所有者组的一部分 - 初始化自定义Config 列表项所需的权限，这些项可设置首次使用的学习路径。
成员组 - 管理学习路径所需的权限，包括隐藏和显示内容以及管理自定义播放列表
访问者组 - 查看网站内容所需的权限。

步骤 6 - 执行 PowerShell 配置脚本

包含一个 PowerShell 脚本，需要执行该脚本 CustomLearningConfiguration.ps1 才能创建解决方案使用的三个租户属性。此外，该脚本还会在网站页库中创建两个单部分应用页，以在已知位置托管管理员和用户 Web 部件。

如果尚未下载 SharePoint Online Management Shell，请立即下载。请参阅 SharePoint Online Management Shell 下载。
可能需要设置 PowerShell 执行策略才能运行脚本。有关详细信息，请参阅 “关于执行策略”。
CustomLearningConfiguration.ps1执行脚本。除了租户管理员凭据，该脚本还会提示输入租户名称和站点名称。考虑到站点 URL 的以下示例，https://contoso.sharepoint.com/sites/O365CLcontoso租户名称是O365CL站点名称。

禁用遥测集合

此解决方案的一部分包括匿名遥测跟踪选择加入，默认情况下将其设置为启用。如果正在手动安装并且想要关闭遥测跟踪，请更改 CustomlearningConfiguration.ps1 脚本，将$optInTelemetry变量设置为$false并运行脚本。

验证预配成功并初始化 CustomConfig 列表

成功运行 PowerShell 脚本后，导航到站点，初始化自 定义Config 列表项，以设置首次使用的学习路径，并验证站点是否正常工作。

转到 <YOUR-SITE-COLLECTION-URL>/SitePages/CustomLearningAdmin.aspx。打开 CustomLearningAdmin.aspx 会初始化 CustomConfig 列表项，以设置首次使用的学习路径。应会看到如下所示的页面：

管理员应用页

将所有者添加到站点

由于租户管理员，你不太可能是自定义网站的人员，因此你需要为网站分配几个所有者。所有者在网站上具有管理权限，因此他们可以修改网站页面并重新命名网站。他们还能够隐藏和显示通过学习路径 Web 部件提供的内容。此外，他们还能够生成自定义播放列表并将其分配给自定义子类别。

在“SharePoint 设置”菜单中 ，单击 “网站权限”。
单击 “高级权限设置”。
单击Office 365所有者的学习路径。
单击 “新建>添加用户”到此组，然后添加要成为所有者的人员。
添加链接以在“共享”消息中浏览网站，然后单击 “共享”。

迁移自定义内容

按照上述步骤重新建立学习路径网站后，需要移动 CustomPlaylists 列表和 CustomAssets 列表的内容。也可以（可选）移动构成自定义资产的实际自定义页面（如果它们位于现有学习路径网站中），而你的意图是将其删除。任务可能很困难，因为对于 CustomPlaylists 列表中的所有项， CustomAssets 列表中的列表项的 ID 将埋藏在每个播放列表列表项的 JSONData 字段中。因此，仅仅将 CustomPlaylists 列表的内容从一个站点移到另一个站点是不够的。此外， CustomAssets 列表包含列表项的 JSONData 字段中自定义资产页面的绝对 URL。如果资产未移动且站点未重命名 (因此将绝对 URL 更改为资产的页面) ，则 CustomAssets 可以保留。但你需要手动更正条目。鉴于这种类型的迁移的复杂性，我们建议你考虑招募我们的学习途径合作伙伴之一，以帮助你进行这种转变。

后续步骤

请参阅自定义学习路径。
请参阅翻译网站页。