集成 Workday
与 Workday 集成,以便轻松提交请求、接收有关请求状态的通知以及处理通知。完成此过程后,您的现有审核日志记录级别将持续存在,包括使用 Citrix 微应用执行的任何操作。使用以下过程启用 Workday 集成。有关现成的 Workday 微应用的完整列表,请参阅使用 Workday 微应用。
注意
我们提供两个 Workday 集成模板供您使用。我们建议对大多数用例使用较新的 HTTP 集成,因为它提供了更多的能力来配置缓存的数据结构。Workday(通知)模板是 Workday HTTP 集成的基础。有关每个集成中可用的微应用的完整详细信息,请参阅使用 Workday 微应用。
这些说明描述了如何设置新的 HTTP 模板集成。为了适应休假使用案例,此工作流程涉及设置两个模板: Workday(通知)模板和 Workday(操作)模板,然后配置维修操作参数以允许其彼此通信。如果您需要有关旧模板的信息,请参阅 添加旧式集成。流程的快速概述:
-
在微应用中设置集成之前,请确保满足先决条件,然后完成以下步骤,详细介绍如下:
- 通过注册 API 客户端并生成和收集客户端 ID 和客户端密钥来启用 API 访问。
- 创建自定义报告。
- 生成自定义报告终端节点路径。
- 过滤 PTO 类型以将 PTO 微应用程序限制为特定的休假类型。
- 在 Workspace 中设置深层链接。
- 编辑休假请求的业务流程。
- 管理安全组权限。
- 确定您的 URL、实例 URL 和租户。
- 设置 Workday(通知)集成。有关详细信息,请参阅将 Workday 通知集成添加到 Citrix Workspace 微应用。
- 设置 Workday(操作)集成。有关详细信息,请参阅将 Workday 操作集成添加到 Citrix Workspace 微应用。
- 配置维修操作参数。有关详细信息,请参阅配置维修操作参数。
如果您需要帮助,请查看我们的 解决常见的 Workday 集成错误 文章。
检查必备项
此设置过程要求您具有管理员帐户和 Workday 连接器的以下服务帐户权限。
- 访问非临时自定义报告的创建。
- 访问人力资源、集成、性能管理、资源管理和自定义报告 API。
- 要下载里程碑数据,这是深层链接设置过程的一部分,您需要分配给管理员的以下安全组:
- HR 管理员
- 信息管理员
- 将 Citrix Gateway 配置为支持 Workday 的单点登录,以便在用户登录后,他们将自动重新登录,而无需再次输入凭据。请按照 Workday 单点登录配置 中的说明进行操作。有关配置 SSO 的详细信息,请参阅Citrix Gateway 服务。
在 Workday 中设置此集成后,当您在 微应用中设置集成时,您需要这些工件来输入这些帐户凭据:
- URL
- 用户名
- 租户
- 密码
- 客户端 ID
- 客户端密钥
- Workday REST API 端点
- 令牌端点
- 授权端点
- 收集的自定义报告 URL
注册 Workday API 客户端
注册 API 客户端以为每个环境生成客户端 ID 和客户端密钥。如果您有多个环境,则必须为每个单独的环境注册一个 API 客户端。对于 Workday 集成,您必须添加两个不同的回调 URL。这意味着您需要注册两个 API 客户端;一个用于用户操作,另一个用于同步。执行此过程两次。一次用于服务身份验证,然后用于服务操作身份验证。它们有不同的回调 URL。对于旧版集成模板,仅执行第二个操作来注册客户端。
配置 OAuth 服务器
将 OAuth 服务器配置为通过集成读取数据。配置集成时,您将这些详细信息用于服务身份验证。此操作仅针对 HTTP 集成执行。
-
以管理员身份登录到 Workday,并搜索注册 API 客户端。填写必填字段:
- 输入您的客户名称。
- 为客户端授予类型选择授权代码授予。
- 为访问令牌类型选择持有者。
- 输入 重定向 URI:
https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
。回调取决于目标应用程序,并且可以在创建集成时在 URL 地址栏中找到。该部分{yourmicroappserverurl}
由租户部分、区域部分和环境部分组成:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com
。 - 为刷新令牌超时(以天为单位)输入值 300。
- 选择以下范围(功能区域):
- 组织和角色
- 人员配置
- 租户不可配置
- 选择“确定”。将生成客户端 ID 和客户端密钥。收集并保存以备日后在设置过程中使用。配置集成时,您将这些详细信息用于服务身份验证。
- 选择“完成”以完成并退出。
配置 OAuth 客户端
配置 OAuth 客户端以通过集成写回数据。配置集成时,您将这些详细信息用于服务操作身份验证。
-
以管理员身份登录到 Workday,并搜索注册 API 客户端。填写必填字段:
- 输入您的客户名称。
- 为客户端授予类型选择授权代码授予。
- 为访问令牌类型选择持有者。
- 输入 重定向 URI:
https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
。回调取决于目标应用程序,并且可以在创建集成时在 URL 地址栏中找到。该部分{yourmicroappserverurl}
由租户部分、区域部分和环境部分组成:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com
。 - 为刷新令牌超时(以天为单位)输入值 300。
- 选择以下范围(功能区域):
- 组织和角色
- 人员配置
- 租户不可配置
- 选择“确定”。将生成客户端 ID 和客户端密钥。收集并保存以备日后在设置过程中使用。配置集成时,您将这些详细信息用于服务操作身份验证。
- 选择“完成”以完成并退出。
测试 API 调用
本文列出了所有 Workday API 调用,并提供了有关如何测试您的 Workday 实例是否已准备好所有终端节点进行这些调用的详细描述。有关详细信息,请参阅测试 Workday API 调用。
创建自定义报告
您在 Workday 中为以下每个报表创建自定义报表。下载附加的电子表格,并按照电子表格中的描述完全填写详细信息。如果您输入的任何详细信息与提供的报告不同,则该过程将不起作用。例如,如果您使用的名称不正确,则会生成报告,但不会下载任何数据。
以下报告是当前的报告。当我们在此集成中添加新的端点时,它们将在产品文档中添加到此处。
-
打开以下自定义报表电子表格之一:
-
- 计算字段:cf esi event records awaiting action
- 计算字段:cf esi assigned to worker of event records of awaiting action
- 计算字段:cf lrv assigned to worker email of event records awaiting action
- 计算字段:cf lrv assigned to worker event records of awaiting action
- 计算字段:cf lrv wid of assigned to worker email of event records awaiting action
- 计算字段:cf lrv wid of event record awaiting action
-
注:
不要将自引用对象添加到每个计划的休息时间类型报表。
- 在 Workday 中,搜索创建自定义报告。
- 输入报告名称。此名称必须与要为其创建 URL 的报表的电子表格相同。
- 选择高级作为报告类型。
- 输入数据源。此值必须与要为其创建 URL 的报表的电子表格相同。
- 不要选中“针对性能进行优化”复选框。
- 不要选中“临时报告”复选框。
- 选中启用为 Web 服务复选框。
-
选择“确定”。
自定义报告将打开,但您输入的三个字段除外。
- 完全按照电子表格中的描述完全填写详细信息。注意标题。标题与 Workday UI 中的选项卡匹配。
- 在填充列时,字段标题覆盖 XML 别名会自动生成。验证列标题覆盖 XML 别名中的值是否与电子表格说明匹配。此值通常会有所不同。
- 选择“确定”。此时将创建自定义报告。
生成自定义报告终结点路径
您可以使用上一过程中生成的 WSDL 来收集自定义报告路径。当您在设置过程中为 每个计划报告路径和里程 碑路径的事件记录输入休假类型的自定义报告 URL 时,请使用此选项。
- 在浏览器中打开生成的 WSDL 链接。
- 滚动到底部并找到两个 URL。第二个名称为 ReportREST。这是我们想要使用的。
- 从此 URL 复制路径,并在设置 Workday 集成时使用它。(示例路径:</ccx/service/customreport2/company_tenant/user_name/report_name>。
筛选 PTO 类型
将 PTO 微应用限制为特定的休假类型,例如假期或病假。如果您在 Workday 中创建了以下自定义报表,则需要在 Workday 中创建计算字段,并使用以下过程筛选自定义报表。
- 休假申请的事件记录
- Absence requests
- All time offs and balance
为休假请求微应用创建计算字段
您需要创建两个计算字段。第一个计算字段旨在从“休假事件”中检索“缺勤类型”,以便在第二个计算字段中可用。第二个计算字段用作自定义报告中的筛选器。
- 登录到您的 Workday 实例并搜索创建计算字段。
- 填写所有字段:
- 字段名称 输入计算字段的名称。例如,以下格式的 SANDOVAL CF LKP 缺勤类型 :{(报表创建者)(CF= 计算字段)(LKP = 查找相关值)(此字段返回的值)}。
- 业务对象 查找并选择休假事件。我们希望我们的计算字段成为此业务对象的一部分。
- 函数 查找并选择查找相关值。
- 选择左下角的“确定”。
- 在计算选项卡下,填写以下字段:
- 查找字段 查找并选择休假事件。
- 返回值 查找并选择休假事件的休假类型
- 依次选择确定和完成。
您创建了一个计算字段。现在,让我们创建第二个字段,该字段检索 Time Off 事件并将用作过滤器。
- 同样,从您的 Workday 实例中搜索创建计算字段。
- 填写所有字段:
- 字段名称 输入计算字段的名称。例如,对于 业务流程的 SANDOVAL CF LKP 休假事件 来自以下格式:{(报表创建者)(CF= 计算字段)(LKP = 查找相关值)(此字段返回的值)}。
- 业务对象 查找并选择操作事件。我们希望我们的计算字段成为此业务对象的一部分。
- 函数 查找并选择查找相关值。
- 选择左下角的“确定”。
- 在计算选项卡下,填写以下字段:
- 查找字段 查找并选择休假事件。
- 返回值 查找并选择您创建的第一个计算字段。在我们的例子中, 桑多瓦 CF LKP 缺勤类型。
- 依次选择确定和完成。
使用“休假请求”微应用程序的计算字段过滤自定义报告
使用刚刚创建的新计算字段将筛选器添加到与休假批准相关的自定义报告,该字段将 PTO 类型列入白名单,这将允许您获取所选择的所有休假类型。
- 从您的 Workday 实例中搜索“编辑自定义报告”,然后选择与 PTO 批准相关的自定义报告,在我们的示例中为休假申请的事件记录。
- 选择过滤器选项卡和 + 以添加新过滤器。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择您创建的第二个计算字段,在我们的示例 SANDOVAL CF LKP 业务流程休假事件中。
- 运算符 在 选择列表中查找并选择任何一个。
- 比较类型 查找并选择在此过滤器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 年假(天数)
- 年假(法定)
- 个人假期(天数)
- 生病(天数)
- 休假
- 选择“确定”进行保存。
注:
要阻止 PTO 类型,请将字段: * 运算符 更改 为不选择列表。这会阻止集成获取任何选定的 PTO 类型。
使用“创建 PTO 请求”和“我的 PTO 请求”微应用的现有字段筛选自定义报告
筛选自定义报告: 所有时间休息和余额。
注意:
我们建议在所有自定义报告中使用相同的 PTO 类型。这样,如果您决定将结果列入白名单或阻止结果,则对于所有自定义报告,“比较值”中的值都是相同的)。
- 从您的 Workday 实例搜索“编辑自定义报告”,然 后选择与休假批准相关的自定义报告,在我们的示例中,“所有休假和余额”。
- 选择过滤器选项卡和 + 以添加新过滤器。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择自定义报告“休假时间类型”。
- 运算符 在选择列表 中查找并选择。
- 比较类型 查找并选择在此过滤器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 年假(天数)
- 年假(法定)
- 个人假期(天数)
- 生病(天数)
- 休假
- 选择“确定”进行保存。
筛选自定义报表: 缺勤请求。
- 从您的 Workday 实例搜索“编辑自定义报告”,然后选择与休假批准相关的自定义报告(在我们的例子中)。
- 选择子过滤器选项卡,然后选择 + 以添加新的子过滤器,类似于添加过滤器的方式。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择 休假录入的自定义报告休假时间类型。
- 运算符 在选择列表 中查找并选择。
- 比较类型 查找并选择在此过滤器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 带薪休假(天数)
- 生病(天数)
- 生病(小时)
- 选择“确定”进行保存。
在 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/2997$4819.htmld
-
批准/拒绝变更职位(变更职位请求)
https://your_domain/your_tenant/d/unifiedinbox/initialinbox/2998$17139.htmld
注意:
如果您没有存储此数据,请登录到您的 Workday 帐户并从 URL 复制这些数据。每次新添加的集成都必须设置这些深层链接。
编辑休假请求的业务流程
根据您正在使用的 Workday 租户,您已建立用于创建休假申请的业务流程。修改该业务流程,如以下步骤所示。
- 在 Workday 中,搜索 bp: 申请休假,然后选择 Global Modern Services 的申请休假。
- 转到操作 > 业务流程 > 编辑定义。
- 除非需要,否则不要更改生效日期,然后选择确定。
- 在业务流程步骤下,选择 + 图标以添加新行。
- 为订单输入 b。
- 输入类型批准。
- 从菜单中为组选择管理员。
- 选择确定,然后选择完成。
管理安全组权限
要为您的安全组启用适当的安全权限,请完成两个过程。首先向组添加权限并激活设置。然后添加安全组以查看所有列表并激活设置。
添加和激活集成权限
- 在 Workday 中,搜索查看安全组。
- 搜索所需的安全组,选择它,然后选择确定。
- 转到操作 > 安全组 > 维护安全权限。
-
在集成权限部分下,在允许获取访问权限的域安全策略字段中搜索以下权限列表,并将它们全部添加。不要在搜索中使用冒号 (:):
- 管理:组织集成
- 工作人员数据:公共工作者报告
- 设置:支出类别
- 工作人员数据:人数报表
- 业务流程管理
- 业务流程报告
- 设置:费用项
- 流程:采购订单 — 查看
- 流程:费用报表 — 查看
- 工作人员数据:在职员工
- 员工数据:当前人员配置信息
- 员工数据:休假(休假余额)
- 员工数据:休假(休假)
- 员工数据:休假
- 报告:时间跟踪
- 选择确定,查看,然后选择完成。
- 搜索激活挂起的安全策略更改。
- 在注释字段中,键入激活,然后选择确定。
- 选中确认复选框,然后选择确定。 权限已更新并激活。
添加并激活安全组以查看所有列表
- 搜索 bp: 变更职位并选择全球现代服务的变更职位。
-
转到操作 > 业务流程 > 编辑。
- 滚动至查看全部部分。将您的安全组添加到可以查看所有安全组的列表中。
- 选择确定,然后选择完成。
- 搜索激活挂起的安全策略更改。
- 在注释字段中,键入激活,然后选择确定。
- 选中确认复选框,然后选择确定。 权限已更新并激活。
您可以通过搜索查看安全组并选择安全组来查看安全组。现在有两个选项卡,即域安全策略权限和业务流程安全策略权限。
查找您的基本 URL
您需要输入 Workday 环境的基本 URL(域)才能启用 API 调用。格式为 https://{domain}.workday.com
。例如,如果 Workday REST API 端点为 https://wd2-impl-services1.workday.com/ccx/api/v1/citrix_gms
,则您的基本 URL 为 wd2-impl-services1
。请按照以下步骤标识您的基本 URL。
- 以管理员身份登录到 Workday 并搜索查看 API 客户端。
- 查看第一个名为 Workday REST API 端点的字段。格式为
https://{domain}.workday.com/ccx/api/v1/{tenant}
。
将 Workday 通知集成添加到 Citrix Workspace 微应用
将 Workday(通知)集成添加到 Citrix Workspace 微应用程序以连接到应用程序。这样可以提供现成的微应用,以及可以在 Workspace 内使用的预配置通知和操作。
请按照以下步骤设置 Workday HTTP 集成。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。我们建议在大多数用例中使用此更新的 HTTP 集成。HTTP 集成提供了更多功能来配置缓存的数据结构。
请按照以下步骤进行操作:
- 在微应用集成页面中,选择添加新集成,然后选择从 Citrix 提供的模板添加新集成。
- 选择 Workday(通知)磁贴。
- 输入集成的集成名称。
- 输入连接器参数。
- 输入实例 基本 URL。这是您的 Workday 环境的域,例如
wd2-impl-services1
。有关识别基本 URL 的更多信息,请参阅 查找您的基本 URL。 - 从 图标 库中选择集成的图标,或将其保留为默认 Workday 图标。
- 如果要创建本地连接,请启用本地实例开关。有关详细信息,请参阅本地实例。
- 输入实例 基本 URL。这是您的 Workday 环境的域,例如
-
在服务身份验证下,从身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。
- 从授权类型菜单中选择授权代码。这将授予客户端交换访问令牌的临时代码。代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有此授权类型才能启用安全用户模拟。这将显示您在注册应用程序时使用的 回调 URL
- 从令牌授权菜单中选择授权标头。
- 输入您的 授权 URL。这是格式:
{instance_url}/{tenant}/authorize
。这是设置目标应用程序集成时提供的授权服务器 URL。有关识别基本 URL 和租户的更多信息,请参阅 查找您的基本 URL。 - 输入您的 令牌 URL。这是格式:
{base_url}.workday.com/ccx/oauth2/{tenant}/token
。这是访问授权令牌的 URL。 - 输入您的客户端 ID。客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。您可以通过在您的 Google 帐户中注册 OAuth 客户端来收集这些信息和秘密信息。您需要添加集成配置页面上看到的回调 URL 。
-
输入您的客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
- 如果选择了 OAuth 2.0 身份验证方法,则可以选择 + 添加参数以包含访问令牌参数。访问令牌参数根据目标应用程序授权服务器的要求定义访问令牌参数(如有必要)。
-
在服务操作身份验证下,启用在操作中使用单独用户身份验证开关。服务操作身份验证在服务操作级别进行身份验证。
- 从“身份验证方法”菜单中选择“OAuth 2.0”,然后完成身份验证详细信息。
- 从授权类型菜单中选择授权代码。这将授予客户端交换访问令牌的临时代码。代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有此授权类型才能启用安全用户模拟。这将显示您在注册应用程序时使用的回调 URL
- 从令牌授权菜单中选择授权标头。
- 输入您的 授权 URL。这是格式:
{instance_url}/{tenant}/authorize
。这是设置目标应用程序集成时提供的授权服务器 URL。有关识别基本 URL 和租户的更多信息,请参阅 查找您的基本 URL。 - 输入您的 令牌 URL。这是格式:
{base_url}.workday.com/ccx/oauth2/{tenant}/token
。这是访问授权令牌的 URL。 - 输入您的客户端 ID。客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。您可以通过在您的 Google 帐户中注册 OAuth 客户端来收集这些信息和秘密信息。您需要添加集成配置页面上看到的回调 URL 。
- 输入您的客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
- (可选)如果要激活此集成的速率限制,请启用请求速率限制开关并设置每个时间间隔的请求数。
-
(可选)启用日志记录开关以保留 24 小时的日志记录以供支持。
- 选择 保存 以继续。
- 在 OAuth 授权下,选择 授权 以使用您的服务帐户登录。此时将出现一个弹出窗口,其中包含 Workday 登录屏
- 输入您的服务帐户用户名和密码,然后选择“登录”。
- 选择“接受”。
将 Workday 操作集成添加到 Citrix Workspace 微应用
将 Workday(操作)集成添加到 Citrix Workspace 微应用程序以请求休假。此集成中的微应用程序“创建 PTO 请求”仅存在于允许将集成添加到微应用服务中。您可以忽略微应用程序。来自 Workday(通知)集成模板的创建休假请求 OOTB 微应用(您在之前的过程中添加的模板)使用此集成来启用 PTO 请求服务操作。
请按照以下步骤进行操作:
- 在微应用集成页面中,选择添加新集成,然后选择从 Citrix 提供的模板添加新集成。
-
选择 Workday(操作)磁贴。
- 输入集成的集成名称。
- 输入连接器参数。
- 输入实例基本 URL。这是您的 Workday 环境的域,例如
wd2-impl-services1
。有关识别基本 URL 的更多信息,请参阅 查找您的基本 URL。 - 输入 租户。有关识别租户的详细信息,请参阅 查找您的基本 URL。
- 输入您的服务帐 户用户名 和 密码。
- 输入实例基本 URL。这是您的 Workday 环境的域,例如
- 选择添加。
配置维修操作参数
设置上述两个集成模板后,需要正确配置服务操作。
请按照以下步骤进行操作:
- 在微应用集成页面中,导航到“Workday(通知)”集成,然后选择创建休假请求微应用。
- 选择 页面,然后选择请 求关闭时间 页。
- 在页面生成器中,选择提交按钮元素,然后在右窗格中选择操作。
- 选择“添加操作”,然后从菜单中选择“运行维修操作”。
- 选择“运行服务操作”。在数据下选择 Workday(操作)。
-
在操作下,选择提交休假时间,然后选择编辑参数。
空面板打开,看起来像这样:
-
根据以下屏幕截图完成 维修操作参数 :
- 选择“保存”。
替换数据加载和维修操作变量
要完成此设置,您需要将 Workday(通知)集成配置中的 {tenant}
和 {user}
变量替换为租户和用于身份验证的用户凭据。
- 在微应用集成页面中,选择“Workday(通知)”集成旁边的菜单,然后选择编辑。此时将打开“数据加载”屏幕。如果没有,请从左侧导航列中选择“数据加载”。
-
对于每个数据终端节点,您必须手动添加以下内容的详细信息:
{tenant}/{user}
。你这样做六次选择端点和 编辑旁边的菜单。 - 在“编 辑数据终端节点”屏幕的“PATH”选项卡下,将 租 户和 用户 添加到空字段中。
-
选择“应用”并确认。对其他五个数据端点重复此操作。
-
对于每个维修操作,您必须手动添加以下内容的详细信息:
{tenant}
。你这样做两次编辑集成时,从左侧导航列中选择“服务操作”。选择其中一个服务操作和 编辑旁边的菜单。 -
在“编 辑服务操 作”屏幕中的“操作执行”和“PATH”选项卡下,将 租户 值 (citrix_gms2) 替换为租户。
- 您需要 在执行操作后删除并重新创建数据更新。在操作后更新数据 标签旁边,选择 删除 图标以删除此部分。
- 选择 + 添加数据更新。
- 从“数据终端节点”菜单中选择 休假请求 。
- 选择查询选项卡,然后选择 + 添加参数。
-
为 参数名 输入 完成日期开始或之后。从“选 择参数”菜单中,选择 时间戳。
- 选择“保存”以完成。对于其他维修操作,重复此操作。
现在,您可以设置和运行第一个数据同步。由于可以将大量数据从集成应用程序提取到 微应用平台,因此我们建议您使用表页面筛选第一次数据同步的实体,以加快同步速度。有关详细信息,请参阅验证所需实体。有关同步规则、不符合其计划的同步以及否决规则的完整信息,请参阅 同步数据。
有关 API 端点和表实体的更多详细信息,请参阅Workday HTTP 连接器规格。
使用 Workday 微应用
我们的 Workday HTTP 集成模板附带以下预先配置的开箱即用微应用程序。
更改作业: 查看和审批更改任务请求。
通知或页面 | 用例工作流 |
---|---|
新的变更职位请求批准通知 | 当提交新的变更任务审批请求时,审批人会收到通知。 |
“变更职位批准”页 | 提供可操作的表单,其中包含更改作业请求的详细视图。 |
“变更职位以供审批”页 | 提供批准者等待批准的更改作业请求的只读视图。 |
创建变更职位: 创建变更职位请求。
通知或页面 | 用例工作流 |
---|---|
“创建变更职位”页 | 提供用于创建变更职位的页面。必须在 Workday 中为 Citrix Workspace 微应用设置深层链接。 |
创建费用报表: 创建支出报表。
通知或页面 | 用例工作流 |
---|---|
“创建费用报表”页 | 提供用于创建支出报表的窗体。必须在 Workday 中为 Citrix Workspace 微应用设置深层链接。 |
创建休假请求: 提交付费休假 (PTO) 请求。
通知或页面 | 用例工作流 |
---|---|
请求休息时间页面 | 提供用于创建付费休假 (PTO) 请求的表单,包括选择类型、开始日期和结束日期以及可选的添加注释。 |
我的休假请求: 查看休假请求的个性化列表。
通知或页面 | 用例工作流 |
---|---|
休假请求状态已更新通知 | 当 PTO 请求的状态发生更改时,PTO 请求的所有者将收到通知。 |
“我的时间休息”页 | 提供用户活动休假请求的只读视图,包括提交时间及其状态。 |
休息详情页面 | 提供用户的所有休假申请的详细视图。 |
休假请求: 查看和审批已付休假 (PTO) 请求。
通知或页面 | 用例工作流 |
---|---|
待审批的新休假通知 | 当提交新的休假审批请求时,审批人会收到通知。 |
“休假申请审批”页面 | 提供一个具有休假请求详细视图的可操作表单。 |
“待审批的休假申请”页面 | 提供批准者等待批准的休假请求的只读视图。 |
添加旧式集成
按照以下说明设置旧式集成。
创建自定义报告
您在 Workday 中为以下每个报表创建自定义报表。下载附加的电子表格,并按照电子表格中的描述完全填写详细信息。如果您输入的任何详细信息与提供的报告不同,则该过程将不起作用。例如,如果您使用的名称不正确,则会生成报告,但不会下载任何数据。
以下报告是旧报告。当我们在此集成中添加新的端点时,它们将在产品文档中添加到此处。
-
打开以下自定义报表电子表格之一:
-
按照上述流程进行操作。
生成自定义报告 URL
要下载数据并为自定义报告生成通知,您必须生成自定义报告 URL 并下载 WSDL。您需要这些 URL 来完成 微应用设置过程。
- 在 Workday 中,打开您创建的自定义报表。
- 选择操作并选择报表的名称以打开设置。
- 选择操作 > Web 服务 > 查看 URL >“WSDL”。
- 在输入时间字段中输入任何日期。
- 右键单击“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 类型
将 PTO 微应用限制为特定的休假类型,例如假期或病假。如果您在 Workday 中创建了以下自定义报表,则需要在 Workday 中创建计算字段,并使用以下过程筛选自定义报表。
- 休假申请的事件记录
- Time off request details
- Time off types per plan
为 PTO 请求微应用创建计算字段
您需要创建两个计算字段。第一个计算字段旨在从“休假事件”中检索“缺勤类型”,以便在第二个计算字段中可用。第二个计算字段用作自定义报告中的筛选器。
- 登录到您的 Workday 实例并搜索创建计算字段。
- 填写所有字段:
- 字段名称 输入计算字段的名称。例如,以下格式的 SANDOVAL CF LRV Absence Type :{(报表创建者)(CF= 计算字段)(LRV= 查找相关值)(此字段返回的值)}。
- 业务对象 查找并选择休假事件。我们希望我们的计算字段成为此业务对象的一部分。
- 函数 查找并选择查找相关值。
- 选择左下角的“确定”。
- 在计算选项卡下,填写以下字段:
- 查找字段 查找并选择休假事件。
- 返回值 查找并选择休假事件的休假类型
- 依次选择确定和完成。
您创建了一个计算字段。现在,让我们创建第二个字段,该字段检索 Time Off 事件并将用作过滤器。
- 同样,从您的 Workday 实例中搜索创建计算字段。
- 填写所有字段:
- 字段名称 输入计算字段的名称。例如,对于 SANDOVAL CF LRV Time Off Event for Business Process ,采用以下格式:{(报表创建者)(CF= 计算字段)(LRV= 查找相关值)(此字段返回的值)}。
- 业务对象 查找并选择操作事件。我们希望我们的计算字段成为此业务对象的一部分。
- 函数 查找并选择查找相关值。
- 选择左下角的“确定”。
- 在计算选项卡下,填写以下字段:
- 查找字段 查找并选择休假事件。
- 返回值 查找并选择您创建的第一个计算字段。在我们的示例中为 SANDOVAL CF LRV Absence Type。
- 依次选择确定和完成。
使用 PTO 请求微应用的计算字段过滤自定义报告
使用刚刚创建的新计算字段将过滤器添加到与 PTO 批准相关的自定义报告中,该字段将允许您获取选择的所有 PTO 类型。
- 从您的 Workday 实例中搜索“编辑自定义报告”,然后选择与 PTO 批准相关的自定义报告,在我们的示例中为休假申请的事件记录。
- 选择过滤器选项卡和 + 以添加新过滤器。
- 填写以下字段:
- 和/或 和
- 字段 在 业务流程的示例 SANDOVAL CF LRV 休假事件中查找并选择您创建的第二个计算字段。
- 运算符 在 选择列表中查找并选择任何一个。
- 比较类型 查找并选择在此过滤器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 年假(天数)
- 年假(法定)
- 个人假期(天数)
- 生病(天数)
- 休假
- 选择“确定”进行保存。
注:
要阻止 PTO 类型,请将字段: * 运算符 更改 为不选择列表。这会阻止集成获取任何选定的 PTO 类型。
使用“创建 PTO 请求”和“我的 PTO 请求”微应用的现有字段筛选自定义报告
筛选每个计划自定义报告的休假类型。
注意:
我们建议在所有自定义报告中使用相同的 PTO 类型。这样,如果您决定将结果列入白名单或阻止结果,则对于所有自定义报告,“比较值”中的值都是相同的)。
- 从您的 Workday 实例搜索“编辑自定义报告”,然后选择与 PTO 批准相关的自定义报告,在我们的例子中, 每个计划的休假类型。
- 选择过滤器选项卡和 + 以添加新过滤器。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择自定义报告“休假时间类型”。
- 运算符 在选择列表 中查找并选择。
- 比较类型 查找并选择在此过滤器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 年假(天数)
- 年假(法定)
- 个人假期(天数)
- 生病(天数)
- 休假
- 选择“确定”进行保存。
过滤器休假请求详细信息自定义报告。
- 从您的 Workday 实例中搜索编辑自定义报告,然后选择与 PTO 审批相关的自定义报告,在我们的示例中为休假申请详细信息。
- 选择子过滤器选项卡,然后选择 + 以添加新的子过滤器,类似于添加过滤器的方式。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择 休假录入的自定义报告休假时间类型。
- 运算符 在选择列表 中查找并选择。
- 比较类型 查找并选择在此过滤器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 带薪休假(天数)
- 生病(天数)
- 生病(小时)
- 选择“确定”进行保存。
在 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 复制这些数据。每次新添加的集成都必须设置这些深层链接。
添加到 Citrix Workspace 微应用程序的集成
按照以下说明设置旧版 Workday 集成。
请按照以下步骤进行操作:
-
从概览页面中,选择开始。
此时将打开“管理集成”页面。
- 选择添加新集成,然后选择从 Citrix 提供的模板中添加新集成。
- 选择 Workday 磁贴。
- 输入集成名称。
- 输入作为必备条件收集的连接器参数。
- 输入您的 URL 以启用 API 调用。这是您的 Workday 环境的域,例如
wd2-impl-services1
。有关识别基本 URL 的更多信息,请参阅 查找您的基本 URL。 - 输入实例 URL 的 Workday 实例。通过登录到 Workday 环境并复制实例 URL 来查找您的实例域。例如
https://impl.workday.com
。 - 输入您的 Workday 租户位置。在 查找您的基本 URL 中查找标识 Workday 租户的示例。
- 输入在必备条件过程中收集的客户端 ID 和客户端密钥。
- 输入您的用户名和密码。
- 输入要加载的天数以设置加载数据时的天数限制。
- 输入您的 URL 以启用 API 调用。这是您的 Workday 环境的域,例如
-
切换启用时间关闭模块? 设置到是,如果您创建 Workday 计算的休假申请,并且希望下载数据并根据数据生成通知。您在过程中收集了这些 URL 生成自定义报告 URL 和路径 生成自定义报告路径。
- 输入休假申请详细信息报告 URL 的自定义报告 URL。
- 为 每个计划报告路径输入休假类型的自定义报告路径。
- 为休假申请报告 URL 的事件记录输入自定义报告 URL。
-
切换启用变更职位模块? 设置到是,如果您创建 Workday 计算的变更职位,并且希望下载数据并根据数据生成通知。您在生成自定义报告 URL过程中收集了这些 URL。
- 为变更职位报告 URL 的事件记录输入自定义报告 URL。
- 为人员配置活动报告 URL 输入自定义报告 URL。
-
切换启用费用模块? 设置到是,如果您创建 Workday 计算的费用报告,并且希望下载数据并根据数据生成通知。您在生成自定义报告 URL过程中收集了这些 URL。
- 为支出报告 URL 的事件记录输入自定义报告 URL。
-
切换启用采购订单模块? 设置到是,如果您创建 Workday 计算的采购订单,并且希望下载数据并根据数据生成通知。这使用公共 API,并且确实需要自定义报告。
-
如果您创建里程碑项目,并希望根据数据下载数据并生成通知,请切换下载里程碑项项目? 设置到是。您在过程中收集了这些路径 生成自定义报告路径。
- 输入 里程碑路径的事件记录的自定义报告路径。
- 选择添加。
微应用集成页面将打开,其中包含您添加的集成及其微应用。在这里,您可以添加另一个集成,继续设置现成的微应用,或者为此集成创建一个新的微应用。
传统 Workday 微应用
我们传统的 Workday 集成模板附带以下预配置的开箱即用微应用程序:
更改任务请求: 查看和审批更改任务请求。
通知或页面 | 用例工作流 |
---|---|
新的变更职位请求批准通知 | 当提交新的变更任务审批请求时,审批人会收到通知。 |
“变更职位批准”页 | 提供可操作的表单,其中包含更改作业请求的详细视图。 |
“变更职位以供审批”页 | 提供批准者等待批准的更改作业请求的只读视图。 |
创建变更职位: 创建变更职位请求。
通知或页面 | 用例工作流 |
---|---|
“创建变更职位”页 | 提供用于创建变更职位的页面。必须在 Workday 中为 Citrix Workspace 微应用设置深层链接。 |
创建费用报表: 创建支出报表。
通知或页面 | 用例工作流 |
---|---|
“创建费用报表”页 | 提供用于创建支出报表的窗体。必须在 Workday 中为 Citrix Workspace 微应用设置深层链接。 |
创建里程碑: 创建里程碑。
通知或页面 | 用例工作流 |
---|---|
“创建里程碑”页 | 提供用于创建里程碑的表单。必须在 Workday 中为 Citrix Workspace 微应用设置深层链接。 |
创建 PTO 请求: 提交付费休假 (PTO) 请求。
通知或页面 | 用例工作流 |
---|---|
“请求 PTO”页 | 提供用于创建付费休假 (PTO) 请求的表单,包括选择类型、开始日期和结束日期以及可选的添加注释。 |
费用报表: 查看和审批费用报表。
通知或页面 | 用例工作流 |
---|---|
要审批的新费用报表通知 | 当提交新的费用审批请求时,审批人会收到通知。 |
“费用报表审批”页 | 提供一个具有支出报表详细视图的可操作表单。 |
“用于审批的费用报表”页 | 提供等待审批的审批人费用报表请求的只读视图。 |
里程碑: 查看里程碑详细信息并接收里程碑更新。
通知或页面 | 用例工作流 |
---|---|
里程碑状态更新通知 | 当里程碑更新时,里程碑分配给的工作人员会收到通知。 |
里程碑详细信息 | 提供用户所有里程碑的详细视图。 |
里程碑 | 提供用户里程碑的可搜索列表。 |
我的支出: 查看个性化的支出报表列表,其中包含报表详细信息和个人支出项的详细信息。
通知或页面 | 用例工作流 |
---|---|
费用状态更新通知 | 当费用状态发生变化时,费用的所有者将收到通知。 |
“费用报表详细信息”页 | 提供用户所有费用的详细视图。 |
“费用报表行详细信息”页 | 提供对用户之一支出的深入视图。 |
“我的费用”页面 | 提供用户支出的只读视图。 |
我的 PTO 请求: 查看休假申请的个性化列表。
通知或页面 | 用例工作流 |
---|---|
PTO 请求状态已更新通知 | 当 PTO 请求的状态发生更改时,PTO 请求的所有者将收到通知。 |
“我的 PTO 请求”页面 | 提供用户活动休假请求的只读视图,包括提交时间及其状态。 |
PTO 请求详细信息页 | 提供用户的所有休假申请的详细视图。 |
采购订单: 查看具有采购订单详细信息的采购订单。
通知或页面 | 用例工作流 |
---|---|
“我的采购订单”页 | 提供用户活动采购订单的只读视图。 |
“采购订单详情”页 | 提供用户所有采购订单的详细视图。 |
PTO 余额: 查看剩余休假天数的个性化列表。
通知或页面 | 用例工作流 |
---|---|
PTO 余额页 | 提供用户剩余休假天数的只读视图。 |
PTO 请求: 查看和审批已付休假 (PTO) 请求。
通知或页面 | 用例工作流 |
---|---|
待审批的新休假通知 | 当提交新的休假审批请求时,审批人会收到通知。 |
“休假申请审批”页面 | 提供一个具有休假请求详细视图的可操作表单。 |
“待审批的休假申请”页面 | 提供批准者等待批准的休假请求的只读视图。 |