目錄:
1. 概述编辑
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.0.20 | 新增简道云输出算子，可将数据输出到简道云中，供简道云使用 |
1.2 应用场景
用户使用 FineReport 填报数据到数据库，希望使用 FDL 将填报进数据库中的数据推送给简道云。
用户有多套业务系统，在其他系统维护好的主数据希望能增量同步到简道云表单，供简道云使用。
用户在做简道云流程表单时，很多字段需要从业务系统里面取数作为值来进行选择。
1.3 功能简介
新增「简道云输出」算子：
FDL 中数据经过一系列处理后，可将处理后的数据，输出到简道云表单中。
与「数据比对」算子配合使用，将简道云表单中的数据与其他来源的数据进行对比，将数据变动更新到简道云表单中。
2. 支持的控件类型编辑
简道云表单中包含以下控件类型时，「简道云输出」算子支持将数据输入到指定表单中：
| 分类 | 控件类型 |
|---|---|
| 基础字段 | 单行文本 |
| 多行文本 | |
| 数字 | |
| 日期时间 | |
| 单选按钮组 | |
| 下拉框 | |
| 增强字段 | 子表单 |
| 手机 | |
| 部门成员字段 | 成员单选 |
| 部门单选 |
3. 示例编辑
3.1 场景模拟
数据库中的「项目报名表」保存着全量且最新数据，需要将「项目报名表」中的数据同步到简道云表单中。
现数据库表中删除「李文」的数据，新增「张涵」的数据，修改「王博」的数据，希望将数据变化同步到简道云表单中。如下图所示：
3.2 简道云表单字段处理
在简道云表单接入前，可提前设置字段别名，否则接入到 FineDataLink 中时会使用字段原始名，不便于你的业务处理。
进入简道云应用，进入需要使用表单的编辑界面，选择「数据推送>扩展功能>设置字段别名」，如下图所示：
3.3 新建定时任务
新建定时任务，拖入「数据转换」节点。如下图所示：
3.4 数据输入
1）进入「数据转换」节点，拖入「DB表输入」算子，取出存放到数据库的「项目报名表」数据。如下图所示：
2）新增「简道云输入」算子，取出简道云数据。如下图所示：
点击「数据预览」，information 字段包含项目、课时金额、数量、小计、折后金额字段，需要对该字段解析（本文 2.5 节内容），方便后续与「DB表输入」算子中的数据进行比对。
3.5 解析简道云字段
1）添加「JSON解析」算子，与「简道云输入」算子相连。
2）解析 information 字段，勾选「解析后保留所有上游输出字段」，若不勾选该按钮，则只有 information 字段解析后的数据，但本示例不只是对比 information 中包含的字段，还要对比其他字段。如下图所示：
3.6 数据比对
1）添加「数据比对」算子，与「DB表输入」算子和「JSON解析」算子相连。如下图所示：
2）对比数据库表数据和简道云数据。如下图所示：
设置项说明如下表所示：
| 设置项 | 说明 |
|---|---|
| 比对表返回字段 | 「数据比对」算子的返回值只包括原始表的字段（本例中的 DB表输入）和比对结果 fdl_comparison_type 字段，而无法获得比对表的字段（本例中的简道云输入），而本例中简道云输入中的 _id 字段是上云过程中必须的字段，所以比对表返回字段需要设置为 _id 注：遇到同名字段时，比对表返回字段下拉时对重名字段名后缀自动加1，格式为：column1、column2、column3，重名新增后缀的逻辑同数据关联算子 |
3.7 输出输出到简道云
1）添加「简道云输出」算子，与「数据比对」算子相连。
2）设置简道云输出。如下图所示：
各设置项介绍如下表所示：
| 设置项 | 备注 |
|---|---|
| 数据连接 | 下拉展示所有数据源类型为简道云的数据连接 |
| 简道云应用 | 下拉展示数据连接中包含的简道云应用 |
| 应用表单 | 下拉展示对应应用下所有简道云表单 |
| 写入方式 | 有两种写入方式：
注：写入方式「清空目标表，再写入数据」灰化，不可选择 插入/更新/删除数据详细说明：
|
| 标识字段&标识值 | 仅写入方式为「插入/更新/删除数据」可见
具体可参见：数据比对 |
| 逻辑主键 | 仅勾选更新或删除时出现此选项，不允许为空，用户可从数据流内自行选择字段，默认选择数据流内字段名为 _id 的字段 |
| 高级设置 | 提供「触发智能助手」、「发起流程（仅流程表单写入支持）」选项，复选框，默认不选 |
3）点击「字段映射」，配置目标表字段。如下图所示：
「目标表字段」设置说明：
1）目标表字段为下拉单选项，选择简道云表单返回的所有字段，选项为字段名，即widgets[].name，包括子表单字段。
子表单字段的展现形式为子表单widget名.子表单字段名
2）目标表字段对应的控件类型，即简道云表单接口返回的widgets[].type，子表单字段的展现形式为子表单.子表单字段type
注：仅支持在映射表内配置一个子表单。若目标表单内有多个子表单对象，映射表内只配置一个子表单是允许的。
3.8 运行任务
保存并运行任务。
可看到简道云表单中删除了「李文」的数据，新增「张涵」的数据，修改「王博」的数据。如下图所示：
