集成 Workday
与 Workday 集成以便轻松提交请求、接收有关请求状态的通知以及处理通知。完成此过程后,您现有的审核日志记录级别将保留,包括使用 Citrix Microapps 执行的任何操作。使用以下过程启用 Workday 集成。有关开箱即用的 Workday 微应用的完整列表,请参阅 使用 Workday 微应用。
注意
我们提供了两个 Workday 集成模板供您使用。我们建议在大多数用例中使用较新的 HTTP 集成,因为它提供了更多的功能来配置缓存的数据结构。有关每个集成中可用的微应用的完整详细信息,请参阅 使用 Workday 微应用。
这些说明描述了如何设置新的 HTTP 模板集成。如果您需要有关旧版模板的信息,请参阅 添加旧版集成。该过程的快速概述:
-
在微应用中设置集成之前,请确保满足先决条件,然后完成下面详细介绍的以下过程:
- 通过注册 API 客户端并生成和收集客户端 ID 和客户端密钥来启用 API 访问。
- 创建自定义报告。
- 生成自定义报告端点路径。
- 筛选 PTO 类型以将 PTO 微应用限制为特定的休假类型。
- 在工作区中设置深度链接。
- 编辑休假请求的业务流程。
- 管理安全组权限。
- 识别您的 URL、实例 URL 和租户。
- 设置 Workday 集成。有关更多信息,请参阅 将 Workday 集成添加到 Citrix Workspace 微应用。
- 配置维修操作参数。有关详细信息,请参阅 替换数据加载和维修操作变量。
如果您需要帮助,请查看我们的 常见 Workday 集成错误疑难解答 文章。
查看必备项
此设置过程要求您拥有 Workday 连接器的管理员帐户和以下服务帐户权限。
- 访问创建非临时自定义报告。
- 访问人力资源、集成、绩效管理、资源管理和自定义报告 API。
- 要下载里程碑数据(深度链接设置过程的一部分),您需要为管理员分配以下安全组:
- HR 管理员
- 信息管理员
- 将 Citrix Gateway 配置为支持 Workday 的单点登录,这样一旦用户登录,他们将自动重新登录,而无需再次输入凭据。按照 Workday 单点登录配置中的说明进行操作。有关配置 SSO 的更多信息,请参阅 Citrix Gateway 服务。
在 Workday 中设置此集成后,在微应用中设置集成时,需要以下工件来输入这些帐户凭据:
- URL
- 用户名(Workday 用户名)
- 密码(Workday 密码)
- Workday 租户
- 客户端 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 (以天为单位)。
- 选择以下 范围(功能区域):
- 组织和角色
- 人员
- 租户不可配置
- 选择 OK(确定)。将生成客户端 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 (以天为单位)。
- 选择以下 范围(功能区域):
- 组织和角色
- 人员
- 租户不可配置
- 选择 OK(确定)。将生成客户端 ID 和客户端密钥。收集并保存以备以后在设置过程中使用。配置集成时,可以将这些详细信息用于服务操作身份验证。
- 选择 完成 以完成并退出。
测试 API 调用
本文列出了所有 Workday API 调用,并详细介绍了如何测试 Workday 实例是否已准备好进行这些调用的所有终端节点。有关更多信息,请参阅测试 Workday API 调用。
创建自定义报告
您可以在 Workday 中为以下每个报表创建自定义报告。下载随附的电子表格,并按照电子表格中的说明准确填写详细信息。如果您输入的任何详细信息与提供的报告不同,则该流程将不起作用。例如,如果您使用的名称不正确,则会生成报告,但不会下载任何数据。
以下报告是当前的报告。当我们向此集成添加新端点时,它们会在产品文档中添加到此处。
-
打开以下自定义报告电子表格之一:
-
注意:请
勿将自引用对象添加到每个计划的休假类型报告中。
- 在 Workday 中,搜索 创建自定义报告。
- 输入 报告名称。此名称必须与要为其创建 URL 的报表的电子表格相同。
- 选择 高级 作为 报告类型。
- 输入 数据源。此值必须与要为其创建 URL 的报表的电子表格相同。
- 不要选中针对性能 进行优化 复选框。
- 不要选中 临时报告 复选框。
- 选中 启用作为 Web 服务 复选框。
-
选择 OK(确定)。
除了您输入的三个字段外,自定义报告打开时不填充。
- 完全按照电子表格中的描述填写详细信息。注意标题。标题与 Workday UI 中的选项卡匹配。
- 填充列时,系统会自动生成 “列标题覆盖 XML 别名 ” 字段。验证 “列标题覆盖 XML 别名” 中的值是否与电子表格说明相匹配。此值通常会有所不同。
- 选择 OK(确定)。自定义报告已创建完毕。
生成自定义报告端点路径
您可以使用上一过程中生成的 WSDL 来收集自定义报告路径。在设置过程中为 每个计划报告路径的休假类型和里程碑路径的事件记录输入自定义报告 URL 时,请使用此选 项。
- 在浏览器中打开生成的 WSDL 链接。
- 滚动到底部并找到两个 URL。第二个名字叫做 ReportREST。这是我们想要使用的那个。
- 从此 URL 复制路径并在设置 Workday 集成时使用它。(示例路径:</ccx/service/customreport2/company_tenant/user_name/report_name>。
筛选 PTO 类型
将 PTO 微应用限制为特定的休假类型,例如休假或病假。如果您在 Workday 中创建了以下自定义报表,则需要在 Workday 中创建计算字段,并使用以下过程筛选自定义报告。
- 休假请求的事件记录
- 缺勤请求
- 所有的休假和平衡
为休假请求微应用创建计算字段
您需要创建两个计算字段。第一个计算字段旨在从休假事件中检索缺勤类型,以便在第二个计算字段中可用。第二个计算字段用作自定义报告中的筛选器。
- 登录到您的 Workday 实例并搜索 创建计算字段。
- 填写所有字段:
- 字段名称 输入计算字段的名称。例如,以下格式的 SANDOVAL CF LKP 缺勤类型 :{(报告创建者)(cf= 计算字段)(LKP = 查找相关值)(此字段返回的值)}。
- 业务对象 查找并选择 休假事件。我们希望我们的计算字段成为此业务对象的一部分。
- 函数 查找并选择 查找相关值。
- 选择左下角的 “ 确定 ”。
- 在 “计 算 ” 选项卡下,填写以下字段:
- 查找字段查 找并选择 休假事件。
- 返回值 查找并选择 休假事件的休假类型
- 选择 确定 ,然后选择 完成。
您创建了一个计算字段。现在,让我们创建第二个用于检索休假事件并将其用作过滤器的字段。
- 同样,从您的 Workday 实例中搜索 创建计算字段。
- 填写所有字段:
- 字段名称 输入计算字段的名称。例如, SANDOVAL CF 业务流程的 LKP 休假事件 采用以下格式:{(报告创建者)(cf= 已计算字段)(LKP = 查找相关值)(此字段返回的值)}。
- 业务对象 查找并选择 操作事件。我们希望我们的计算字段成为此业务对象的一部分。
- 函数 查找并选择 查找相关值。
- 选择左下角的 “ 确定 ”。
- 在 “计 算 ” 选项卡下,填写以下字段:
- 查找字段查 找并选择 休假事件。
- 返回值 查找并选择您创建的第一个计算字段。在我们的示例中, SANDOVAL CF LKP 缺勤类型。
- 选择 确定 ,然后选择 完成。
使用休假请求微应用的计算字段筛选自定义报告
使用刚创建的用于将 PTO 类型列入白名单的新计算字段向与休假批准相关的自定义报告添加筛选条件,这将允许您获得所有选择的休假类型。
- 从您的 Workday 实例中搜索 “ 编辑自定义报告 ”,然后选择与 PTO 批准相关的自定义报告,在我们的例子中 为休假请求的事件记录。
- 选择 筛选器 选项卡和 + 以添加新的筛选器。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择您创建的第二个计算字段,在我们的示例中, SANDOVAL CF LKP 业务流程的休假事件。
- 操作员 查找并选择 选择列表中的任何一个。
- 比较类型 查找并选择 在此筛选器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 年假 (天数)
- 年假(法定)
- 个人休假 (天数)
- 生病 (天)
- 休息时间
- 选择 “ 确定 ” 以保存。
注意:
要阻止 PTO 类型,请将字段: 操作员更改*为无选择列表**。这会阻止集成获取任何选定的 PTO 类型。
使用 “创建 PTO 请求” 和 “我的 PTO 请求” 微应用的现有字段筛选自定义报告
筛选自定义报告: 所有休假和余额。
注意:
我们建议在所有自定义报告中使用相同的 PTO 类型。这样,如果您决定将结果列入白名单或阻止结果,则所有自定义报告的 “ 比较值 ” 中的值都是相同的)。
- 从您的 Workday 实例中搜索 “ 编辑自定义报告 ”,然 后选择与休假批准相关的自定义报告,在我们的示例中为 “所有休假和余额”。
- 选择 筛选器 选项卡和 + 以添加新的筛选器。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择自定义报告 休假类型。
- 操作员 查找并 在选择列表中选择。
- 比较类型 查找并选择 在此筛选器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 年假 (天数)
- 年假(法定)
- 个人休假 (天数)
- 生病 (天)
- 休息时间
- 选择 “ 确定 ” 以保存。
筛选自定义报告: 缺勤请求。
- 从您的 Workday 实例中搜索 “ 编辑自定义报告 ”,然后选择与休假批准相关的自定义报告(在我们的例子中为 缺勤请求)。
- 选择 “ 子筛 选器” 选项卡,然后选择 + 以添加新的子过滤器,类似于添加过滤器的方式。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择自定义报告 休假输入的休假类型。
- 操作员 查找并 在选择列表中选择。
- 比较类型 查找并选择 在此筛选器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 带薪休假(天数)
- 生病 (天)
- 生病 (小时)
- 选择 “ 确定 ” 以保存。
在工作区中设置深层链接
如果您被提及本文,请联系您的管理员并要求他们在 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: 请求休假,然后选择 请求休假以获取全球现代服务。
- 转至 操作 > 业务流程 > 编辑定义。
- 除非需要,否则请勿更改 生效日期 ,然 后选择 “确定”
- 在 “ 业务流程步骤” 下,选择 + 图标以添加新行。
- 为 订 单输入 b。
- 输入 类型 的 批准。
- 从菜单中选择 组 的 管理器 。
- 选择 确定,然后选择 完成。
管理安全组权限
要为安全组启用适当的安全权限,需要完成两个过程。首先向组添加权限并激活设置。然后添加安全组以查看所有列表并激活设置。
添加和激活集成权限
- 在 Workday 中,搜索 视图安全组。
- 搜索所需的安全组,选择它,然 后选择确定。
- 转到 操作 > 安全组 > 维护安全权限。
-
在 集成权限部分下,在 允许获取访问权限的域安全策略 字段中搜索以下权限列表,然后将其全部添加。不要在搜索中使用冒号 ( :):
- 管理:组织集成
- 员工数据:公共工作人员报告
- 设置:支出类别
- 员工数据:人数报告
- 业务流程管理
- 业务流程报告
- 设置:费用项
- 流程:采购订单 — 查看
- 流程:支出报表 — 查看
- 员工数据:在职员工
- 员工数据:当前人员配备信息
- 员工数据:休假(休假余额)
- 工作人员数据:休假(休假)
- 工作人员数据:休假
- 报告:时间跟踪
- 选择 确定、查看,然后选择 完成。
- 搜索 激活待处理的安全策略更改。
- 在 注释 字段中,键入 激活,然 后选择确定。
- 选中 “ 确认 ” 复选框,然后选择 “ 确定”。 权限已更新并激活。
添加并激活安全组以查看所有列表
- 搜索 bp: change job ,然后 为全球现代服务选择换工作。
-
转至 操作 > 业务流程 > 编辑。
- 滚动到 “ 查看全部” 部分。将您的安全组添加到可以查看全部内容的安全组列表中。
- 选择 确定,然后选择 完成。
- 搜索 激活待处理的安全策略更改。
- 在 注释 字段中,键入 激活,然 后选择确定。
- 选中 “ 确认 ” 复选框,然后选择 “ 确定”。 权限已更新并激活。
您可以通过搜索 View 安全组并选择 安全组来查 看您的安全组。现在有两个选项卡, 域安全策略权限 和 业务流程安全策略权限。
找到你的基本 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 并搜索 View API 客户端。
- 查看第一个名为 Workday REST API 端点的字段。格式为
https://{domain}.workday.com/ccx/api/v1/{tenant}
。
将 Workday 集成添加到 Citrix Workspace 微应用
将 Workday 集成添加到 Citrix Workspace 微应用以连接到您的应用程序。这样可以提供带有预配置通知和操作的开箱即用的微应用程序,这些通知和操作可在工作区中使用
请按照以下步骤设置 Workday HTTP 集成。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。对于大多数用例,我们建议使用这种较新的 HTTP 集成。HTTP 集成提供了更多功能来配置缓存的数据结构。
请按照以下步骤进行操作:
- 在 微应用集成 页面中,选择 添加新集成,然后 从 Citrix 提供的模板中添加新集成。
- 从目录的 集成 类别中选择 Workday 磁贴。
- 输入 集成的集成名称 。
- 输入 连接器参数。
- 输入实例 基本 URL。这是您的 Workday 环境的域,例如
wd2-impl-services1
。有关识别基本 URL 的更多信息,请参阅查 找基本 URL。 - 从 图标 库中为集成选择一个图标,或将其保留为默认的 Workday 图标。
- 如果要创建 本地连接,请启用本地实例 切换。有关更多信息,请参阅 本地实例。
- 输入实例 基本 URL。这是您的 Workday 环境的域,例如
- 输入您的 Workday 用户名。
- 输入您的 Workday 密码。
- 输入你的 Workday 租户。有关识别租户的更多信息,请参阅查 找基本 URL。
- 在 服务身份验证下,从身 份验证方法 菜单中选择 基本 并填写身份验证详细信
-
输入您的 用户名 和 密码。
-
在服务操作身份验证下,启用在操作使用单独的用户身份验证开关。服务操作身份验证在服务操作级别进行身份验证。
- 从身份验证方法菜单中选择 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 集成配置中的 {tenant}
和 {user}
变量替换为租户和用于身份验证的用户凭据。
- 在 微应用集成 页面中,选择 Workday 集成旁边的菜单,然后选择 编辑。将打开 “ 数据加载 ” 屏幕。如果没有,请从左侧导航栏中选择 数据加载 。
-
对于每个数据端点,您必须手动添加以下内容的详细信息:
{tenant}/{user}
。你这样做了六次。选择端点旁边的菜单,然后选择 编辑。 - 在 “编 辑数据端点 ” 屏幕中,在 “ 路径 ” 选项卡下,将 租 户和 用户 添加到空字段中。
-
选择 应用 并确认。对其他五个数据端点重复此操作。
-
对于每个维修操作,您必须手动添加以下内容的详细信息:
{tenant}
。你这样做两次。编辑集成时,从左侧导航栏中选择 服务操作 。选择其中一个服务操作旁边的菜单,然后选择 编辑。 -
在 “编 辑服务操作 ” 屏幕中,在 “ 操作执行 ” 和 “ 路径 ” 选项卡下,将 租户 值 (citrix_gms2) 替换为租户。
- 您需要 在操作后删除并重新创建数据更新。 在操作后更新数据 标签旁边,选择 删除 图标以删除此部分。
- 选择 + 添加数据更新。
- 从 “ 数据端点 ” 菜单中选择 休假请求 。
- 选择 QUERY 选项卡,然后选择 + 添加参数。
-
在 “ 参数名 称” 中输入 Completed_date_ON_OR_AFTER。从 选择参数 菜单中,选择 时间戳。
- 选择 保存 以完成操作。对其他维修操作重复此步骤。
现在,您已准备好设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到微应用平台,因此我们建议您使用 “ 表 ” 页面筛选实体以进行首次数据同步,以加快同步速度。有关更多信息,请参阅验证所需实体。有关同步规则、不符合其计划的同步和否决规则的完整信息,请参阅同步数据。
有关 API 端点和表实体的更多详细信息,请参阅 Workday HTTP 连接器规范。
使用 Workday 微应用
我们的 Workday HTTP 集成模板随附以下预配置的开箱即用微应用。
创建休假请求: 提交带薪休假 (PTO) 请求。
通知或页面 | 用例工作流 |
---|---|
请求休假页面 | 提供用于创建带薪休假 (PTO) 请求的表单,包括选择类型、开始日期和结束日期以及可选地添加注释。 |
更改作业: 查看和批准变更任务请求。
通知或页面 | 用例工作流 |
---|---|
“新变更任务申请批准” 通知 | 提交新的变更任务批准请求后,审批人会收到通知。 |
“更改工作批准” 页 | 提供可操作的表单,其中包含变更任务请求的详细视图。 |
“更改工作以供审批” 页 | 提供审批者等待批准的变更任务请求的只读视图。 |
创建变更任务: 创建变更任务请求。
通知或页面 | 用例工作流 |
---|---|
“创建更改作业” 页 | 提供用于创建变更作业的页面。您必须在 Workday 中为 Citrix Workspace 微应用设置深度链接。 |
创建支出报表: 创建支出报表。
通知或页面 | 用例工作流 |
---|---|
“创建支出报表” 页 | 提供用于创建支出报表的表单。您必须在 Workday 中为 Citrix Workspace 微应用设置深度链接。 |
我的休假请求: 查看个性化的休假请求列表。
通知或页面 | 用例工作流 |
---|---|
休假请求状态已更新通知 | 当 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/公司_房户/用户名/报告_name?wsdl)
保存 URL,以便在将集成添加到 Citrix Workspace 微应用程序过程中设置微应用程序时使用。
筛选 PTO 类型
将 PTO 微应用限制为特定的休假类型,例如休假或病假。如果您在 Workday 中创建了以下自定义报表,则需要在 Workday 中创建计算字段,并使用以下过程筛选自定义报告。
- 休假请求的事件记录
- 休假请求详情
- 每个计划的休假类型
为 PTO 请求微应用创建计算字段
您需要创建两个计算字段。第一个计算字段旨在从休假事件中检索缺勤类型,以便在第二个计算字段中可用。第二个计算字段用作自定义报告中的筛选器。
- 登录到您的 Workday 实例并搜索 创建计算字段。
- 填写所有字段:
- 字段名称 输入计算字段的名称。例如,以下格式的 SANDOVAL CF LRV 缺勤类型 :{(报告创建者)(cf= 计算字段)(LRV = 查找相关值)(此字段返回的值)}。
- 业务对象 查找并选择 休假事件。我们希望我们的计算字段成为此业务对象的一部分。
- 函数 查找并选择 查找相关值。
- 选择左下角的 “ 确定 ”。
- 在 “计 算 ” 选项卡下,填写以下字段:
- 查找字段查 找并选择 休假事件。
- 返回值 查找并选择 休假事件的休假类型
- 选择 确定 ,然后选择 完成。
您创建了一个计算字段。现在,让我们创建第二个用于检索休假事件并将其用作过滤器的字段。
- 同样,从您的 Workday 实例中搜索 创建计算字段。
- 填写所有字段:
- 字段名称 输入计算字段的名称。例如, 业务流程的 SANDOVAL CF LRV 休假事件采用以下 格式:{(报表创建者)(CF= 计算字段)(lRV = 查找相关值)(此字段返回的值)}。
- 业务对象 查找并选择 操作事件。我们希望我们的计算字段成为此业务对象的一部分。
- 函数 查找并选择 查找相关值。
- 选择左下角的 “ 确定 ”。
- 在 “计 算 ” 选项卡下,填写以下字段:
- 查找字段查 找并选择 休假事件。
- 返回值 查找并选择您创建的第一个计算字段。在我们的示例中, 桑多瓦尔 CF LRV 缺勤类型。
- 选择 确定 ,然后选择 完成。
使用 PTO 请求微应用的计算字段筛选自定义报告
使用刚创建的用于将 PTO 类型列入白名单的新计算字段向与 PTO 批准相关的自定义报告添加筛选器,这将允许您获取所选的所有 PTO 类型。
- 从您的 Workday 实例中搜索 “ 编辑自定义报告 ”,然后选择与 PTO 批准相关的自定义报告,在我们的例子中 为休假请求的事件记录。
- 选择 筛选器 选项卡和 + 以添加新的筛选器。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择您创建的第二个计算字段,在我们的示例中, SANDOVAL CF LRV 业务流程的休假事件。
- 操作员 查找并选择 选择列表中的任何一个。
- 比较类型 查找并选择 在此筛选器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 年假 (天数)
- 年假(法定)
- 个人休假 (天数)
- 生病 (天)
- 休息时间
- 选择 “ 确定 ” 以保存。
注意:
要阻止 PTO 类型,请将字段: 操作员更改*为无选择列表**。这会阻止集成获取任何选定的 PTO 类型。
使用 “创建 PTO 请求” 和 “我的 PTO 请求” 微应用的现有字段筛选自定义报告
筛选每个计划自定义报告的休假类型。
注意:
我们建议在所有自定义报告中使用相同的 PTO 类型。这样,如果您决定将结果列入白名单或阻止结果,则所有自定义报告的 “ 比较值 ” 中的值都是相同的)。
- 从您的 Workday 实例中搜索 “ 编辑自定义报告 ”,然后选择与 PTO 批准相关的自定义报告,在我们的示例中为 每个计划的休假类型。
- 选择 筛选器 选项卡和 + 以添加新的筛选器。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择自定义报告 休假类型。
- 操作员 查找并 在选择列表中选择。
- 比较类型 查找并选择 在此筛选器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 年假 (天数)
- 年假(法定)
- 个人休假 (天数)
- 生病 (天)
- 休息时间
- 选择 “ 确定 ” 以保存。
筛选休假请求详细信息自定义报告。
- 从您的 Workday 实例中搜索 编辑自定义报告 ,然后选择与 PTO 批准相关的自定义报告,在我们的例子中为 休假请求详细信息。
- 选择 “ 子筛 选器” 选项卡,然后选择 + 以添加新的子过滤器,类似于添加过滤器的方式。
- 填写以下字段:
- 和/或 和
- 字段 查找并选择自定义报告 休假输入的休假类型。
- 操作员 查找并 在选择列表中选择。
- 比较类型 查找并选择 在此筛选器中指定的值。
-
比较值 查找并选择要列入白名单的 PTO 类型,例如:
- 带薪休假(天数)
- 生病 (天)
- 生病 (小时)
- 选择 “ 确定 ” 以保存。
在工作区中设置深层链接
如果您被提及本文,请联系您的管理员并要求他们在 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。 - 输入您的 Workday 实例作为 实例 URL。通过登录 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。
-
切换 启用采购订单模块? 如果您创建采购订单并希望根据数据下载数据并生成通知,则设置为 “是” 。这使用公共 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) 请求。
通知或页面 | 用例工作流 |
---|---|
新的批准时间通知 | 提交新的休假审批请求后,审批人会收到通知。 |
“休假请求批准” 页面 | 提供可操作的表单,其中包含休假请求的详细视图。 |
“休假申请批准” 页面 | 提供审批者等待批准的休假请求的只读视图。 |