想要连接到 Workiva 预置的 Premium Connectors 之外的第三方应用程序？您可以通过利用 HTTP 请求连接器命令 与 REST API 进行交互来实现这一点。
注： 虽然此请求标记为 HTTP 请求，但支持（并推荐）HTTPS（安全 HTTP）。
在这个关联学习路径中，我们将更新我们的链，以使用运行时输入，我们可以在其中指定要检索的电子表格。
| 主要业务用例 | 连接到第三方系统 |
| 主要学习目标 | 利用 Workiva 的 HTTP 请求连接器命令，可以与第三方应用程序的 REST API 进行交互，而无需依赖预构建的连接器。更新链式结构，使用运行时输入来指定要使用的电子表格。 |
| 次要学习目标 | 使用运行时输入 |
| 先决条件 | |
| 支持模板 | CLP | HTTP 请求获取单个电子表格 |
步骤 1：复制并修改链
- 导航至链构建器并找到链 CLP | HTTP 请求列表电子表格。
- 点击垂直椭圆 复制 链。
- 点击铅笔图标编辑链条。
- 点击右上角的 链设置 ，并将链重命名为： CLP | HTTP 请求获取单个电子表格。
- （可选）输入 描述: "此链生成一个新的 Workiva API 访问令牌。您必须在以下变量值中提供之前生成的 API 授权中的有效客户端 ID 和客户端密钥。当执行链式操作时，它会提示用户输入电子表格 ID。系统将检索电子表格。
- 保存 链条。
步骤 2：运行时输入
使用 运行时输入链事件 来启动链。
这样我们就可以指定要获取的电子表格的电子表格 ID。阅读更多关于运行时输入的内容。
- 将 POST - 获取令牌 命令从启动节点移开。
- 从 链触发事件 向起始节点添加 [] 运行时输入 链事件。
- 双击连接 运行时输入 和 获取 - 列出电子表格 命令 的链接，然后 删除 该链接。
- 将 运行时输入 连接到 POST - 检索令牌 命令。
-
将 POST - 获取令牌 命令连接到 GET - 列出电子表格 命令。
- 双击 运行时输入 链式事件 进行配置。
- 点击 添加输入 并配置以下字段：
- 类型： 文本字段
- 显示名称： 电子表格 ID - 请查看 此文档 以获取查找 ID 的帮助
- 必填： 勾选此复选框
- （可选）输入 描述：“此命令允许用户指定所需的运行时输入值。”
- 保存 命令。
步骤 3：更新 Get 命令
我们将更新 HTTP 请求 Get 命令，以便提供有关单个电子表格的详细信息，而不是列出工作区中的所有电子表格。
- 双击 获取 - 电子表格列表 命令进行配置。
- 命令名称： 获取 - 检索单个电子表格。
-
使用 URL 字段中的运行时输入中的 电子表格 ID 变量来指定要检索的电子表格。要执行此操作，请单击 URL 字段，然后在 / spreadsheets后添加“/ <电子表格 ID>” ，将
替换为
<Spreadsheet ID> 使用来自 运行时输入 的变量，如下所示：- 在左侧面板中，展开 触发器 下拉菜单。
- 展开 运行时输入 下拉菜单。
- 选择 电子表格 ID 变量。
- （可选）输入 描述: "此命令返回单个电子表格。更多信息，请参阅开发者文档：https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/
- 保存 命令。
步骤 4：测试练习
现在链条已经完成，我们可以测试结果了。
- 发布 链。
- 单击 执行，然后单击 使用输入运行。
- 通过在 Workiva 平台中导航到电子表格，查找 电子表格 ID。请确保授予用户拥有此电子表格的权限。
- 点击 开始。
- 链运行完成后，您可以在 输出选项卡 - 获取命令的 ] 响应正文 中看到电子表格详细信息已生成。
To continue to challenge yourself and learn more about using the HTTP Request Connector to connect to a third party API, check out the next exercise CLP Copy a Spreadsheet (add link when document created).
-->