本文介绍如何将 SAP SuccessFactors 配置为用于Microsoft Viva Learning的第三方学习管理系统。 这涉及到在“Viva Learning”下的“管理员”选项卡中加入，然后在 SuccessFactors Portal 中加入。
注意
本文概述了首次将Viva Learning与 SuccessFactors 集成的客户的更新体验。 如果你的客户已将 SuccessFactors 添加为内容源，请参阅我们 以前的文档
可通过Viva Learning访问的内容受Microsoft产品条款以外的条款约束。 SAP SuccessFactors 内容和任何关联的服务都受 SAP SuccessFactors 隐私和服务条款的约束。
先决条件
有两个主要集成阶段，管理员需要特定权限。
Viva Learning 管理员 接口：
获取Viva Learning 管理员访问权限管理员可以从 Teams Viva Learning 应用中的“管理员”选项卡或使用浏览器管理其Viva Learning内容。 有关详细信息 ，请参阅管理选项卡中的内容 。
SAP SuccessFactors Learning：
用户在 SAP SuccessFactors 门户中需要学习管理访问权限。 学习管理员使用 学习管理 模块管理学习管理系统 (LMS) ，包括学习者配置文件、学习内容和学习需求管理。
载入
在 Teams 或 Web 上打开 Viva Learning 应用。
转到Viva Learning中的“管理员”选项卡，然后选择“管理提供程序”。
选择“ 添加提供程序”。
从“提供程序”列表中选择“ SAP SuccessFactors ”，然后选择“ 下一步”。
SuccessFactors API 配置
若要在 Viva Learning 与 SuccessFactors 系统之间建立基本连接，需要此步骤。 它使Viva Learning能够针对初始同步和后续同步触发从 SuccessFactors 生成完整同步包和增量包。 用户需要提供 SuccessFactors API 配置详细信息：
注意
Viva Learning仅访问合作伙伴提取配置 API 和临时包生成 API。 这种与 SuccessFactors 的无缝集成由 SuccessFactors API 驱动，需要 SuccessFactors 管理员详细信息才能具有以下权限。
- 编辑系统配置
- 查看系统配置
客户端学习目标 URL：可以从学习域模块 URL 获取此 URL。 例如，如果学习域 URL 为 organization.scdemo.successfactors.com/learning/...则 organization.scdemo.successfactors.com 学习目标 URL。
客户端 ID
客户端的管理员用户 ID
管理员客户端密码
有关从 SAP SuccessFactors 获取客户端 ID、客户端管理员用户 ID & 管理员 客户端机密属性的详细信息，请参阅 SAP SuccessFactors 所需的属性部分
创建 PGP 密钥
SuccessFactors 将数据发送到文件包中的Viva Learning。 这些文件使用 PGP 密钥进行加密，因此只能由Viva Learning读取。 此步骤生成唯一的 PGP 密钥对，SuccessFactors 将使用该密钥对来加密Viva Learning的数据包。
管理员需要输入以下详细信息才能生成 PGP 密钥：
姓名 (密钥所有者姓名) - 理想情况下，这是在此页面上输入详细信息的人员的姓名。 SuccessFactors 需要此数据。
Email ID (密钥所有者电子邮件 ID) - 理想情况下，这是在此页上输入详细信息的人员的电子邮件 ID。 SuccessFactors 需要此数据。
密钥密码 (密码) ：输入长度至少为 5 个字符的密码。 这用于加密和解密数据包以及 PGP 密钥。 将来更改此项会导致更改 PGP 密钥。 以后可以通过 EDIT 路径更改通行短语， (请参阅以下)
注意
在步骤 2 中创建 PGP 密钥后，在 SuccessFactors 合作伙伴提取配置中更新属性。 合作伙伴状态设置为禁用，直到下一步成功完成。
合作伙伴 ID ：默认为 MVL
PGP 公钥：在上面生成
密钥所有者：上面共享的名称和电子邮件 ID
配置 SuccessFactors
在此步骤中，管理员需要输入建立连接和访问数据包所需的更多配置。
显示名称和域配置
显示名称：此设置允许管理员自定义Viva Learning中显示的 SAP SuccessFactors 轮播的显示名称。 默认值为“SAP SuccessFactors”
客户端的主机 URL：这是 BizX 域 URL。 可以从 BizX 登录 URL 获取此 URL。
例如，如果 BizX 登录 URL organization.successfactors.com /sf/start/#/login，则主机 URL 为 organization.successfactors.com客户端的学习目标 URL： 它已使用前面步骤 1 中提供的值进行预填充。
公司 ID：这是根据 SuccessFactors 的公司 ID。 登录到 SuccessFactors 门户。 选择配置文件图标，然后选择“显示版本设置”。 可在此处查看公司 ID。
SFTP 配置
SFTP 主机 URL：访问 SFTP 服务器需要此密码。 导航到 SAP SuccessFactors 门户，选择“LMS 管理员应用程序>系统管理>配置>系统配置>连接器”。 获取 属性的值
connector.ftp.server。用户名：这是访问 SFTP 服务器所需的用户名。 此值已预先填充，无需编辑。 此字段从 LMS 管理员 Application System Administration > Configuration System Configuration >> CONNECTORS connector.ftp.userID 属性从 SuccessFactors >> 提取。
密码：这是访问 SFTP 服务器所需的密码。 请与 LMS 应用程序所有者联系以获取有关检索密码的帮助。 在此处输入该密码。
根文件夹路径：这是 SFTP 服务器中的根文件夹，SuccessFactors 在其中保存了为此集成创建的数据提取包。 此值已预填充。
此字段是从 Learning Administration>System Administration>ConfigurationSystem Configuration>>PARTNER_EXTRACT>defaultFtp.path 属性的 SuccessFactors 中提取的。
验证 SFTF 服务器中根文件夹是否存在。 如果文件夹不存在，配置可能会失败
子文件夹路径：这是根文件夹下的子文件夹，SuccessFactors 在其中保存为此集成创建的数据提取包。 默认值为“MVL”。 可以更改或删除此值。 如果此值全部删除，则数据提取包将保存在上面配置的根文件夹中。
验证 SFTF 服务器中根文件夹是否存在。 如果文件夹不存在，配置可能会失败
注意
子文件夹路径仅支持一个级别的文件夹路径。 文件夹不应超过 256 个字符
API 配置
本部分包含上面概述的第一步中输入的值。 所有值都已预先填充，无需重新输入或编辑。
客户端 ID：它已使用前面步骤 1 中提供的值进行预填充
客户端的管理员用户 ID：它预填充了前面步骤 1 中提供的值
管理员客户端密码：它已使用之前提供的值进行预填充。
PGP 配置
PGP 私钥：它使用之前创建的 PGP 私钥进行预填充
PGP 私钥密码：
完成配置
完成上述步骤后，选择“保存”以完成内容同步Microsoft Viva Learning中的 SuccessFactors 配置。
保存配置后，SuccessFactors 提供程序将列在租户的“管理提供程序仪表板屏幕中。 SuccessFactors 在 SFTP 服务器中生成完整的数据提取包。 Viva Learning生成完整的数据提取包后处理包。 同步每天进行两次。 可以在仪表板上查看同步状态和错误日志。
注意
如果从步骤 2 或步骤 3 中退出保存 SuccessFactors 配置，则Viva Learning保存在该步骤前输入的配置值。 可以从中断的位置恢复配置。 例如，如果在步骤 2 - 创建 PGP 密钥中点击取消，Viva Learning将保留步骤 1 中输入的配置。
如果需要删除草稿配置，可以删除 SuccessFactors 提供程序。
已完成 SuccessFactors 集成的客户
如果在此更新之前已配置 SuccessFactors 集成，强烈建议迁移到新的集成。 这样就可以使用客户端 ID、PGP 密钥、密钥所有者和其他必需属性自动更新 SuccessFactors 合作伙伴提取配置，从而与 SuccessFactors 无缝集成。 这有助于自动生成由 SuccessFactors API 驱动的完整数据提取包和无缝集成。
转到Viva Learning中的“管理员”选项卡，然后选择“管理提供程序”。 在配置的 SuccessFactors 提供程序下，你将看到“配置挂起，正在等待所需详细信息”。
在迁移到新的集成过程之前，该消息将一直保留。 如果中间离开进程，则不会保留配置。
选择“更新”
选择“更新”将打开一个一次性屏幕，以提供与 SuccessFactors 无缝集成的 SuccessFactors API 配置。 此集成由 SuccessFactors API 驱动，它要求 SuccessFactors 管理员详细信息具有以下权限： 编辑系统配置 和 查看系统配置
Viva Learning仅访问合作伙伴提取配置 API 和即席包生成 API。
提供以下 SuccessFactors API 配置详细信息：
a. 客户端 ID
b. 客户端的管理员用户
c. 管理员客户端密码
有关从 SAP SuccessFactors 获取所需属性的更多详细信息，请参阅“SAP SuccessFactors 所需的属性”部分。
选择“ 下一步 ”并保存 API 配置
注意
- 还可以通过为 SuccessFactors 提供程序选择“编辑”来提供 API 配置详细信息。
- 续订 PGP 密钥并更新子文件夹路径值时，SuccessFactors 会生成完整的数据提取包。
SAP SuccessFactors 所需的属性
按照表中所述的步骤从 SAP SuccessFactors 获取所需三个属性的值：
| 属性 | 描述 |
|---|---|
| 客户端管理员用户 ID | 此管理员用户需要分配给搜索库和查看库权限的角色才能执行目录服务 API。 无需在 SuccessFactors 中为此管理员用户提供任何其他权限。 |
| 管理员客户端密码 | 管理员客户端密码是相应管理员用户生成的客户端密码。 转到“系统管理员 > 安全 > 管理员”并搜索管理员。 |
| 客户端 ID | 执行 API 需要客户端 ID。 导航到“系统管理 > 配置 > OAuth 令牌服务器”。 |
SAP SuccessFactors 中管理员角色所需的权限
按照以下步骤为角色分配所需的权限，并将该角色分配给 SAP SuccessFactors 中的管理员：
在 中创建由 搜索库 和 查看库 权限组成的角色。
- 若要创建新角色，请导航到“系统管理”“>安全>角色管理>”“创建新角色>”，启用“编辑系统配置”和“查看该角色的系统配置权限”。 或者使用已分配有两个权限的现有角色。
将新角色分配给管理员用户。
- 若要向管理员用户分配角色，请导航到“>系统管理员安全>管理员>”搜索，获取管理员>分配的角色>的>管理员编辑摘要添加创建的角色。
常见问题解答
更新 SuccessFactors 门户合作伙伴配置后，SAP SuccessFactors 需要多长时间才能生成用于同步的完整包？
在 SuccessFactors 门户中完成配置后，SuccessFactors 将生成初始同步包。 这最多可能需要 7 个工作日。 在 SFTP 文件夹路径中提供包后，Viva Learning能够开始与 SuccessFactors 通信。 如果找不到包，请联系 SAP SuccessFactors 支持人员。
为什么在完成 SuccessFactors 门户配置 3 周后，我无法在 SFTP 中看到完全同步包？
SAP SuccessFactors 在自生成日期起 14 天后自动从 SFTP 位置删除完全同步包。 从在 SuccessFactors 门户中提交配置之日起，生成完全同步包需要近 7 天时间
为什么在播放内容时收到订阅错误时，可以在 Viva Learning 应用程序中查看课程？
用户可以在Viva Learning发现他们有权查看的所有租户级别课程。 他们在播放没有有效订阅的第三方课程时收到订阅错误。
如何编辑 successFactors 提供程序配置Viva Learning？
导航到 “管理提供程序>”“SuccessFactors 提供程序”。
SuccessFactors 可用性Viva Learning 检查的频率如何？
Viva Learning从最初在 Viva Learning 中配置 SuccessFactors 开始，每小时检查一次 SuccessFactors 包的可用性。 即将推出的计划槽作为 “管理提供程序>”SuccessFactors 的状态提供。
SuccessFactors 在不同时间生成main包和密钥包。
Viva Learning SuccessFactors 生成这两个文件后，开始处理这些包。 我们观察到这两个包的生成之间最多有三个小时的间隔。
如果两个包一起生成，Viva Learning会在一小时内触发处理。 否则，Viva Learning在两个包可用后的一小时内触发处理。
为什么会看到“配置失败。 解决 SuccessFactors 提供程序的“管理提供程序 ”页上的错误？
之所以看到此消息，是因为之前提供的 SuccessFactors API 配置值 (“客户端 ID”、“客户端管理员用户 ID”和“管理员客户端密码”) 不再有效。 选择“ 解析 ”以提供正确的值。
Viva Learning支持的 SuccessFactors 包的最大大小是多少？
Viva Learning支持载入最大大小为 10 GB 的 SuccessFactors 包， (压缩文件) 。
联系 SAP SuccessFactors 支持人员
错误消息
下表列出了错误代码和消息的显示时间，以及可以采取的后续步骤来解决它们。
| 错误代码 | 说明 | 后续步骤 |
|---|---|---|
| USR_ERROR_SF_INITIAL_PACKAGE_NOT_FOUND | 在 SuccessFactors SFTP 服务器中找不到作为所需包而引入的新内容。 | 确保 SuccessFactors 包可用。 首次同步时，生成此包最多可能需要 7 个工作日。如果找不到包，请联系 SuccessFactors 支持团队。 |
| USR_ERROR_SF_DELTA_PACKAGE_NOT_FOUND | 未引入任何新内容，因为 SuccessFactors SFTP 服务器中找不到所需的包。 | 确保 SF 包在 SF 门户上配置的文件夹路径中可用。 如果找不到包，请联系 SuccessFactors 支持团队。 |
| USR_ERROR_SF_COMPRESSED_PACKAGE_SIZE_EXCEEDED | 由于压缩的包大小超过 2 GB，因此未引入任何新内容。 | 有关更多详细信息，请联系Microsoft客户支持。 |
| USR_ERROR_SF_UNCOMPRESSED_PACKAGE_SIZE_EXCEEDED | 未引入任何新内容，因为未压缩的包大小超过 25 GB。 | 有关更多详细信息，请联系Microsoft客户支持。 |
| PGP 密钥对验证失败 | 此失败的可能原因 - 为字段输入的值不正确 - SF 公钥、SF 私钥、SF 私钥传递短语。 | 导航到 SuccessFactors 提供程序，然后在 “...” 下选择“编辑” 和续订密钥。 复制合作伙伴配置并将其粘贴到 SuccessFactors 门户中。 保存配置。 使用 SuccessFactors 支持团队创建票证以生成新包 |
| USR_ERROR_ACCESS_DENIED、PARTNER_ERROR_UPDATE_PARTNER_EXTRACT_CONFIGURATION_FAILED、PARTNER_ERROR_FETCH_PARTNER_EXTRACT_CONFIGURATION_FAILED、PARTNER_ERROR_UNKNOWN_ERROR、PARTNER_ERROR_GATEWAY_TIMEOUT、PARTNER_ERROR_WEB_SERVER_IS_DOWN、PARTNER_ERROR_UPDATE_PARTNER_EXTRACT_CONFIGURATION_FAILED、PARTNER_ERROR_FETCH_PARTNER_EXTRACT_CONFIGURATION_FAILED | 无法保存所做的更改。 确保以下属性的值正确，然后重试。 或者无法保存更改。 请确保客户端管理员用户 ID、管理员客户端密码 & 客户端 ID 的值有效，然后重试。 或者无法保存更改。 请确保客户端的学习目标 URL、客户端管理员用户 ID 管理员客户端密码 & 客户端 ID 的值在上一步中有效，然后重试。 | 请确保为 SuccessFactors API 配置提供有效的值。 |
| PARTNER_ERROR_INTERNAL_SERVER_ERROR、PARTNER_ERROR_SERVICE_UNAVAILABLE | 由于 SuccessFactors API 出错，无法保存所做的更改。 请稍后重试。 | 有关更多详细信息，请联系Microsoft客户支持。 |
| SYS_ERROR_CLIENT_REQUESTS_LIMIT_EXCEEDED | 已达到 SuccessFactors API 限制。 请稍后重试。 | 有关更多详细信息，请联系Microsoft客户支持。 |
| PARTNER_ERROR_PARTNER_EXTRACT_CONFIGURATION_PARTNER_LIMIT_EXCEEDED | 无法保存所做的更改。 已在 SuccessFactors 合作伙伴提取配置中配置了三个合作伙伴。 确保至少有一个合作伙伴槽可用，然后重试。 | 导航到 SuccessFactors 合作伙伴提取配置 (Learning Administration > System Administration > Configuration > 系统配置>PARTNER_EXTRACT) ，并确保至少有一个合作伙伴槽可用于Viva Learning集成，然后重试。 |
| USR_ERROR_SF_LEARNING_DESTINATION_TENANT_URL_INVALID | 无法保存所做的更改。 确保客户端的学习目标 URL 的值有效，然后重试。 | 请确保为客户端的学习目标 URL 提供有效的值。 |
| 不适用 | 无法保存所做的更改。 稍后再试。 | 有关更多详细信息，请联系Microsoft客户支持。 |
| VLS-SF-CONFIG-ERROR-00001 | PGP 密钥生成失败。 请再试。 | 有关更多详细信息，请联系Microsoft客户支持。 |
| USR_ERROR_PARTNER_EXTRACT_CONFIGURATION_API_SECRETS_TEST_CONNECTION_FAILED | 无法保存所做的更改。 请确保客户端管理员用户 ID、管理员客户端密码和客户端 ID 的值有效，然后重试。 | 请确保为 SuccessFactors API 配置提供有效的值。 |