整合 SAP SuccessFactors

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

注意:

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

有关现成的 SuccessFactors 微应用的完整列表,请参阅使用 SuccessFactors 微应用

检查必备项

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

  • 与 SAP SuccessFactors 连接所需的配置信息取决于您是否使用“学习”模块。
  • 在 Provisioning 实例中创建管理员用户。通常情况下,SuccessFactors Certified Consultant 执行 Provisioning 中的所有活动。为用户指定一个可辨别的名称。
  • 将 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(用户名)
  • 客户端 ID(API 密钥)
  • 客户端私钥(加密私钥)

对于 SuccessFactors 学习集成:

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

设置 SuccessFactors HCM 集成

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

创建权限角色

若要创建权限角色,请按照下列步骤操作:

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

创建权限组

若要创建权限组,请按照下列步骤操作:

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

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

若要将新权限组分配给权限角色,请按照下列步骤操作:

  1. 在 SAP SuccessFactors Admin Center 中,搜索并选择管理权限角色,然后选择之前创建的权限角色。
  2. 向下滚动以授予此角色… 并选择添加…
  3. 在将此角色授予:权限组…,单击选择…
  4. 搜索之前创建的组,选中名称旁边的复选框,然后选择完成
  5. 再次选择完成,然后选择保存更改

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

注册 OAuth2 客户端

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

  1. 在 SAP SuccessFactors Admin Center 中,搜索并选择管理 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. 输入连接器参数
    • 输入实例 基本 URLhttps://{tenant}.successfactors.{region}/odata/v2
    • 图标 库中选择集成的图标,或将其保留为默认图标。
  5. 服务身份验证下,从身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。

    1. 授权类型流程 菜单中选择 SAML 2.0 成功因素
    2. 范围 留空。
    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 eCategation 附带以下预配置的开箱即用微应用程序:

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

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

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

通知或页面 用例工作流
技能评级已更改通知 当经理更改员工技能评级时,员工会收到通知。
“技能” 页 提供可搜索的技能列表以连接到用户。
“用户评分技能” 页 提供评级技能的详细视图。评级技能是员工及其经理在 “技能配置文件” Portlet 中评分的技能。
用户自我报告技能页面 提供自我报告技能的详细视图。自我报告的技能是手动添加到技能配置文件 Portlet 中。
“用户”页 提供用户技能集的视图。

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

将 SuccessFactors 集成添加到 Citrix Workspace 微应用以连接到您的应用程序。这样可以提供现成的微应用,以及可以在 Workspace 内使用的预配置通知和操作。

使用以下过程启用 SuccessFactors 集成。确保满足必备条件,并决定需要设置哪些集成:

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

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

  1. 从概览页面中,选择开始

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

  2. 选择添加新集成,然后选择从 Citrix 提供的模板中添加新集成
  3. 选择 SuccessFactors 磁贴。
  4. 输入集成的名称。

    SuccessFactors 连接器参数,现有员工模块,学习模块,API URL,公司 ID,用户 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