Workiva支持中心

想要连接到 Workiva 预置的 Premium Connectors 之外的第三方应用程序？您可以通过利用 HTTP 请求连接器命令 与 REST API 进行交互来实现这一点。 

注意： 虽然标记为 HTTP 请求，但支持（并推荐）HTTPS（安全 HTTP）。

在这个关联学习路径中，我们将更新我们的链，以使用运行时输入，我们可以在其中指定要检索的电子表格。

步骤 1：复制并修改链

1. 导航至 Chain Builder 并找到 Chain CLP | HTTP 请求列表电子表格。
2. 点击垂直椭圆 复制 链条。
3. 点击铅笔图标编辑链条。
4. 点击右上角的 链设置 ，并将链重命名为： CLP | HTTP 请求获取单个电子表格。
5. （可选）输入 描述：“此链生成一个新的 Workiva API 访问令牌。您必须在以下变量值中提供之前生成的 API 授权中的有效客户端 ID 和客户端密钥。当执行链式操作时，它会提示用户输入电子表格 ID。系统将检索电子表格。
6. 拯救 链条。

步骤 2：运行时输入

使用 运行时输入链事件 来启动链。
这样我们就可以指定要获取的电子表格的电子表格 ID。阅读更多关于运行时输入的内容。

1. 将 POST - 获取令牌 命令从启动节点移开。
2. 从 链触发事件 向起始节点添加 运行时输入 链事件。
3. 双击将 “运行时输入” 与 “获取 - 列出电子表格 ”命令连接起来的链接，然后 删除 该链接。
4. 将运行时输入 连接到 POST - 获取令牌 命令。

5. 将 POST - 获取令牌 命令连接到 GET - 列出电子表格 命令。

   

6. 双击“ 运行时输入 链事件”进行配置。
7. 点击 “添加输入” ，并配置以下字段：
   • 类型： 文本字段
   • 显示名称： 电子表格 ID - 请查看 此文档 以获取查找 ID 的帮助
   • 必填： 选中此复选框
8. （可选）输入 描述：“此命令允许用户指定所需的运行时输入值。”
9. 保存 命令。

步骤 3：更新 Get 命令

我们将更新 HTTP 请求 Get 命令，以便提供有关单个电子表格的详细信息，而不是列出工作区中的所有电子表格。

1. 双击 “获取 - 电子表格列表 ”命令进行配置。
   1. 命令名称： 获取 - 检索单个电子表格。

   2. 在 URL 字段中使用运行时输入中的 电子表格 ID 变量来指定要检索的电子表格。
      要做到这一点，请点击 URL 字段，然后在 /spreadsheets 后添加“/<电子表格 ID >”，并
      替换为 <Spreadsheet ID> 运行时输入 变量如下所示：

      

      1. 在左侧面板中，展开 “触发器” 下拉菜单。
      2. 展开 “运行时输入” 下拉菜单。
      3. 选择 电子表格 ID 变量。

2. （可选）输入 描述：“此命令返回单个电子表格。更多信息，请参阅开发者文档：https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html
3. 保存 命令。

步骤 4：测试练习

现在链条已经完成，我们可以测试结果了。

1. 发布 该链条。
2. 点击 “执行”，然后 点击“使用输入运行”。
3. 找到一个 电子表格ID通过在 Workiva 平台中导航至电子表格。请确保授予用户拥有此电子表格的权限。
4. 点击 开始。
5. 链式调用运行完毕后，您可以在 “输出”选项卡中的 “Get 命令的 响应正文”中看到已生成电子表格详细信息。