玩转搭贝
表单管理
表单设计
流程设计
流程设计
流程常见问题
仪表盘
基础图表
自定义组件
常见问题FAQ
列表相关FAQ
业务规则FAQ
数据导入FAQ
更新日志
场景解决方案
人事/绩效
行政/资产
销售/客户
项目/任务/工单
物业/园区
进销存/仓储
商管/租赁
法律业务
行业解决方案
制造业/工业生产
- 搭贝学院
- 表单设置
- 数据推送
数据推送
发布人：爱搭贝
更新时间：2026-05-18
1. 简介
当表单数据的发生变化时，数据推送可将变化后的数据推送至您的服务器。
2. 操作步骤
2.1 设置入口
选择数据所在表单，点击表单名称的小齿轮移动到「表单设置」，选择「数据推送」，进入数据推送设置中。
 |
|---|
2.2 点击新建推送
 |
|---|
2.3 配置方法
数据推送的配置如下：
 |
|---|
1）规则名称：填写规则名称。(必填)
2）推送URL：数据会以 HTTP POST 请求的形式，推送至目标服务器地址。(需联系平台配置ip白名单)
3）触发动作：
| 推送事件 | 事件描述 | 备注 |
|---|---|---|
| 新增数据 | 提交表单数据时触发 | 可选 |
| 修改数据 | 修改表单数据时触发，包括流程数据流转、修改表单数据等 | 可选 |
| 删除数据 | 删除表单数据时触发 | 可选 |
| 自定义事件 | 配置了表单按钮、列表按钮点击时触发 | 可选 |
4）设置字段别名：
发送 API 请求推送时需设置推送字段别名来替换字段名称。
 |
|---|
5）设置自定义主表的推送字段名：
 |
|---|
6）设置自定义明细表的推送字段名：
 |
|---|
7）字段对照表：
| 字段类型 | 数据类型 | 备注 |
|---|---|---|
| 单行文本 | string | "冬虫夏草" |
| 多行文本 | string | "1.改善慢性肾衰竭 2.改善胃病 3.改善睡眠" |
| 流水号 | string | 表单新增流水号组件时，历史数据无流水号 |
| 数字 | number | 10000.20 |
| 日期时间 | long(时间戳) | 1720444901945 |
| 单选框 | json字符串 | "[\"选项一\"]" |
| 复选框 | json字符串 | "[\"选项一\",\"选项二\"]" |
| 下拉框 | json字符串 | "[\"下拉一\"]" |
| 下拉框多选 | json字符串 | "[\"下拉一\",\"下拉二\"]" |
| 分割线 | 无 | 不推送 |
| 地址 | 字符串 | 北京市市辖区朝阳区朝阳区政府旁 |
| 定位 | json字符串 | "{\"address\":\"南部\",\"latitude\":36.68,\"longitude\":117.15}" |
| 图片 | json字符串 | "[{\"name\":\"7.jpg\",\"url\":\"https://idabei.com/1000017.jpg\"}]" |
| 附件 | json字符串 | "[{\"name\":\"8.txt\",\"url\":\"https://idabei.com/1000017.txt\"}]" |
| 手写签名 | 无 | 不推送 |
| 关联表单 | string | "药物品类"(根据引用的字段类型来确定组件的最终的值) |
| 关联多选 | json字符串 | "[{\"value\":\"牙膏\",\"id\":\"11\"},{\"value\":\"牙刷\",\"id\":\"12\"}]" |
| 富文本 | string | "<p>冬虫夏草是一种名贵的中草药。</p>" |
| 人员单选 | json字符串 | "[{\"id\":\"7\",\"name\":\"尧\"}]" |
| 人员多选 | json字符串 | "[{\"name\":\"舜\",\"id\":\"11\"},{\"name\":\"娲\",\"id\":\"12\"}]" |
| 部门单选 | json字符串 | "[{\"id\":\"13\",\"name\":\"工部\"}]" |
| 部门多选 | json字符串 | "[{\"name\":\"户部\",\"id\":\"14\"},{\"name\":\"礼部\",\"id\":\"15\"}]" |
| 机构单选 | json字符串 | "[{\"id\":\"9\",\"name\":\"夏\"}]" |
| 机构多选 | json字符串 | "[{\"name\":\"虞\",\"id\":\"8\"},{\"name\":\"秦\",\"id\":\"6\"}]" |
| 创建时间 | long(时间戳) | 1720443835017 |
| 修改时间 | long(时间戳) | 1720443835022 |
| 汇总 | number | 300.30 |
| 金额大写 | string | "叁拾叁元整" |
| 数据状态 | number | sys_status 对应的逻辑:0 删除 1 正常 |
| 明细表 | array | children_goods:自定义明细表名称 |
8）JSON样例：
json对照，单行文本-> 中文拼音（danhang）
{
"children_goods": [{
"danghang": "速运",
"fujian": "[{\"url\":\"https://siwei-ding.oss-cn-zhangjiakou.aliyuncs.com/01.jpg\",\"size\":\"287.62KB\",\"mediaId\":\"757b8b12e04c4ed0905f67a2a2566cf3\",\"actualSize\":294527}]",
"shuzi": 33,
"pid": "a8bfc44b8507455b8a163076462541ae",
"xialadanxuan": "[\"选项三\"]",
"dizhi": "北京市市辖区丰台区丰台实验学校旁",
"id": "f7aaaebd362947eead1dcc6ad6a4e1e2",
"tupian": "[{\"url\":\"https://siwei-ding.oss-cn-zhangjiakou.aliyuncs.com/02.jpg\",\"name\":\"Screenshot_20240624_205553_com.taobao.taobao.jpg\",\"size\":\"543.75KB\",\"mediaId\":\"3bc2ce3dc6cf4241ac842fdc9323ece4\",\"actualSize\":556801}]",
"riqi": 1720368000000
}],
"goods": {
"danxuan": "[\"选项一\"]",
"bumendanxuan": "[{\"id\":\"810976a67c61458dbd0342c59423d543\",\"name\":\"研发部1\"}]",
"duoxuan": "[\"选项二\",\"选项一\"]",
"huizong": 33,
"dingwei": "{\"address\":\"山东省济南市历下区舜华路街道\",\"latitude\":36.689863,\"longitude\":117.150801}",
"renyuandanxuan": "[{\"id\":\"b7444b6dd6df439da7d187e5cf4df2a3\",\"name\":\"gzq\"}]",
"renyuanduoxuan": "[{\"id\":\"b7444b6dd6df439da7d187e5cf4df2a3\",\"name\":\"gzq\"},{\"id\":\"fddbb9137e3741699889294f51dc61f9\",\"name\":\"gzq2\"}]",
"fujian": "[{\"url\":\"https://siwei-ding.oss-cn-zhangjiakou.aliyuncs.com/03.jpg\",\"size\":\"818.31KB\",\"mediaId\":\"7a0d25671c0944b0a51d469146c74117\",\"actualSize\":837959}]",
"fuxuan": "[\"选项一\",\"选项二\"]",
"bumenduoxuan": "[{\"id\":\"810976a67c61458dbd0342c59423d543\",\"name\":\"研发部1\"}]",
"jigouduoxuan": "[{\"id\":\"a3b5708ae3854c568c6e8c8bd67797f2\",\"name\":\"山东思为\"},{\"id\":\"0f2833cd7c3f439eabcff1d3c2762002\",\"name\":\"研发部\"}]",
"duohang": "1.改善慢性肾衰竭\n2.改善胃病\n3.改善睡眠",
"xiugaishijian": 1720443835016,
"guanlianbiaodan": "2.0",
"kaiguan": 1,
"guanlianduoxuan": "[{\"value\":\"风寒颗粒\",\"id\":\"0a27a6955389452191524a47c67c9984\"},{\"value\":\"咳嗽糖浆\",\"id\":\"189bc53b0b184b46ab08b90ac476e414\"}]",
"create": "532e3d95ddf74befad0117edbcf56daa",
"id": "a8bfc44b8507455b8a163076462541ae",
"dizhi": "北京市市辖区朝阳区朝阳区政府旁",
"jinedaxie": "叁拾叁元整",
"liushuihao": "202400001",
"shuzi": 10000,
"tupian": "[{\"url\":\"https://siwei-ding.oss-cn-zhangjiakou.aliyuncs.com/04.jpg\",\"size\":\"1.14MB\",\"mediaId\":\"95a3158b21404002aba6fc52b9ff8032\",\"actualSize\":1195537}]",
"jigoudanxuan": "[{\"id\":\"0f2833cd7c3f439eabcff1d3c2762002\",\"name\":\"研发部\"}]",
"createTime": 1720443835017,
"shujuzhuantai": "1",
"danhang": "冬虫夏草",
"riqi": 1720368000000,
"fuwenben": "<p>冬虫夏草是一种名贵的中草药。</p>"
}
}3. 代码示例
提供了一些java语言版本的代码样例，仅供参考：
本篇目录
{{ dl1.name }}
{{ dl2.name }}
{{ dl3.name }}