通过 Workiva 连接解决方案，可以通过多种方式更新 Workiva 电子表格中的数据。使用 Wdata 时，可以创建一个 传入连接 以从 Wdata 查询刷新电子表格中的数据。在本文中，我们将探讨如何使用链式调用 Write Sheet Data 和 Overwrite Sheet Data 命令来更新电子表格中的数据。
常用命令输入
“写入工作表数据”和“覆盖工作表数据”命令有几个相同的输入项。
| 输入 | 目的 |
| 电子表格ID | 要写入数据的 Workiva 电子表格的 ID 。 |
| 图纸编号/名称 |
电子表格中要写入数据的工作表的名称 或 ID 。 名称 区分大小写。 |
| 数据文件 |
包含要写入工作表的分隔符数据的文件。CSV 是最常见的文件格式，但也支持其他分隔符。 要使用此命令，必须将 JSON 数据转换为分隔符格式。 |
| 分隔符号 |
文件分隔符。逗号 (,) 是最常见的分隔符，但支持任何分隔符，包括分号 (;)、竖线 (|) 或制表符 (\t)。 请确保包含指定分隔符的数据字段用双引号括起来。例如，在逗号分隔的文件中： Workiva“美国爱荷华州艾姆斯”WK |
| 区域 （写入工作表数据）/ 起始单元格 （覆盖工作表数据） |
数据将写入的起始单元格地址。 有关 有效 值的更多信息，请参阅下面每个命令的特定部分。 |
| 使用异步 |
选中该命令后，将对工作表执行异步更新。这意味着，在平台内仍在执行表格更新操作的同时，Chain 将继续执行其下一个操作。 建议对大型数据集使用此选项，但前提是后续的链式操作不依赖于工作表更新。 |
| 使用平台 API |
选中后，该命令将使用平台 API 而不是传统的电子表格 API 来执行更新。 平台 API 不推荐使用 ，因为它是较新的 API，并且会不断添加新功能。 |
写入表格数据
当需要更新工作表中的特定区域，同时保留工作表中其他区域的数据时，最好使用“写入工作表数据”命令。下表概述了每个指定区域格式的清除行为。
| 格式 | 范例 | 影响 |
| 单小区地址 | B2 |
更新工作表中的单个单元格，不会影响其他单元格的值。 除非要写入单个单元格值 ，否则 不建议使用此格式。如果数据文件包含多个数据点，则使用此格式时命令将失败。 |
| 起始单元格地址，无结束单元格或列 | B2: |
从起始单元格地址开始更新表格。 起始单元格地址左侧（列）和上方（行）的工作表值将被保留；所有其他值将被清除，即使数据文件中的行或列不包含单元格值。 |
| 起始单元格地址，结束列，无结束行 | B2:D |
从起始单元格地址开始更新表格。 起始单元格地址左侧（列）和上方（行）的工作表值将被保留；所有其他值将被清除，即使数据文件中的行或列不包含单元格值。 |
| 起始单元格地址，结束单元格地址 | B2:D5 |
替换指定范围内的所有单元格。 注意：如果命令中指定的范围小于（行数或列数少于）正在加载的数据文件，则命令将失败。 |
覆盖工作表数据
当需要清除工作表中的整个数据块时，最好使用“覆盖工作表数据”命令。下表概述了每种指定起始单元格格式的清除行为。
| 格式 | 范例 | 影响 |
| 单小区地址 | B2 |
保留起始单元格地址左侧（列）和上方（行）的工作表值；清除工作表中的所有其他值，并将数据从指定的单元格地址开始写入数据文件中。 |
| 起始单元格地址，无结束单元格或列 | B2: |
保留起始单元格地址左侧（列）和上方（行）的工作表值；清除工作表中的所有其他值，并将数据从指定的单元格地址开始写入数据文件中。 |
| 起始单元格地址，结束列，无结束行 | B2:D |
此格式 不受支持 ，将导致命令执行错误。 |
| 起始单元格地址，结束单元格地址 | B2:D5 |
保留起始单元格地址左侧（列）和上方（行）的工作表值；清除工作表中的所有其他值，并将数据从指定的单元格地址开始写入数据文件中。 数据文件的宽度（列）和高度（行）无关紧要。 |
试试看
我们创建了一个链式模板和测试电子表格，以便您可以查看上述每种 起始单元格/区域 格式的结果。测试：
- 从此链接下载测试电子表格 (25 KB) 并将其 导入 到您的工作区。
- 创建测试链，利用 使用链更新 Workiva 电子表格 模板 位于 4. 快速入门指南 -> 启用和使用示例模板文件夹。
- 建议将 电子表格 ID 模板变量映射为 链变量。
- 在工作区中运行链之前，请更新 电子表格 ID 链变量 。
- 确保 Workiva Chains 连接 中的用户具有 文件:写入 范围 ，并且该用户已被分配给导入的电子表格。
- 运行链式反应并查看结果。预期结果列于导入电子表格的 预期结果 工作表中。