1. 概述编辑
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 5.0.1.4 | 数据服务功能可实时接收简道云推送的数据,解析后写入数据库 |
1.2 应用场景
用户使用 简道云输入 算子将表单数据落库,为确保数据时效性给定时任务设置了分钟级的执行频率,但由于简道云表单数据并非频繁更新,导致定时任务出现无效执行的情况。
用户希望仅在表单数据发生变更时才触发数据同步,避免无意义的任务执行。
1.3 功能简介
数据服务模块提供简道云数据接收功能,当简道云表单数据变化后,可通过已发布的数据接收接口,将表单数据实时同步到数据库中。如下图所示:
1.4 前提条件
1)需要注册高阶数据源 - 应用系统(实时)功能点。
2)简道云和 FineDataLink 工程需要能互相连通。
3)需要配置一个简道云数据连接
2. 示例编辑
2.1 场景模拟
「报名表」表单中包含子表单,现希望仅在表单数据发生变更时,触发数据同步,同步到数据库表中。表单数据如下图所示:

2.2 简道云表单准备
1)打开需要下云的简道云表单,点击「扩展功能>数据推送>新建数据推送」,输入 FineDataLink 工程地址后,设置推送事件,点击「保存」按钮即可。如下图所示:

2)建议为简道云表单设置字段别名,否则接入到 FineDataLink 中时会使用字段原始名,不便于在 FineDataLink 中进行业务处理。详情请参见:设置字段别名
2.3 新建简道云数据接收 API
1)进入 FDL 工程,点击「数据服务」,新建一个数据接收 API 。如下图所示:

2)接收方式选择「简道云表单推送」。如下图所示:

2.4 设置数据来源
1)点击「来源简道云解析」右侧的「配置」按钮,选择待下云的简道云表单。如下图所示:

2)若简道云表单包含子表单,新增「子表单处理」设置项,可选择:以字段输出、以子表输出。
2.4.1 以字段输出
1)若选择子表以字段输出,点击「下一步」按钮后,界面如下图所示:

该界面中,支持删除字段;其中不支持删除主表 id 字段。
2)点击右上角的「解析预览」按钮,可发现子表数据以 JSON 格式保存在 information 字段中。如下图所示:

2.4.2 以子表输出
1)若选择子表以子表输出,点击「下一步」按钮后,界面如下图所示:

该界面中,支持删除字段。其中:
主表中:不支持删除主表 id 字段。
子表中:不支持删除子表 id字段,不支持删除主表 pid 字段。
2)可发现子表数据单独输出,后续可单独输出到一张目标表中。如下图所示:

2.4.3 解析结果说明
选择待下云表单后,界面如下图所示:

点击「编辑」按钮,自动进入第二步「解析生成字段」界面。如下图所示:

2.5 数据去向
选择目标数据库后,界面如下图所示:

2.5.1 目标表为自动建表
1)点击「新建目标表」,
2.5.2 目标表为已存在表
2.6 高级配置


提示: