数据推送

当表单数据的发生变更时,将操作与变更后的数据推送至您的服务器。

配置方式

1、前往 表单制作 >> 扩展功能 >> 数据推送 开启数据推送


2、填写目标服务器地址,并选择推送时间

目标服务器地址: 数据会以HTTP POST请求的形式,推送至目标服务器地址。 推送时间: 当所选择的事件发生时,数据才会被推送。


3、字段别名设置(可选),通过设置字段别名使得返回的数据更具辨识性。


  • 字段别名

Webhook数据推送中的字段名和通过api查询接口请求返回给用户的字段名为「widget+字段id」的样式,没有辨识性。通过别名的设置,使得字段名称在数据推送中更具有辨识度。数据推送、发送API请求和返回响应数据时,使用字段别名来替换字段ID


注:字段别名仅允许使用「小写字母」「数字」「下划线」组合,且必须以「小写字母」开头


- 写代码的时候参照《字段对照表及JSON样例表》。

推送内容

推送事件列表

推送事件 描述 备注
有新数据提交时推送 通过表单提交一条数据时触发 必选;不支持批量导入数据
有数据被修改时推送 修改一条数据的内容时触发,包括流程数据流转、普通表单修改数据、管理员修改数据等 可选;不支持批量修改
有数据被删除时推送 删除一条数据时触发 可选;不支持批量删除
有数据被恢复时推送 恢复一条数据时触发 可选;不支持批量恢复

数据结构定义如下:

参数 说明
op 推送事件;包括data_create(数据提交)、data_update(数据修改)、data_remove(数据删除)、data_recover(数据恢复)
data 具体数据内容

新数据提交 / 数据修改 / 数据恢复

可展开数据推送配置界面的字段对照表及JSON样例参考当前表单推送数据的格式及内容。

表单字段类型与数据类型对照表 ↓↓

字段类型 数据类型 备注
单行文本 string
多行文本 string
流水号 string
数字 number
日期时间 string
单选按钮组 string
复选框组 array
下拉框 string
下拉复选框 array
分割线 不推送
地址 json
定位 json
图片 array 推送数据中包含的url为图片链接,7天内有效
附件 array 推送数据中包含的url为附件链接,7天内有效
手写签名 json 推送数据中包含的url为手写签名的图片链接,7天内有效
子表单 array
关联查询 不推送
关联数据 json
成员单选 json
成员多选 array
部门单选 json
部门多选 array
手机 json
流程状态(仅流程表单) number 2表示流程手动结束;1表示流程已完成; 0表示流程进行中

数据删除

字段 字段类型 说明
formName String 表单名称
_id String 删除数据的ID
deleter json 删除操作执行人
deleteTime String 删除时间

注意事项

当失败记录数量达到100条时,该表单的数据推送功能将被关闭,管理会获得消息通知,管理员需要在数据推送设置中重新启动数据推送,数据推送才会继续推送。管理员可以选择重新推送失败缓存里的数据,也可以放弃缓存

推送日志

应用管理 >> 扩展功能 >> 数据推送 >> 推送日志

推送日志里仅保留近六个月的推送记录;支持根据推送失败、推送成功、全部日志去筛选查询推送记录。

推送日志里记录了每条推送记录的时间、地址、结果,当推送失败了还可以查看推送详情。

点击推送详情的「查看详情」可以看到推送失败的具体详情。

服务器连接测试

当我们在进行服务器连接测试的时候,如果推送失败,也可以看到推送失败的详情。

Peach是此帮助页面的作者。如果您对此页面的内容有任何意见,请在下方给她反馈。如需获取即时帮助,请联系技术支持。
本文是否对您有帮助?