Workday Adaptive Planning 连接器 （以前称为 Adaptive Insights）使用链式命令 导入或导出数据或元数据。
注： 此连接器由 Workiva 构建，并连接到第三方系统。虽然我们的支持团队可以帮助您在工作区内配置此连接器，但我们无法对源自 Workiva 平台之外的任何问题进行故障排除或提供其他帮助。
要求
为了实现连接，连接器使用 Workday Adaptive Planning REST API。要设置连接器，您需要：
- 在 Adaptive Planning 中设置的集成用户，已被分配具有适当权限的角色来执行连接器的命令。
- 集成用户的用户名和密码。
- 如果集成用户可以访问 Adaptive Planning 的多个实例，则表示他们将连接到实例代码。
注： 要确定集成用户可用的实例代码，您可以使用 Adaptive Planning 的 exportInstances
API端点。
设置 Workday Adaptive Planning 连接器
注： 要使连接器可在您组织的链中使用， 组织安全管理员首先需要在配置中启用它。
- 从 链构建器中，单击 连接 ，然后单击右上角的 创建 。
- 在 连接器连接下，选择 Workday Adaptive Planning 和默认的 CloudRunner。
Workiva 提供两种身份验证方法（基本身份验证和 JWT Bearer Grant（Workday 凭证））。您可以在连接配置的 凭据 下选择要使用的凭据。
使用基本身份验证进行身份验证
- 在 属性下，可以选择输入 Adaptive Planning 实例的实例代码。
- 选择“基本凭证”作为身份验证类型。
- 输入以下值：
用户名: 要与连接器一起使用的集成用户的用户名。
密码： 用户名字段中提供的用户的密码。
使用 JWT 持有者授权（Workday 凭证）进行身份验证
此身份验证方法使用 Workday 凭据对 Adaptive Planning 进行身份验证，并且需要满足以下条件：
- 单点登录已启用。
- Workday 租户设置中已启用自适应规划用户登录和公共 API。
- Workday 和 Adaptive Planning 之间通过公共 API ISU 进行映射。
有关此设置的具体详细信息，请参阅以下 Workday 文档：
作为此配置的一部分，必须将 x509 私钥上传到此连接的 连接资源 部分，并且必须将此密钥创建的公钥证书上传到 Workday 并与“JWT 持有者授权”类型的 API 客户端关联。该客户端必须与您用于向 Adaptive Planning 发出请求的 ISU 相关联，并且两个系统之间需要映射凭据。
有关此设置的具体详情，请参阅以下 Workday 文档： 注册 API 客户端。
关键细节
支持的私钥格式为 PKCS#8，可以是密码保护的，也可以是不密码保护的。可以使用 openssl 通过以下命令创建新密钥：
openssl req -x509 \ -newkey rsa:2048 \ -keyout key.pem \ -out cert.pem -days 3650
确定 Workday 主机、域和租户
使用 API 客户端下列出的 Workday REST API 端点，确定主机、域和租户，格式如下： https://{host}.{domain}/ccx/api/v1/{tenant}
范例
https://wd2-impl-services1.workday.com/ccx/api/v1/mycompany
| 摘要信息 | 值 |
| 租户 | 我的公司 |
| 主持人 | wd2-impl-services1 |
| 领域 | workday.com |
在自适应规划连接器中设置 Bearer 凭证类型
- 将您的私钥上传到连接的“资源”部分。
- 选择“持有者”认证类型。
- 请输入以下信息：
摘要信息 详细信息 x509 私钥 请准确输入已上传私钥的名称，与连接资源中显示的名称完全一致。 密码 请输入私钥密码。如果您的密钥未设置密码保护，请将此字段留空。 客户ID 输入 JWT Bearer Grant API 客户端的客户端 ID。 集成服务用户 输入与 API 客户端关联的集成服务用户 (ISU) 的名称 主持人 输入要连接的 Workday 环境主机。在环境的 URL 中，Domain 属性之前的字符代表主机。 租户 输入要连接的 Workday 租户。 领域 输入要连接的 Workday 环境的域名，例如 workday.com 或 myworkday.com。
完成身份验证后：
- 选择要使用连接的环境，然后单击 保存。
- 要测试连接， 创建并运行一个链 使用 连接器的 导出版本 命令，并验证它是否返回有效输出。
疑难解答
如果与 Workday Adaptive Planning 的连接失败：
- 验证集成用户的身份验证凭据。
- 确保集成用户的角色拥有连接器执行命令所需的适当权限。
- 如果集成用户可以访问 Adaptive Planning 的多个实例，请检查为连接器输入的实例代码。
如需了解有关使用 Workday 凭据发出 Adaptive Planning API 请求的更多信息，请参阅此 Workday 页面： 使用 Workday 凭据发出 Adaptive Planning API 请求。