简道云输出示例

「简道云输出」算子的功能已在 简道云输出文档 中详细介绍，本文将通过两个示例介绍该算子的使用方法：

• 示例一：简道云表单中不包含部门成员字段。

• 示例二：简道云表单中包含部门成员字段。

FineDataLink 中的数据处理过程，详情参见：https://demo.finedatalink.com/ 「简道云输出-没有部门成员-」、「简道云输出-有部门成员-」。

2.1 场景模拟

数据库中的「库存信息」表保存着全量且最新数据，需要将「库存信息」表中的数据同步到简道云表单中。

现数据库表中删除「产品ID」为 77 的数据，新增「产品ID」为 78 的数据，修改「产品ID」为 76 的「库存量」数据，希望将数据变化同步到简道云表单中。如下图所示：

示例数据：库存信息.xls、简道云表单

注：用户按照文档步骤做示例时，「库存信息」所在的数据库、「简道云表单」所在的应用，后续步骤中请根据实际情况填写。

2.2 简道云表单字段处理

在简道云表单接入前，可提前设置字段别名，否则接入到 FineDataLink 中时会使用字段原始名，不便于在 FineDataLink 中进行业务处理。

进入简道云应用，进入需要使用表单的编辑界面，选择「扩展功能>数据推送>设置字段别名」。如下图所示：

2.3 新建定时任务

新建定时任务，拖入「数据转换」节点。如下图所示：

2.4 数据输入

1）进入「数据转换」节点，拖入「DB表输入」算子，取出存放到数据库的「库存信息」数据。如下图所示：

2）新增「简道云输入」算子，取出表单数据。如下图所示：

2.5 数据比对

1）添加「数据比对」算子，与「DB表输入」算子和「简道云输入」算子相连。如下图所示：

2）对比数据库表数据和简道云数据。

逻辑主键：由于两张表中可以通过「产品ID」字段进行关联，所以选择「产品ID」作为逻辑主键，用于在两张表中识别同一条数据。

比对字段：用于对比两张表中该字段的差异，若某字段不被选择到比对字段中，若该字段存在更新，将不能被识别并筛选出来。

标识关系：默认即可，可自定义，用于标记数据变化。

比对表返回字段：「数据比对」算子的返回值只包括原始表的字段（本例中的 DB表输入）和比对结果 fdl_comparison_type 字段，而无法获得比对表的字段（本例中的简道云输入），而本例中简道云输入中的 _id 字段是上云过程中必须的字段，所以比对表返回字段需要设置为 _id 。

注：遇到同名字段时，比对表返回字段下拉时对重名字段名后缀自动加1，格式为：column1、column2、column3，重名新增后缀的逻辑同数据关联算子

2.6 输出到简道云

具体介绍请参见：简道云输出算子

1）添加「简道云输出」算子，与「数据比对」算子相连。

2）设置简道云输出。

数据连接/简道云应用/应用表单：此处选择数据要输出到的简道云表单。「数据连接」下拉框中只展示已配置过数据连接且当前用户有数据连接使用权限的选项。

写入方式：此处选择「插入/更新/删除数据」。

标识字段/标识值：标识字段选择 fdl_comparison_type ，fdl_comparison_type 是默认生成的标记列；「标识值」需要与「数据比对」算子中的「标识关系」值一一对应。

逻辑主键：选择 _id 

3）点击「字段映射」，配置目标表字段。如下图所示：

2.7 结果展示

保存并运行任务。

可看到简道云表单中删除「产品ID」为 77 的数据，新增「产品ID」为 78 的数据，修改「产品ID」为 76 的「库存量」数据。如下图所示：

3.1 场景模拟

公司之前手动在 Excel 表中录入公司电脑借用信息，现在使用简道云表单进行录入。为了实现信息的同步，需要将之前在 Excel 表中录入的信息导入到简道云表单中。

Excel 表信息如下图所示：

简道云表单样式如下图所示：

3.2 准备工作

3.2.1 简道云表单字段处理

参考本文 2.2 节步骤，设置简道云表单的字段名如下图所示：

3.2.2 准备包含简道云部门ID和成员编号的表

简道云表单中包含「成员单选」、「部门单选」控件时，要同步的数据与简道云表单的字段映射关系如下表所示：

注：username、dept_no 具体介绍请参见：通讯录接口

因此，待同步的数据中需要包含username（成员编号）、dept_no（部门编号）信息，才能成功同步到包含「成员单选」、「部门单选」控件的简道云表单中。

本文示例中，包含简道云部门编号、成员编号的表信息如下图所示：

3.3 新建定时任务

新建定时任务，拖入「数据转换」节点。如下图所示：

3.4 数据输入

进入「数据转换」节点，拖入「DB表输入」算子，取出存放到数据库的「公司电脑借用」数据。如下图所示：

再拖入一个「DB表输入」算子，取出简道云部门编号、成员编号的数据。如下图所示：

3.5 设置数据关联

添加「数据关联」算子，将「公司电脑借用」数据与简道云部门编号、成员编号的数据关联起来。如下图所示：

点击「数据预览」，关联后的数据如下图所示：

3.6 删除不需要字段

拖入「字段设置」算子，删除部门、成员、name、name1 字段。如下图所示：

数据预览如下图所示：

3.7 简道云输出

1）拖入「简道云输出」算子，将「公司电脑借用」数据输出到简道云表单中。如下图所示：

2）设置字段映射关系，其中，dept_no 对应简道云表单中的 department（部门）字段，username 对应简道云表单中的 member（成员）字段。如下图所示：

3.8 结果展示

保存并运行任务。

简道云表单数据如下图所示：