表单流程动态数据源接口
开发说明
功能说明：表单流程作为客户端，外部系统（链接地址）作为服务端。表单流程从该地址获取数据，以数据源字段设置的类型展示。用户填单时即可选择表单流程实时获取到的外部系统数据。
外部系统地址为用户设置数据源字段时填写的链接地址，链接地址需满足以下三个条件：
1、是互联网可访问的外部系统地址（用户提供）
2、正确地返回数组形式Json数据
3、使用POST（HTTP/HTTPS））
请求方式：POST（HTTP/HTTPS）
请求地址：https://qy.do1.com.cn/qwy/open/openForm/testDatasource.do(外部系统示例链接，仅做示范)
|
参数名 |
释义 |
类型 |
是否必须 |
备注 |
|---|---|---|---|---|
|
corpId |
公司唯一标识 |
String |
是 |
|
|
id |
fo字段id |
String |
是 |
参考“获取字段信息”接口，formField._id |
| timestamp | 时间戳 |
String |
是 |
传递从北京时间1970年1月1日上午八点整到现在的毫秒数，用于校验消息的及时性 |
|
wxUserId |
填单人用户账号 |
String |
否 |
提单人的用户账号，可用于数据权限控制，为空时为管理员访问 |
|
page |
页码 |
Integer |
是 |
分页设置项，默认为1，用户下拉加载时，页码将递增直到返回数据为空。 |
|
pageSize |
分页大小 |
Integer |
是 |
分页显示记录数。 |
|
ids |
数据id |
String |
否 |
按数据id查询，可同时传递多个 |
|
keyword |
关键字 |
String |
否 |
用户在搜索框输入关键字时传递 |
|
keywordType |
关键字类型 |
String |
否 |
关键字类型，根据管理后台设置的字段传递，为空且关键字不为空表示全范围搜索 |
| {字段键值}_eq |
数据源查询条件值 |
String |
否 | 参数名为直接在被查询字段键值后拼接“_eq”表示等值条件筛选 |
示例
如果数据源字段链接地址填写为“https://qy.do1.com.cn/qwy/open/openForm/testDatasource.do”
则填单时云平台通过以下地址获取外部系统数据：
https://qy.do1.com.cn/qwy/open/openForm/testDatasource.do?wxUserId=zhangsan&corpId=wx05ab253814890c89&id=foeb3acb3157af4a4e8610ddb184863af5&page=1&pageSize=50
再以数据源字段设置的类型来展示从外部系统获取到的数据。
1、当类型为：单选、下拉框、多选[默认最多加载50项]
https://qy.do1.com.cn/qwy/open/openForm/testDatasource.do？wxUserId=zhangsan&corpId=wx05ab253814890c89&id=foeb3acb3157af4a4e8610ddb184863af5&page=1&pageSize=50
设置界面:
预览页面：
参考报文
[
{
"id": 110000,
"letter": "B",
"name": "北京市",
"parentid": 100000,
"pinyin": "Beijing",
"shortname": "北京"
},
……
]
2、当类型为：多级联动[默认最多加载50项]
https://qy.do1.com.cn/qwy/open/openForm/testDatasource.do？wxUserId=zhangsan&corpId=wx05ab253814890c89&id=fo47dda5b4817548979fd2796b57eafae3&page=1&pageSize=50&keywordType=parentid&keyword=130000
说明：parentid为关联主键 130000为上级下拉框的主键
设置界面:
预览页面:
参考报文
[
{
"citycode": "0351",
"id": 140100,
"letter": "T",
"name": "太原市",
"parentid": 140000,
"pinyin": "Taiyuan",
"shortname": "太原"
},
……
]
3、当类型为：数据源
https://www.domain.com.cn/dynamic_data_source?wxUserId=&corpId=&id=fobbc62da14f80481e8644d61a5988a5a2&page=1&pageSize=10&
keyword=北&keywordType=name
说明：name为搜索类型对应的字段键值 北为搜索框的关键字
设置界面:
预览页面:
参考报文
[
{
"id": 110000,
"letter": "B",
"name": "北京市",
"parentid": 100000,
"pinyin": "Beijing",
"shortname": "北京"
},
……
]
4、过滤字段值
https://www.domain.com.cn/dynamic_data_source?wxUserId=&corpId=&id=fobbc62da14f80481e8644d61a5988a5a2&page=1&pageSize=10&
name_eq=单行文字填写值
说明：name为数据源被查询内容（即字段键值） ，拼接上“_eq”即为等值过滤参数
刷新数据源
https://www.domain.com.cn/dynamic_data_source?corpId=wx07ad350b0dfd7747&id=fo855bbe3d8db345a0aede3753843a0880&page=1&pageSize=23&ids=10000&ids=120223
说明： 100000和120223为明细中存在的主键
[
{
"id": 100000,
"letter": "C",
"name": "中国",
"parentid": 0,
"pinyin": "China",
"shortname": "中国"
},
……
]
[{
"citycode": "",
"id": 100000,
"letter": "C",
"name": "中华人民共和国",
"parentid": 0,
"pinyin": "China",
"shortname": "中国"
}, {
"citycode": "",
"id": 110000,
"letter": "B",
"name": "北京市",
"parentid": 100000,
"pinyin": "Beijing",
"shortname": "北京"
}{
"citycode": "010",
"id": 110101,
"letter": "D",
"name": "东城区",
"parentid": 110100,
"pinyin": "Dongcheng",
"shortname": "东城"
}]