产品文档
微应用
查看 PDF

集成 SAP SuccessFactors

December 1, 2021
贡献者: 
C

与 SAP SuccessFactors 集成，随时随地访问员工、技能和课程信息。

注意：

我们提供了两个 SuccessFactors 集成模板供您使用。我们建议对 SAP SuccessFactors 员工平台用例使用较新的 SuccessFactors EC HTTP 集成。HTTP 集成提供了更多功能来配置缓存的数据结构。

有关开箱即用的 SuccessFactors 微应用的完整列表，请参阅 使用 SuccessFactors 微应用。

查看必备项

在 SAP SuccessFactors 中设置此集成后，根据需要启用的集成类型，您需要这些工件才能在 Citrix Workspace 微应用中添加集成。完成此过程后，您现有的审核日志记录级别将保留，包括使用 Citrix Microapps 执行的任何操作。

  • 连接 SAP SuccessFactors 所需的配置信息取决于你是否使用学习模块。
  • 在预配实例中创建管理员用户。通常，SuccessFactors 认证顾问会执行预配中的所有活动。为用户指定一个可区分的名字。
  • 将 Citrix Gateway 配置为支持 SuccessFactors 的单点登录，这样一旦用户登录，他们将自动重新登录，而无需再次输入凭据。有关配置 SSO 的更多信息，请参阅 Citrix Gateway 服务。

注意：

对于 SuccessFactors 集成，速率限制适用于每分钟的请求数。这可能会影响测试实例。为避免出现问题，请将速率限制设置为每秒 8 次呼叫。有关更多信息，请咨询您的 SuccessFactors 顾问以找出正确的最大请求速率值。

对于 SuccessFactors EC 集成：

  • 基本 URL：您的基本 URL 遵循此模型： https://{tenant}.successfactors.{region}/odata/v2
  • 用户名：您的唯一用户 ID。
  • 客户端 ID：客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。请参阅 收集您的公司 ID 和客户 ID。
  • 公司 ID：公司 ID 是一个短字符串，用于标识每个 SAP SuccessFactors 系统，例如组织的用户名。请参阅 收集您的公司 ID 和客户 ID。
  • 私钥：这是注册 OAuth2 客户端时的 API 密钥。请参阅 注册 OAuth2 客户端。
  • OAuth URL：这是模板中生成的应用程序 URL，遵循以下模型： https://{tenant}.successfactors.{region}/oauth。你需要这个来 注册 OAuth2 客户端。

对于 SuccessFactors HCM 集成：

  • API URL
  • 公司编号
  • 用户 ID（用户名）
  • 客户端 ID（API 密钥）
  • 客户端私钥（加密私钥）

对于 SuccessFactors 学习集成：

  • 学习 URL
  • 学习型公司 ID
  • 学习用户 ID
  • 学习客户端 ID
  • 学习客户端秘密

设置 SuccessFactors HCM 集成

如果您需要设置基本的 SuccessFactors HCM 集成或与学习模块的基本集成，请按照此过程进行操作。使用管理员用户，您可以创建权限角色、创建权限组并将权限组分配给权限角色。

创建权限角色

要创建权限角色，请执行以下步骤：

  1. 使用管理员用户登录 SAP SuccessFactors 管理中心。
  2. 搜索并选择 “ 管理权限角色”，然后选择 “ 新建”。
  3. 输入有意义的 角色名称 ，然后选择 权限…。
  4. 滚动到 “ 管理集成工具”，单击 “全选”，然后选择 “ 完成”。
  5. 选择 保存更改。

创建权限组

要创建权限组，请执行以下步骤：

  1. 在 SAP SuccessFactors 管理中心中，搜索并选择 “ 管理权限组”，然后选择 “ 新建”。
  2. 输入有意义的 组名。
  3. 在 “ 选择组成员：人员池” 下，选择类别 用户名。
  4. 输入专用用户的用户名，选中名称旁边的复选框，然后选择 完成。
  5. 再次选择 “ 完成 ”。

将新权限组分配给权限角色

要将新权限组分配给权限角色，请执行以下步骤：

  1. 在 SAP SuccessFactors 管理中心中，搜索并选择 “ 管理权限角色”，然后选择之前创建的权限角色。
  2. 向下滚动以将 此角色授予… 然后选择 添加…。
  3. 在 “将 此角色授予以下权限组…” 下，单击 选择…。
  4. 搜索先前创建的组，选中名称旁边的复选框，然后选择 完成。

  5. 再次选择 完成 ，然后选择 保存更改。

    您已将用户权限组分配给权限角色。

注册 OAuth2 客户端

要注册 OAuth2 客户端，请按照下列步骤操作：

  1. 在 SAP SuccessFactors 管理中心中，搜索并选择 管理 OAuth2 客户端应用程序，然后选择 注册客户端应用程序。

  2. 输入以下详细信息：

    应用程序名称

    应用程序 URL

  3. 选择 生成 X.509 证书。
  4. 输入公 用名称 (CN)，然后选择 生成。
  5. 选择 下 载以下载 X.509 证书的副本。客户端私钥作为 加密私钥位于证书文件中。复制并保存此密钥。您可以在配置集成时使用这些详细信息。

  6. 选择注册。

    新应用程序列在 “管理 Oauth2 客户端应用程序” 页面上。

  7. 在 操作下，选择 查看。
  8. 复制 API 密钥 并将其存储以供以后使用。

设置 SuccessFactors 学习集成

如果您需要设置基本的 SuccessFactors 与学习模块集成或仅设置学习模块的集成，请按照此过程进行操作。使用管理员用户，您可以收集公司 ID 和客户端 ID，然后生成新的客户端密钥。

收集你的公司 ID 和客户 ID

要收集您的公司 ID 和客户 ID，请按照下列步骤操作：

  1. 为租户登录 SAP SuccessFactors 学习管理环境。
  2. 导航到 系统管理员 > 配置 > OAuth 令牌服务器。
  3. 在 “ 应用程序管理 ” 屏幕上，复制 公司 ID 和 客户端 ID 并将其存储以供以后使用。

生成新的客户端密钥

要生成新的客户端密钥，请执行以下步骤：

  1. 在 “ 应用程序管理 ” 屏幕上，选择 “ 生成新的客户端密钥 ”， 然后选择 “确定”

    新生成的客户端密钥 填充在客户端 ID 下方。

  2. 复制客户端密钥并将其存储以供以后使用。

    秘密没有存储。当您离开 OAuth 令牌服务器页面时，密钥将消失。

添加回调 URL

向实例配置添加自定义 URL，以授予对私有数据的访问权限并启用经 OAuth 身份验证的用户操作。列出的第一个回调不会改变。第二个回调取决于目标应用程序，创建集成时可以在 URL 地址栏中找到。{yourmicroappserverurl} 部分由租户部分、区域部分和环境部分组成： https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com。

以管理员身份登录 SuccessFactors，然后为此集成添加以下授权重定向 URL：

  • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.successfactors.SuccessFactorsService/auth/serverContext
  • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

添加 SuccessFactors EC 集成

请按照以下步骤设置 SuccessFactors EC 集成。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。对于大多数用例，我们建议使用这种较新的 HTTP 集成。HTTP 集成提供了更多功能来配置缓存的数据结构。

请按照以下步骤进行操作：

  1. 在 微应用集成 页面中，选择 添加新集成，然后 从 Citrix 提供的模板中添加新集成。
  2. 选择 集成下的 SuccessFactors EC 磁贴。
  3. 输入 集成的集成名称 。
  4. 输入 连接器参数。
    • 输入实例 基本 URL： https://{tenant}.successfactors.{region}/odata/v2
    • 从 图标 库中选择用于集成的图标，或将其保留为默认图标。

  5. 在 服务身份验证下，从身份验证 方法 菜单中选择 OAuth 2.0 ，然后填写身份验证详细信息。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。

    1. 从 授权类型流程 菜单中选择 SAML 2.0 成功因素 。
    2. 将 S cope 留空。
    3. 输入您的用户名。
    4. 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。请参阅 收集您的公司 ID 和客户 ID。
    5. 输入您的 公司 ID。公司 ID 是一个短字符串，用于标识每个 SAP SuccessFactors 系统，例如组织的用户名。请参阅 收集您的公司 ID 和客户 ID。
    6. 输入您的 私钥。这是通过注册 OAuth2 客户端获得的 API 密钥。请参阅 注册 OAuth2 客户端。
    7. 系统会自动生成您的 OAuth URL 。这是模板中生成的应用程序 URL，遵循以下模型： https://{tenant}.successfactors.{region}/oauth。你需要这个来 注册 OAuth2 客户端。
  6. 禁用服务操作身份验证。
  7. 启用请求速率限制 开关已启用。 请求数 保留 1， **时间间隔 为 1 秒。 1。。默认情况下，请求超时 设置为 120 。
  8. （可选）启用 日志记录 切换以保留 24 小时的日志记录以用于支持目的。
  9. 选择 保存 以继续。

现在，您已准备好设置和运行第一次数据同步。有关同步规则、不符合其计划的同步和否决规则的完整信息，请参阅同步数据。

使用 SuccessFactors EC 微应用

现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始，然后根据您的需求自定义它们。我们的 SuccessFactors ec集成配置了以下预配置的开箱即用微应用：

目录：搜索员工并预览他们的详细信息，包括技能组合。

通知或页面 用例工作流
用户页 提供可搜索的用户列表。
“用户技能” 页 提供用户详细信息及其技能组合的视图。

技能：搜索技能并预览具有相应技能集的员工。

通知或页面 用例工作流
技能等级已更改通知 当经理更改员工的技能评级时，该员工会收到通知。
技能页面 提供与用户建立联系的可搜索技能列表。
“用户评级技能” 页 提供额定技能的详细视图。评级技能是员工及其经理在 “技能配置文件” portlet 中评分的技能。
用户自我报告的技能页面 提供自我报告技能的详细视图。自我报告的技能将手动添加到 “技能配置文件” portlet 中。
“用户”页 提供用户技能集的视图。

将 SuccessFactors 集成添加到 Citrix Workspace 微应用

将 SuccessFactors 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。这样可以提供带有预配置通知和操作的开箱即用的微应用程序，这些通知和操作可在工作区中使用

使用以下过程启用 SuccessFactors 集成。确保满足先决条件，并决定需要设置哪种集成：

  • 基本的 SuccessFactors HCM 集成，
  • 与学习模块的基本集成，
  • 只是学习模块。

请按照以下步骤进行操作：

  1. 在概述页面中，选择 入门。

    此时将打开 “管理集成” 页面。

  2. 选择 添加新集成，然后 从 Citrix 提供的模板中添加新集成。
  3. 选择 SuccessFactors 磁贴。

  4. 输入集成的名称。

    SuccessFactors 连接器参数、现有员工模块、学习模块、API URL、公司 ID、用户 ID、客户端 ID、客户端私钥以及学习模块的所有内容都相同

  5. 输入作为先决条件收集的 连接器参数 。
    • 从 您是否在使用员工中心模块中选择是/否？
      • 输入 API URL。例如，https://api12preview.sapsf.eu/odata/v2v。
      • 输入 公司 ID。
      • 输入 用户 ID。
      • 输入 客户端 ID。
      • 输入 客户端私钥。
    • 从 你在使用学习模块吗？中选择是/否
      • 输入 学习 URL。
      • 输入 学习型公司 ID。
      • 输入 学习用户 ID。
      • 输入 学习客户端 ID。
      • 输入 学习客户端密钥。
  6. 选择添加。

微应用集成 页面随即打开，其中包含您添加的集成及其微应用。在这里，您可以添加另一个集成，继续设置开箱即用的微应用，或为此集成创建新的微应用。

现在，您已准备好设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到微应用平台，因此我们建议您使用 “ 表 ” 页面筛选实体以进行首次数据同步，以加快同步速度。有关更多信息，请参阅验证所需实体。有关同步规则、不符合其计划的同步和否决规则的完整信息，请参阅同步数据。

有关 API 端点和表实体的更多详细信息，请参阅 SuccessFactors 连接器规范。

使用 SuccessFactors 微应用

现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始，然后根据您的需求自定义它们。

我们的 SuccessFactors 集成带有以下预配置的开箱即用微应用：

目录： 搜索、查看和编辑具有相应详细信息的员工。

通知或页面 用例工作流
新队友通知 当新队友加入时，所有订阅者都会收到一条通知，突出显示新队友及其位置。
职位变更通知 当员工的头衔发生变化时，所有订阅者都会收到一条通知，突出显示队友及其新职位。
我的详情页 提供用于查看个人详细信息的表单，并提供指向经理子详细信息的链接。
我的团队页面 提供员工队友的表格视图以及指向用户详细信息的链接。
用户详细信息页 提供用于查看用户详细信息的表单，并提供指向其经理和任何直接下属子详细信息的链接。
用户子详细信息页 提供用于查看用户子详细信息的表单，并提供指向其详细信息的链接。
“用户”页 提供具有搜索功能的用户表格视图以及指向用户详细信息的链接。

学习： 搜索、查看、共享和注册可用的学习课程。

通知或页面 用例工作流
热门课程通知 当根据评级将学习课程定义为热门课程时，所有订阅者都会收到通知。
课程页面 提供可用课程的列表，其中包含指向学习项目详细信息的链接。
学习项目详情页 提供学习项目的表格视图，其中包含指向计划课程详细信息的链接以及通过电子邮件共享的选项。
计划提供详情页面 提供计划课程的详细视图，其中包含教师列表和注册选项。
集成 SAP SuccessFactors
December 1, 2021
贡献者: 
C
December 1, 2021
贡献者: 
C

本文中包含的内容

站点反馈 | 隐私和法律条款 | Cookie 首选项 | Consent settings
© 1999- Citrix Systems, Inc. All rights reserved.