Workiva Support Center

借助 Chains，您可以自动执行日常任务，并轻松集成以跨多个记录系统检索或发送数据。例如，您可以创建一个链，自动将财务信息从数据源提取到表中，然后将该数据推送到另一个系统以生成报告。在 链构建器中，您可以安排和链接链应该执行的任务（或 命令） 。

注意： 只有 工作区所有者或链所有者 才能访问 链构建器。在 Wdata 中，单击 链，然后单击 打开链构建器

通过 开始使用表格 和 开始使用查询中的练习，您可以创建类似于财务报告中使用的表格和查询。在这个练习中，我们将创建一个链来运行该查询并将其结果导出到电子表格。 

步骤 1：获取查询的 ID 和参数

如果您还没有这样做 ，请下载 示例数据并完成“表格入门” 和 “查询入门 ”练习，因为您将在链中使用查询。记下查询的 ID，这是你在查询链中识别查询的方式。

注： 当您在 Wdata 中打开查询时，其 ID 会出现在其 URL 的/queries/ 之后。

如果您使用参数而不是静态值创建了查询筛选器，请同时记下参数名称。例如：

• 上一年
• CY 或 Current_Year
• 当前周期

步骤 2：创建电子表格

在创建链之前， 创建一个电子表格 来导出查询结果。

为避免滥用电子表格，请在其名称中明确标明其教育用途。

创建电子表格后，记下其 URL；您将使用它来确定将查询结果导出到哪里。 

步骤 3. 创建链条

现在是时候建立链条了！最后，它将包含运行查询并将其最新结果导出到电子表格的命令。

在创建链之前，请确认您已设置用于执行其命令的 核心 Workiva 连接器 。虽然此链只需要一个连接器，但链可以使用多个连接器来准备和传输跨各种记录系统的数据。

连接器设置完成后，您可以在 链构建器中添加链：

1. 在 Wdata 中，单击 链 ， 链构建器。
2. 点击 构建， 链，然后点击右下角的 添加， 创建链 。
   

3. 请输入唯一的名称和描述，以便识别该链条。

   注意： 链会显示在 链构建器 中，供工作区中的每个人使用；请为它们命名，以便成员清楚地了解其意图。有关命名方面的更多信息，请参阅 最佳实践：链及其对象的命名约定

   ]。
4. 点击 保存。

步骤 4. 从运行时输入触发事件开始

要让链式调用开始请求其命令所需的变量， 添加 运行时输入 触发事件。

提示： 除了运行时输入外，您还可以 为链或工作区添加变量。使用变量，您可以扩展链式调用的用途，例如，可以使用 `` 来调用任何查询或电子表格，而不仅仅是特定的查询或电子表格

1. 点击 触发事件play_for_work，将 运行时输入touch_app 移动到 开始，然后点击 编辑创建。
2. 在 基本信息下，输入一个唯一的名称和描述，以帮助识别该事件。
   

3. 在 变量下，添加以下变量：

   • 查询 ID
   • 任何查询参数值
   • 电子表格网址

   提示 ：对于每个变量，点击 “添加输入” ，选择 “文本框” ，然后输入其名称、描述和默认值

   。
4. 点击 保存。

步骤 5. 添加运行查询的命令

接下来，添加 运行查询 命令，以便链式调用每次运行时都能获取最新结果。您将使用运行时输入来识别查询的 ID 和参数值。

1. 在 可用连接器下，选择 Workiva，然后将 运行查询 拖到画布上。

2. 将链接从 开始 拖到 运行查询，然后单击命令的 编辑。

   注意： 请务必将命令链接到 “开始 ”命令

   ，以便它可以使用运行时输入。

   

3. 在 基本信息下，输入一个唯一的名称和描述来标识该命令。
4. 在 命令属性下，选择 Workiva 连接器来执行命令。
5. 对于 查询 ID，在 触发器下选择查询 ID 的运行时输入。

6. 如果查询的筛选条件使用参数值，请单击 “参数”下的 “ 添加(+)”，然后输入它们的键值对：

   索引键	值
   上一年	在 触发器下，选择上一年的运行时输入。
   CY 或 Current_Year	在 触发器下，选择当前年份的运行时输入。
   当前周期	在 触发器下，选择当前周期的运行时输入。

7. 点击 保存。

步骤 6. 添加导出结果的命令

现在，添加一条命令，将查询结果导出到电子表格：

1. 在 可用连接器下，选择 Workiva，然后将 导出查询结果拖到画布上。
2. 将链接从 运行查询 拖到 导出查询结果，然后单击 编辑 以编辑后者。
   
3. 在 基本信息下，输入一个唯一的名称和描述来标识该命令。
4. 在 命令属性下，选择与 运行查询相同的 Workiva 连接器。
5. 对于 查询结果 ID，选择 ID 作为 查询结果 输出，在 运行查询下。
6. 对于 电子表格 URL，请在 触发器下选择电子表格 URL 的运行时输入。
7. 点击 保存。

步骤 7. 运行链条

运行该链：

1. 点击 发布，然后再次点击 发布 。
2. 单击 执行 ，然后单击 使用输入运行。
3. 输入运行时输入值，然后单击 开始。
4. 要验证链是否成功，请检查电子表格中的查询结果。

如果链式执行失败，请点击运行历史记录中的命令，查看其日志中的消息，以帮助排查错误。