开发前必读
概述
开发者使用指南
开发者使用流程
通信说明
开发者工具
更新日志
基础能力接口
获取token接口
外部系统单点登录
单点登录使用说明
获取单点登录用户信息
通讯录管理
获取部门列表
新增部门
修改部门
删除部门
新增用户
修改用户
删除用户
获取用户列表
通讯录变更同步
获取标签信息
新增标签
修改标签
删除标签
获取标签成员列表
添加标签成员
删除标签成员
按部门查询标签
按用户查询标签
离职用户
获取离职信息
用户复职
获取自定列表信息
第三方消息推送
推送文本消息
推送图文消息
推送消息附录
统一消息推送(回调)
图片附件上传
图片附件下载
图片附件单个下载
图片附件批量下载
应用数据接口
表单流程/七巧
新增表单
获取表单模板信息
推送数据
修改表单数据
删除表单数据
数据源
数据回调
导出表单流程数据
获取填写情况详细数据(新)
通过ID获取填写详细数据(新)
流程干预
获取填写情况详细数据(旧)
通过ID获取填写详细数据(旧)
获取应用填写详细数据(待办、已办等)
发票识别接口
发票验真接口
附录
考勤打卡
获取考勤规则列表
获取考勤详细信息
获取考勤日报信息
注册考勤服务
新增虚拟考勤机
删除虚拟考勤机
考勤机打卡
获取考勤排班明细
获取考勤异常申诉记录
请假出差
获取请假信息列表
获取请假类型列表
假期管理
获取请假详情信息
新闻公告
获取新闻动态类型
新增新闻动态
获取新闻列表
获取新闻详情
获取个人新闻列表
费控报销
获取报销信息列表
获取成本中心信息列表
导入成本中心
获取预算明细
获取发票信息列表
获取借款信息列表
获取用户可见范围内成本中心
获取用户可见范围内科目
获取超额预算
费控预算操作
企业用车
获取车辆申请列表
任务分派
获取任务分派信息列表
获取任务类型信息接口
新建任务接口
移动CRM
获取客户信息列表
获取客户字段
新增客户
更新客户
获取客户详情
获取客户类别
获取所有公海池
获取所有行业信息
获取联系人信息列表
获取联系人字段
新增联系人
更新联系人
获取联系人详情
获取商机信息列表
获取商机字段
新增商机
更新商机
获取商机详情
获取商机阶段或商机类型
修改商机阶段
获取拜访信息列表
获取合同信息列表
获取合同字段
新增合同
更新合同
获取合同详情
获取公海池客户信息列表
获取公海池客户详情
培训考试
获取考试成绩列表
获取考试统计信息列表
获取考试人员明细
获取学习统计信息列表
获取个人学习档案信息列表
获取课程统计信息列表
获取课程人员明细
获取个人学分明细
获取讲师信息列表
获取题库试题明细
新增题库试题
删除题库试题
移动外勤
获取签到信息列表
会议管家
获取会议详情
获取会议纪要详情
获取会议室详情
获取区域列表
获取会议室列表
获取会议详情列表

表单流程动态数据源接口

开发说明

功能说明:表单流程作为客户端,外部系统(链接地址)作为服务端。表单流程从该地址获取数据,以数据源字段设置的类型展示。用户填单时即可选择表单流程实时获取到的外部系统数据。

外部系统地址为用户设置数据源字段时填写的链接地址,链接地址需满足以下三个条件:
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


说明: 100000120223为明细中存在的主键

[

      {

        "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": "东城"
}]