注:此 Workiva 开发的连接器允许您连接 Workiva 和 Workday 平台。Workiva 支持团队很乐意指导您完成工作区内连接器的配置。但是,Workday 平台中的任何错误或 Workday 平台内的故障排除都必须由您的 Workday 管理员或其支持团队处理。
借助 Workday 连接器,您可以使用链式命令 与 Workday® HR 和财务系统进行交互,以:
- 从 Workday 下载自定义报表
- 将预算数据导入 Workday
- 启动 Workday 企业界面构建器 (EIB) 集成
要求
要建立连接,您需要:
- 要连接的 Workday 租户。
- 要连接的 Workday 环境的主机和域。
- 在 Workday 中创建的集成系统用户的身份验证凭据。
步骤 1:获取 Workday 租户信息
您可以从 Workday 公共 Web 服务 WSDL XML 文件中确定租户、主机和域信息。
- 在 Workday 搜索栏中输入“公共 Web 服务”,然后选择该报告。
- 找到您正在使用的特定集成的 Web 服务。
例如:Get Workers 的人员配备、Import Budget 的财务管理、EIB 相关命令的集成…… - 单击该服务的“相关操作”按钮,然后单击“Web 服务”菜单下的 查看 WSDL 。
- 在 XML 文件中,找到
soapbind:address元素(这通常位于文件的底部附近)。 - 使用
location属性中的 URL,从 URL 中提取租户、主机和域信息。
URL 使用以下格式:https://{host}.{domain}/ccx/service/{tenant}/public_web_service_name/version_number
范例
使用上述格式,我们可以从示例 WSDL URL 中找到租户、主机和域名:https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1
| 摘要信息 | 样本值 |
|---|---|
| 租户 | 我的公司 |
| 主持人 | wd2-impl-services1 |
| 领域 | workday.com |
在下一步设置连接器时,您将需要这些值。
步骤 2:配置 Workday 身份验证
此连接器提供两种身份验证方式:通过 API 的 OAuth2 身份验证和用户名+密码身份验证。
OAuth2 API 身份验证
如果您使用 OAuth2 API 身份验证,则必须在 Workday 中设置 API 客户端。有关创建 API 客户端的说明,请参阅 Workday 支持页面 注册 API 客户端 。
作为 API 客户端配置的一部分,请确保您已具备以下条件:
- 已选择 Bearer 作为 Access Token Type。
- 已启用(选中)以下复选框:
- 永不过期的刷新令牌
- 包含 Workday 自有范围
重定向网址
Workiva 为连接器配置提供了特定区域的连接覆盖 URL。请使用下表选择您所在位置的正确网址。
如果您身处北美洲、中美洲或南美洲,请使用默认网址。如果您身处亚太地区,请使用亚太地区网址。如果您身处欧洲、中东和非洲地区,请使用欧盟网址。
| 环境 | 重定向 URL |
|---|---|
| 亚太地区产品 | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| 欧盟产品 | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| 美国产品 | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
OAuth2 端点
如果您使用 OAuth2 来验证您的连接,则需要以下端点值。当您在 Workday 的 编辑 API 客户端 页面上设置 Workday API 客户端时,这些选项将会列出。
| 端点 | 样本值 |
|---|---|
| Workday REST 端点 | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Workday OAuth2 令牌端点 | https://xxxx.workday.com/ccx/oauth2/xxxx/token |
| Workday OAuth2 授权端点 | https://xxxx.workday.com/xxxx/authorize |
提示: 如果您使用的是使用 OAuth2 令牌和密钥的现有 API 客户端实例,则可以在 Workday 查看 API 页面的顶部看到此信息。
基本身份验证
如果您使用的是 基本身份验证,请参阅 Workday 支持页面在 Workday 中创建集成系统用户 (ISU) 帐户 ,了解有关创建集成系统用户 (ISU) 的说明。
步骤 3:设置 Workday 连接器
注意: 要使连接器可在您组织的链中使用, 组织安全管理员必须首先在配置中启用它。
- 从 链构建器中,单击 连接,然后单击右上角的 创建 。
- 在 连接器连接下,选择 Workday 连接器 和默认的 CloudRunner。
- 在 基本信息下,输入一个唯一的名称和描述,以帮助识别连接。
-
在 属性下,输入连接的详细信息。如果您使用 OAuth2,则需要输入以下值:
Workday REST Endpoint、 Workday OAuth2 Token Endpoint和 Workday OAuth2 Authorization Endpoint。如果您使用 基本身份验证(用户名+密码 ) ,请将
这些留空。字段 内容 租户 要连接的 Workday 租户。 主持人 要连接的 Workday 环境的主机。在环境的 URL 中, Domain 属性之前的字符表示主机。 领域 要连接的
Workday环境的域,例如workday.com或myworkday.com。Workday REST 端点 Workday提供的REST端点URL。
(仅限使用 OAuth2 身份验证时。)Workday OAuth2 令牌端点 Workday提供的OAuth2令牌端点URL。
(仅限使用 OAuth2 身份验证时。)Workday OAuth2 授权端点 Workday提供的OAuth2端点URL。
(仅当使用 OAuth2 身份验证时。)
疑难解答
如果与 Workday 的连接失败:
- 验证集成系统用户的身份验证凭据是否正确。
- 确认集成系统用户拥有访问与连接命令相关的功能组和域的适当权限。
- 请确认已为连接器输入正确的 Workday 租户、主机和域。
- 运行 下载自定义报告 命令时,请确保报告类型设置为 高级。目前Workday API尚不支持生成综合报表。