Workiva支持中心

Load Data to Wdata 模板通过替换现有数据集或添加新数据集，将数据导入 Wdata 表 。此模板最常用于现有流程的一部分，但也可以添加到任何需要将数据集上传到表中的工作流程中。

要求

• 必须先创建目标 Wdata 表，然后才能执行此链。
• 该模板由三条链组成。每个链都必须 单独 发布到您的工作区。
• 文件名必须包含 .csv 或 .tsv 扩展名。例如：“File_Name_Example.csv”。
• 建议数据集的最大文件大小为 300mb。了解更多文件大小建议。

找到模板

“加载数据到 WData”模板位于 模板 屏幕的 Workiva Chains 部分。

以下是查找方法：

1. 在 Chain Builder 中，转到 Templates dynamic_feed 选项卡。
2. 从顶部菜单中选择 Workiva Chains 。
3. 在右上角搜索 Load Data to Wdata | Primary Chain并打开模板。

4. 找到模板后，点击 新建链 将其部署到您的工作区。 

   注意：配置完成后，此模板中的 每个链都必须发布到工作区

   。

配置模板

此模板由三条链组成：主链、替换数据集链和添加新数据集链。当主链部署到您的工作区时，两​​个子链（添加/替换）也会自动随其部署。

以下是对每个链条的详细介绍：

• 主链: 此链确定表中是否存在与链正在加载的数据集同名的数据集。如果找到匹配的数据集，该链会捕获有关匹配数据集的信息，并根据您为父链配置的“加载方法”运行时输入，将该数据重定向到两个子链之一。

• 替换数据集链: 此链从表中删除匹配的数据集，并将其替换为新数据集。如果在执行过程中发生错误并选择回滚选项，则链将自动删除新数据集并恢复到要替换的数据集。  

• 添加新数据集链: 此链创建一个新数据集并将其导入到您的表中。新数据集必须具有唯一的文件名，该文件名不能被表中任何其他数据集使用。

将这组链添加到现有链时，必须在“运行链”节点中配置主链的运行时输入。子链不需要任何更改或配置。  

您的设置应该类似于这样：

变量

运行时输入

疑难解答

查看您的链式运行历史记录，包括错误信息：

1. 转到 Chain Builder 中的 Monitor 选项卡。
   

2. 将鼠标悬停在问号上，即可查看链式运行状态。
   
   

如果您的流程触发了错误或未能更新正确的数据，请执行以下检查：

• 请确认所有三条链都已发布到您的工作区。每条链条都必须单独发布。
• 请确保您的数据集使用受支持的分隔符，并且文件名包含 .csv 或 .tsv 扩展名（“File_Name_Example.csv”）。
• 使用“替换数据集”加载方法时，请检查文件名是否与 Wdata 表中的现有文件名匹配。如果文件不匹配，该链只会向表中添加一个新文件，而不会替换旧文件。
• 相反，当使用“添加新数据集”加载方法时，请检查文件名是否在 Wdata 表的其他任何地方使用。如果使用重叠的文件名，则链接将失败。
• 确保与 Workiva 连接关联的 OAuth2 授权具有适当的访问权限。
• 输入表 ID 时，请确保输入完整的 ID，并且 ID 前导或尾随没有空格。
• 检查运行时时间戳变量。这些不应该用于文件名，因为它会为每个数据集创建一个唯一的文件名——这意味着链将无法在您的表中识别任何匹配的数据集。

列映射和其他链式修改

如果在导入数据时遇到列标题问题，可以使用 数据准备 或其他命令。 

可选：标记导入的数据集

导入数据集时支持使用标签 ，但我们建议在对原始数据集进行任何更改之前，先从模板部署一组额外的链。一旦修改，除非其他表中的数据集使用相同的标签，否则该链可能很难在其他表中重复使用。  

为链添加标签：

1. 将以下运行时输入添加到从此模板部署的三个链 中的每一个 ] 中：
   • 标签键（文本字段）
   • 标签值（文本字段）
     
2. 编辑 主链 ，将运行时输入传递给每个“运行链”事件：
3. 在 替换数据集链 和 添加新数据集链中，编辑“导入新数据集”命令节点，使其接受标签运行时输入。

完成后，您导入的数据集将使用提供的标签键和标签值进行标记。

其他资源

• Workiva 连接器
• 文件实用工具连接器
• JSON 连接器
• 表格变换连接器
• 在另一个链中运行链 ("运行链事件")
• OAuth2 授权
• Wdata 功能和 API 限制