Workiva Scripting 连接器提供了一种在 Workiva 平台内运行 Python 脚本的简单方法。它独立于完整的脚本编写体验运行,允许非技术用户执行脚本而无需深入了解底层源代码。
有关兼容命令的完整列表,请参阅 Workiva Scripting 命令 文章。
脚本编写功能目前仅作为早期用户计划的一部分提供。如果您有兴趣在工作区中添加脚本功能,请联系您的客户成功经理,讨论参与该计划的事宜。
了解更多脚本编写要求。
要求
使用 Workiva 连接器之前:
- 组织安全管理员 必须通过“配置”屏幕启用 Workiva Scripting 连接器。
- 要在测试环境中运行该链,您需要 URL 来覆盖 API 的主机和基本路径。
为什么我应该使用 Workiva Scripting 连接器而不是 HTTP 请求?
HTTP 请求 连接器需要额外的逻辑来刷新 bearer tokens 并轮询脚本的状态。使用 Workiva Scripting 连接器可以消除这些要求。
此外,Workiva Scripting 连接器还提供了其他功能,例如在链中的其他位置使用命令输出(如 stdout 和日志)。
连接设置
设置 Workiva Scripting 连接器:
- 打开 链构建器。
- 点击左侧导航区域中的 连接 ,然后点击页面右上角的 创建 。
- 在 连接器连接下,选择 Workiva 脚本 和默认的 CloudRunner。
- 在 基本信息下,输入唯一的名称和描述,以帮助识别连接器。
-
在 属性下,输入连接的详细信息:
摘要信息 详细信息 客户ID 输入集成用户的 OAuth 授权 ID。
这是随机生成的。客户机密 请输入 ID 属性的密钥。
这是随机生成的。脚本服务器 API (可选)输入将替换脚本服务器 API 的默认 URL 主机和基本路径的 URL。 IAM 主机覆盖 (可选)输入将替换 身份和访问管理 (IAM) 端点的默认 URL 主机和基本路径的 URL。 脚本 API 版本 选择要使用的 API 版本。
V1 是默认版本,推荐大多数用户使用。
V0版本将在不久的将来移除。 - 选择要使用连接的环境,然后单击 保存。
URL覆盖
根据生产环境所在区域的不同,可能需要使用覆盖 URL。您可以通过与用于登录 Wdesk 的 URL 进行比较来验证这一点。如果 URL 中包含 EU 或 APAC ,则需要进行覆盖。
注: 此处列出的是美国地区信息,仅供参考。如果您位于该区域,则无需应用任何覆盖设置。
| 字段 | 值 |
|---|---|
| 脑宿主覆盖 | https://h.app.wdesk.com/s/cerebral |
| 电子表格主机覆盖 | https://api.app.wdesk.com/spreadsheets/v1/ |
| IAM 主机覆盖 | https://api.app.wdesk.com/iam/v1/oauth2/token |
| 管理员主机覆盖 | https://api.app.wdesk.com/admin/v1 |
| 图数据库主机覆盖 | https://api.app.wdesk.com/graphdb/v1/ |
| 平台 API 主机覆盖 | https://api.app.wdesk.com/platform/v1 |
| 脚本服务器 API 覆盖 | https://h.app.wdesk.com/s/scripting |
| 字段 | 值 |
|---|---|
| 脑宿主覆盖 | https://h.eu.wdesk.com/s/cerebral |
| 电子表格主机覆盖 | https://api.eu.wdesk.com/spreadsheets/v1/ |
| IAM 主机覆盖 | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| 管理员主机覆盖 | https://api.eu.wdesk.com/admin/v1 |
| 图数据库主机覆盖 | https://api.eu.wdesk.com/graphdb/v1/ |
| 平台 API 主机覆盖 | https://api.eu.wdesk.com/platform/v1 |
| 脚本服务器 API 覆盖 | https://h.eu.wdesk.com/s/scripting |
| 字段 | 值 |
|---|---|
| 脑宿主覆盖 | https://h.apac.wdesk.com/s/cerebral |
| 电子表格主机覆盖 | https://api.apac.wdesk.com/spreadsheets/v1/ |
| IAM 主机覆盖 | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| 管理员主机覆盖 | https://api.apac.wdesk.com/admin/v1 |
| 图数据库主机覆盖 | https://api.apac.wdesk.com/graphdb/v1/ |
| 平台 API 主机覆盖 | https://api.apac.wdesk.com/platform/v1 |
| 脚本服务器 API 覆盖 | https://h.apac.wdesk.com/s/scripting |