集成 Workday

与 Workday 集成，可轻松提交请求、接收有关请求状态的通知以及对通知采取行动。

与 Workday 集成，可轻松提交请求、接收有关请求状态的通知以及对通知采取行动。完成此过程后，您的现有审核日志记录级别将持续存在，包括使用 Citrix 微应用执行的任何操作。使用以下过程启用 Workday 集成。

有关现成的 Workday 微应用的完整列表，请参阅使用 Workday 微应用。

在 微应用中设置集成之前，请确保满足必备条件，然后：

• 通过注册 API 客户端并生成和收集客户端 ID 和客户端密钥来启用 API 访问。
• 创建自定义报告。
• 生成自定义报告 URL。
• 在 Workspace 中设置深层链接。
• 编辑超时请求的业务流程。
• 管理安全组权限。

检查必备项

此设置过程要求您具有管理员帐户和 Workday 连接器的以下服务帐户权限。

• 访问创建非临时自定义报告。
• 访问人力资源、集成、绩效管理、资源管理和自定义报告 API。
• 下载里程碑数据是深层链接设置过程的一部分，您需要为管理员分配以下安全组：
  • 人力资源管理员
  • 信息管理员
• 将 Citrix Gateway 配置为支持 Workday 的单点登录，以便用户登录后再次自动登录，而无需再次输入凭据。请按照 Workday 单点登录配置 中的说明进行操作。有关配置 SSO 的详细信息，请参阅Citrix Gateway 服务。

在 Workday 中设置此集成后，当您在 微应用中设置集成时，您需要这些工件来输入这些帐户凭据：

• URL
• 用户名
• 租户
• 密码
• 客户端 ID
• 客户端密钥
• Workday REST API 端点
• 令牌端点
• 授权端点
• 收集的自定义报告 URL

注册 Workday API 客户端

注册 API 客户端以为每个环境生成客户端 ID 和客户端密钥。如果您有多个环境，则必须为每个环境注册一个 API 客户端。

1. 以管理员身份登录到 Workday，并搜索注册 API 客户端。填写必填字段：

   • 输入您的客户名称。
   • 为客户端授予类型选择授权代码授予。
   • 为访问令牌类型选择持有者。
   • 输入重定向 URI：https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
   • 为刷新令牌超时（以天为单位）输入值 300。
   • 选择以下范围（功能区域）：
     • 组织和角色
     • 人员配置
     • 租户不可配置

2. 选择 OK（确定）。生成客户端 ID 和客户端密码。收集并保存以供以后在设置过程中使用。

3. 选择“完成”以完成并退出。

创建自定义报告

您在 Workday 中为以下每个报表创建自定义报表。下载附加的电子表格，完全按照电子表格中的说明完成详细信息。如果您输入的任何详细信息与提供的报告不同，则此流程无法正常工作。例如，如果您使用的名称不正确，则会生成报告，但不会下载任何数据。

1. 打开以下自定义报告电子表格之一：

   • 休假申请详细信息
   • 每个计划的休假类型
   • 休假申请的事件记录
   • 变更职位的事件记录
   • 费用事件记录
   • 里程碑的事件记录

   • 人员配置活动

     注意：

     以前的报告是目前的报告。当我们在集成中添加新的端点时，它们会在产品文档中添加到此处。

2. 在 Workday 中，搜索创建自定义报告。
3. 输入报告名称。此名称必须与要为其创建 URL 的报表的电子表格相同。
4. 选择高级作为报告类型。
5. 输入数据源。此值必须与要为其创建 URL 的报表的电子表格相同。
6. 选中启用为 Web 服务复选框。

7. 选择 OK（确定）。

   除了您输入的三个字段外，自定义报告将打开未填充。

8. 完全按照电子表格中的描述填写详细信息。注意标题。标题与 Workday UI 中的选项卡匹配。
9. 在填充列时，字段标题覆盖 XML 别名会自动生成。验证列标题覆盖 XML 别名中的值是否与电子表格说明匹配。此值通常会有所不同。
10. 选择 OK（确定）。自定义报告即被创建。

生成自定义报告 URL

要下载数据并为自定义报告生成通知，必须生成自定义报告 URL 并下载 WSDL。您需要这些 URL 来完成 微应用设置过程。

1. 在 Workday 中，打开您创建的自定义报表。
2. 选择操作并选择报表的名称以打开设置。
3. 选择操作 > Web 服务 > 查看 URL >“WSDL”。
4. 在输入时间字段中输入任何日期。
5. 右键单击“Workday XML”部分下的 WSDL 链接，然后选择复制 URL。（示例 URL：https://wd2-impl-services1.workday.com/ccx/service/customreport2/company_tenant/user_name/report_name?wsdl）

在“将集成添加到 Citrix Workspace 微应用”过程中设置微应用时，保存 URL 以供使用。

过滤 PTO 类型

如果您在 Workday 中创建了以下自定义报告，则需要在 Worday 中创建计算字段，并使用以下过程筛选自定义报告。

• 休假请求的事件记录
• 休假申请详细信息
• 每个计划的休假类型

为 PTO 请求微应用创建计算字段

您需要创建两个计算字段。第二个字段用于筛选数据。

1. 登录到您的 Workday 实例并搜索创建计算字段。
2. 填写所有字段：
   • 字段名 输入计算字段的名称。我们使用以下格式命名我们的报告 SANDOVAL CF LRV 缺勤类型：{(报告创建者)(CF=计算字段)(LRV=查找相关值)(此字段返回的值)}。
   • 业务对象 查找并选择休假事件。我们希望我们的计算字段成为此业务对象的一部分。
   • 函数 查找并选择 查找相关值。
3. 选择左下角的“确定”。
4. 在计算选项卡下，填写以下字段：
   • 查找字段 查找并选择休假事件。
   • 返回值 查找并选择休假事件的休假类型
5. 依次选择确定和完成。

您创建了一个计算字段。现在，让我们创建用于筛选数据的第二个字段。

1. 同样，从您的 Workday 实例中搜索创建计算字段。
2. 填写所有字段：
   • 字段名 输入计算字段的名称。我们用以下格式命名我们的报告业务流程的 SANDOVAL CF LRV 休假事件：{(报告创建者)(CF=计算字段)(LRV=查找相关值)(此字段返回的值)}。
   • 业务对象 查找并选择操作事件。我们希望我们的计算字段成为此业务对象的一部分。
   • 函数 查找并选择查找相关值。
3. 选择左下角的“确定”。
4. 在计算选项卡下，填写以下字段：
   • 查找字段 查找并选择休假事件。
   • 返回值 查找并选择您创建的第一个计算字段。在我们的示例中为 SANDOVAL CF LRV 缺勤类型。
5. 依次选择确定和完成。

使用 PTO 请求微应用的计算字段过滤自定义报告

使用刚刚创建的新计算字段将过滤器添加到与 PTO 批准相关的自定义报告中，该字段将允许您获取选择的所有 PTO 类型。

1. 从您的 Workday 实例中搜索“编辑自定义报告”，然后选择与 PTO 批准相关的自定义报告，在我们的示例中为休假请求的事件记录。
2. 选择过滤器选项卡和 + 以添加新过滤器。
3. 填写以下字段：
   • 和/或 和
   • *字段 查找并选择您创建的第二个计算字段，在我们的示例中为业务流程的 SANDOVAL CF LRV 休假事件。
   • *运算符 查找并选择选择列表中的任何对象。
   • 比较类型 查找并选择在此过滤器中指定的值。
   • 比较值 查找并选择要将其列入白名单的 PTO 类型，例如：
     • 年假（天数）
     • 年假（法定）
     • 个人假期（天数）
     • 生病（天数）
     • 休假
4. 选择“确定”进行保存。

注意：

要将 PTO 类型列入黑名单，请将字段 *运算符更改为任何选择列表。这会阻止集成获取任何选定的 PTO 类型。

使用“创建 PTO 请求”和“我的 PTO 请求”微应用的现有字段筛选自定义报告

注意：

我们建议在所有自定义报告中使用相同的 PTO 类型。这样，如果您决定将结果列入白名单或将其列入黑名单，则所有自定义报告的“比较值”中的值都是相同的）。

筛选每个计划自定义报告的休假类型。

1. 从您的 Workday 实例中搜索“编辑自定义报告”，然后选择与 PTO 批准相关的自定义报告，在我们的示例中为休假请求的事件记录。
2. 选择过滤器选项卡和 + 以添加新过滤器。
3. 填写以下字段：
   • 和/或 和
   • *字段 查找并选择自定义报告休假类型。
   • *运算符 查找并选择在选择列表中。
   • 比较类型 查找并选择在此过滤器中指定的值。
   • 比较值 查找并选择要将其列入白名单的 PTO 类型，例如：
     • 年假（天数）
     • 年假（法定）
     • 个人假期（天数）
     • 生病（天数）
     • 休假
4. 选择“确定”进行保存。

过滤器休假请求详细信息自定义报告。

1. 从您的 Workday 实例中搜索编辑自定义报告，然后选择与 PTO 审批相关的自定义报告，在我们的示例中为休假申请详细信息。
2. 选择子过滤器选项卡，然后选择 + 以添加新的子过滤器，类似于添加过滤器的方式。
3. 填写以下字段：
   • 和/或 和
   • *字段 查找并选择自定义报告休假条目对应的休假类型。
   • *运算符 查找并选择在选择列表中。
   • 比较类型 查找并选择在此过滤器中指定的值。
   • 比较值 查找并选择要将其列入白名单的 PTO 类型，例如：
     • 带薪休假（天数）
     • 生病（天数）
     • 生病（小时）
4. 选择“确定”进行保存。

在 Workspace 中设置深层链接

如果您被介绍到本文，请联系您的管理员并请求他们在 Workday 中为 Citrix Workspace 微应用设置深度链接。

以下用例需要相应的深层链接。例如，如果您的域为 impl.workday.com 且您的租户为 citrix_gms2v，则创建支出报表的 URL 为 https://impl.workday.com/citrix_gms2/d/task/2997$995.htmld：

• 创建支出报告 https://your_domain/your_tenant/d/task/2997$995.htmld

• 创建里程碑 https://your_domain/your_tenant/d/task/2998$8704.htmld

• 创建更改任务 https://your_domain/your_tenant/d/task/2997$4819.htmld

• 批准/拒绝变更职位（变更职位请求） https://your_domain/your_tenant/d/unifiedinbox/initialinbox/2998$17139.htmld

注意：

如果您没有存储此数据，请登录到您的 Workday 帐户并从 URL 中复制它们。这些深层链接必须通过每个新增的集成建立起来。

编辑超时请求的业务流程

根据您正在使用的 Workday 租户，您已建立用于创建休假申请的业务流程。修改该业务流程，如以下步骤所示。

1. 在 Workday 中，搜索 bp: 申请休假，然后选择 Global Modern Services 的申请休假。
2. 转到操作 > 业务流程 > 编辑定义。
3. 除非需要，否则不要更改生效日期，然后选择确定。
4. 在业务流程步骤下，选择 + 图标以添加新行。
5. 为订单输入 b。
6. 输入类型批准。
7. 从菜单中为组选择管理员。
8. 选择确定，然后选择完成。

管理安全组权限

要为您的安全组启用适当的安全权限，请完成两个过程。首先向组添加权限并激活设置。然后添加安全组以查看所有列表并激活设置。

添加和激活集成权限

1. 在 Workday 中，搜索查看安全组。
2. 搜索所需的安全组，选择它，然后选择确定。
3. 转到操作 > 安全组 > 维护安全权限。

4. 在集成权限部分下，在允许获取访问权限的域安全策略字段中搜索以下权限列表，并将它们全部添加。不要在搜索中使用冒号 (:)：

   

   • 管理：组织集成
   • 工作人员数据：公共工作人员报告
   • 设置：支出类别
   • 员工数据：人数报表
   • 业务流程管理
   • 业务流程报告
   • 设置：费用项
   • 流程：采购订单 — 查看
   • 流程：费用报表 — 查看
   • 员工数据：活跃员工
   • 员工数据：当前人员配置信息
   • 员工数据：休假（休假余额）
   • 员工数据：休假（休假）
   • 员工数据：休假
5. 选择确定，查看，然后选择完成。
6. 搜索激活挂起的安全策略更改。
7. 在注释字段中，键入激活，然后选择确定。
8. 选中确认复选框，然后选择确定。 权限已更新并激活。

添加并激活安全组以查看所有列表

1. 搜索 bp: 变更职位并选择全球现代服务的变更职位。

2. 转到操作 > 业务流程 > 编辑。

   

3. 滚动至查看全部部分。将您的安全组添加到可以查看全部的安全组列表中。
4. 选择确定，然后选择完成。
5. 搜索激活挂起的安全策略更改。
6. 在注释字段中，键入激活，然后选择确定。
7. 选中确认复选框，然后选择确定。 权限已更新并激活。

您可以通过搜索查看安全组并选择安全组来查看安全组。现在有两个选项卡，即域安全策略权限和业务流程安全策略权限。

将集成添加到 Citrix Workspace 微应用

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

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

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

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

2. 选择添加新集成，然后选择从 Citrix 提供的模板中添加新集成。
3. 选择 Workday 磁贴。
4. 输入集成名称。
5. 输入作为必备条件收集的连接器参数。
   • 输入您的实例 URL。
   • 为实例 URL 输入工作日实例的域。
   • 输入您的 Workday 租户位置。
   • 输入在必备条件过程中收集的客户端 ID 和客户端密钥。
   • 输入您的用户名和密码。
   • 输入要加载的天数以设置加载数据时的天数限制。

6. 切换启用时间关闭模块? 设置到是，如果您创建 Workday 计算的休假申请，并且希望下载数据并根据数据生成通知。您在获取自定义报告 URL过程中收集了这些 URL。

   • 输入休假申请详细信息报告 URL 的自定义报告 URL。
   • 输入每个计划报告路径的休假类型输入自定义报告 URL。
   • 为休假申请报告 URL 的事件记录输入自定义报告 URL。

7. 切换启用变更职位模块? 设置到是，如果您创建 Workday 计算的变更职位，并且希望下载数据并根据数据生成通知。您在获取自定义报告 URL过程中收集了这些 URL。

   • 为变更职位报告 URL 的事件记录输入自定义报告 URL。
   • 为人员配置活动报告 URL 输入自定义报告 URL。

8. 切换启用费用模块? 设置到是，如果您创建 Workday 计算的费用报告，并且希望下载数据并根据数据生成通知。您在获取自定义报告 URL过程中收集了这些 URL。

   • 为支出报告 URL 的事件记录输入自定义报告 URL。

9. 切换启用采购订单模块? 设置到是，如果您创建 Workday 计算的采购订单，并且希望下载数据并根据数据生成通知。这使用公共 API，并且需要自定义报告。

10. 如果您创建里程碑项目，并希望根据数据下载数据并生成通知，请切换下载里程碑项项目? 设置到是。您在获取自定义报告 URL过程中收集了这些 URL。

    • 为里程碑 URL 的事件记录输入自定义报告 URL。
11. 选择添加。

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

现在，您可以设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到 微应用平台，因此我们建议您使用表页面筛选第一次数据同步的实体，以加快同步速度。

有关详细信息，请参阅“配置集成”文章中的验证所需的实体和设置数据同步。

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

使用 Workday 微应用

现有的应用程序集成带有现成的微应用。从这些微应用开始，并根据您的需求定制它们。我们的 Workday 集成带有以下预配置的现成微应用：

更改任务请求： 查看和批准更改任务请求。

创建变更职位： 创建变更职位请求。

创建费用报表： 创建费用报表。

创建里程碑： 创建里程碑。

创建 PTO 请求： 提交付薪休假 (PTO) 请求。

费用报表： 查看和审批费用报表。

里程碑： 查看里程碑详细信息并接收里程碑更新。

我的费用： 查看包含单个费用项的报表详细信息和详细信息的个性化支出报表列表。

我的 PTO 请求： 查看休假申请的个性化列表。

采购订单： 查看具有采购订单详细信息的采购订单。

PTO 余额： 查看剩余休假天数的个性化列表。

PTO 请求： 查看和批准付薪休假 (PTO) 请求。