历史版本3 :数据接收-简道云表单推送(Beta) 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:
icon提示:
产品注册版本为「v5.0共创版时,才能使用简道云数据接收功能;如需试用或者了解详细信息,请联系技术支持(技术支持联系方式:前往「服务」,选择「在线支持」、电话「400-811-8890」)。

目录:

1. 概述编辑

1.1 版本

FineDataLink 版本功能变动
5.0.1.4数据服务功能可实时接收简道云推送的数据,解析后写入数据库

1.2 应用场景

用户使用 简道云输入 算子将表单数据落库,为确保数据时效性给定时任务设置了分钟级的执行频率,但由于简道云表单数据并非频繁更新,导致定时任务出现无效执行的情况。

用户希望仅在表单数据发生变更时才触发数据同步,避免无意义的任务执行。

1.3 功能简介

数据服务模块提供简道云数据接收功能,当简道云表单数据变化后,可通过已发布的数据接收接口,将表单数据实时同步到数据库中。如下图所示:

1.4 前提条件

1)需要注册高阶数据源 - 应用系统(实时)功能点。

2)简道云和 FineDataLink 工程需要能互相连通。

3)需要配置一个简道云数据连接

2. 示例编辑

2.1 场景模拟

「报名表」表单中包含子表单,现希望仅在表单数据发生变更时,触发数据同步,同步到数据库表中。表单数据如下图所示:

14.png

2.2 简道云表单准备

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

10.png

2)建议为简道云表单设置字段别名,否则接入到 FineDataLink 中时会使用字段原始名,不便于在 FineDataLink 中进行业务处理。详情请参见:设置字段别名

2.3 新建简道云数据接收 API

1)进入 FDL 工程,点击「数据服务,新建一个数据接收 API 。如下图所示:

12.png

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

13.png

2.4 设置数据来源

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

1753260293729084.png

2)若简道云表单包含子表单,新增「子表单处理设置项,可选择:以字段输出、以子表输出。

2.4.1 以字段输出

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

1753260522568235.png

该界面中,支持删除字段;其中不支持删除主表 id 字段。

2)点击右上角的「解析预览按钮,可发现子表数据以 JSON 格式保存在 information 字段中。如下图所示:

17.png

2.4.2 以子表输出

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

1753260757161699.png

该界面中,支持删除字段。其中:

  • 主表中:不支持删除主表 id 字段。

  • 子表中:不支持删除子表 id字段,不支持删除主表 pid 字段。

2)可发现子表数据单独输出,后续可单独输出到一张目标表中。如下图所示:

1753260856830172.png

2.4.3 解析结果说明

选择待下云表单后,界面如下图所示:

1753263060849002.png

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

1753263205381918.png

2.5 数据去向

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

23.png

2.5.1 目标表为自动建表

1)点击「新建目标表

2.5.2 目标表为已存在表

2.6 高级配置