API开发文档 - 道一云

开发说明

开发说明

功能说明：根据表单数据导出接口得到对应版本的id,将id的值作为definitionId传过来，配合其它参数（其他参数将在请求数据格式定义中详细说明）获取表单填写情况的详细数据接口。
2022年10月起将停止维护此接口，请换用新接口替代

接口每天请求次数不超过1000次。
每次最多导出一个月的数据(31天)。若未根据时间参数过滤，则导出最近一个月数据。

请求方式：POST（HTTPS）
请求地址： https://qwif.do1.com.cn/qwcgi/api/apiFormExport/getFormDetails.do?token=token&corpId=corpId

请求参数说明：

data参数,已json格式传送
参数名	释义	类型	是否必须	备注
pageNO	要获取第几页信息	int	否	没有时默认为1
pageSize	每页显示数据条数	int	否	没有时默认为10，最大500
startDate	获取数据所依据的开始时间	String	否	格式yyyy-MM-dd HH:mm:ss
endDate	获取数据所依据的结束时间	String	否	格式yyyy-MM-dd HH:mm:ss
definitionId	版本id	String	是	该值为获取表单数据导出接口的id值
toSearchCommentAndAudit	是否查询评论列表和审批明细列表	boolean	否	默认false
wxUserId	提单人账号	String	否	可以根据提单人筛选详细数据
参数名	释义	类型	是否必须	备注
corpId	公司唯一标识	String	是
token	用于验证	String	是	参考获取token接口

SDK调用示例：

		FormApi api = QwSdkUtil.getInter(FormApi.class);
		// 请求参数data
		GetFormDetailsParamVO data = new GetFormDetailsParamVO();
		// 获取第几页信息（非必须）
		data.setPageNO(1);
		// 每页显示数据条数（非必须）
		data.setPageSize(10);
		// 开始时间（非必须）
		data.setStartDate("2022-06-01 00:00:00");
		// 结束时间（非必须）
		data.setEndDate("2022-06-30 00:00:00");
		// 版本id（必须）
		data.setDefinitionId("defn表单版本id");
		// 提单人账号（非必须）
		data.setWxUserId("提单人账号");
		// 是否导出评论列表和审批明细列表（非必须）
		data.setToSearchCommentAndAudit(true);
		// 调用接口
		GetFormDetailsResultVO result = api.getFormDetails(QwSdkUtil.getCacheToken(),
				// 请求参数data
				data);
		System.out.println(JSONUtil.objectToString(result));

返回结果：

{
	"maxPage": 1,
	"currentPage": 1,
	"totalRows": 2,
	"pageData": [{
		"approvers": "",
		"closePerson": "",
		"closeTime": "",
		"createaTime": "2016-07-29 13:46:32",
		"definitionId": "xxx",
		"departmentName": "道一云科技",
		"filesPath": [
			"http...",
			"http..."
		],
		"formItemDefinitionsVO": [{
				"childItemDefinitions": [{
						"childItemDefinitions": [],
						"itemKey": "xxx",
						"itemName": "图片",
						"itemType": "ImageField",
						"parentKey": "xxx",
						"valueStrs": [{
								"sort": 2,
								"valueStr": "http..."
							},
							{
								"sort": 1,
								"valueStr": "http..."
							},
							{
								"sort": 1,
								"valueStr": "http..."
							}
						]
					},
					{
						"childItemDefinitions": [],
						"itemKey": "xxx",
						"itemName": "两级下拉框",
						"itemType": "CascadeDropDown",
						"parentKey": "xxx",
						"valueStrs": [{
								"sort": 1,
								"valueStr": "选项22:二级选项22"
							},
							{
								"sort": 2,
								"valueStr": "选项1:二级选项1"
							}
						]
					},
					{
						"childItemDefinitions": [],
						"itemKey": "xxx",
						"itemName": "两级下拉框",
						"itemType": "CascadeDropDown",
						"parentKey": "xxx",
						"valueStrs": [{
								"sort": 2,
								"valueStr": "选项1:二级选项1"
							},
							{
								"sort": 1,
								"valueStr": "选项6:二级选项99"
							}
						]
					}
				],
				"itemKey": "xxx",
				"itemName": "未命名",
				"itemType": "ChildField",
				"parentKey": "",
				"valueStrs": []
			},
			{
				"childItemDefinitions": [],
				"itemKey": "xxx",
				"itemName": "图片",
				"itemType": "ImageField",
				"parentKey": "xxx",
				"valueStrs": [{
						"sort": 2,
						"valueStr": "http..."
					},
					{
						"sort": 1,
						"valueStr": "http..."
					},
					{
						"sort": 1,
						"valueStr": "http..."
					}
				]
			},
			{
				"childItemDefinitions": [],
				"itemKey": "xxx",
				"itemName": "两级下拉框",
				"itemType": "CascadeDropDown",
				"parentKey": "xxx",
				"valueStrs": [{
						"sort": 1,
						"valueStr": "选项22:二级选项22"
					},
					{
						"sort": 2,
						"valueStr": "选项1:二级选项1"
					}
				]
			},
			{
				"childItemDefinitions": [],
				"itemKey": "xxx",
				"itemName": "两级下拉框",
				"itemType": "CascadeDropDown",
				"parentKey": "xxx",
				"valueStrs": [{
						"sort": 2,
						"valueStr": "选项1:二级选项1"
					},
					{
						"sort": 1,
						"valueStr": "选项6:二级选项99"
					}
				]
			},
			{
				"childItemDefinitions": [],
				"itemKey": "fof8092da798b5400fa044511837c0d4ea",
				"itemName": "未命名",
				"itemType": "AccessoryField",
				"parentKey": "",
				"valueStrs": []
			}
		],
		"id": "xxx",
		"instanceTitle": "请填写标2",
		"isover": "2",
		"personName": "曹林杰",
		"picPaths": [
			"http..."
		],
		"versions": "1",
		"auditLogVOList": [],
		"formCommentList": [],
		"wxUserId":""
	}]
}

返回参数说明：

参数名	释义	类型	备注
totalRows	数据总条数	Int
currentPage	当前所在页数	Int
maxPage	最大页数	Int
definitionId	版本号（uuid）	String
personName	提单人	String
wxUserId	提单人账号	String
departmentName	部门	String
instanceTitle	标题	String
createaTime	提单时间	String
isover	状态	Integer	0：退审；1:已审批；2：审批中；-1：已关闭
approvers	当前处理人	String
closePerson	最后处理人	String
closeTime	最后处理时间	String
versions	对应版本（数字）	String
picPaths（集合，值为图片(常用字段图片)地址的集合，包含于pageData）
filesPath（集合，值为附件(常用字段图片)地址的集合，包含于pageData）
formItemDefinitionsVO	客户自定义字段数据	Array
FormCommentVOList	评论列表	Array	FormCommentVO：{ "commentId":.., "workOrderId":.., "content":.., "userIds":.., "creator":.., "createaTime":.., "type":.., "time":.., "ext1":.., "status":.., "userId":.., "personName":.., "headPic":.. }
auditLogVOList	审批列表	Array	分支流程： { "id":.., "versionsId":.., "refId":.., "handNodeId":.., "nextNodeId":.., "handleAccounts":.., "nodeName":.., "status":.., "auditStatus":.., "nodeType":.., "createTime":.., "updateTime":.., "creator":.., "orgId":.., "departmentId":.., "option":.., "auditUserId":.., "auditUserName":.., "auditTime":.. } 固定流程：{ "id":.., "auditId":.., "refId":.., "flowName":.., "auditStatus":.., "creator":.., "opinion":.., "nodeSoft":.., "nodeStatus":.., "personName":.., "headPic":.., "nodeName":.., "nodeType":.., "isSign":.., "nodeId":.., "handleAccounts":.., "createTime":.. } 自由流程：{ "id":.., "personName":.., "remark":.., "auditTime":.., "foreignId":.. } 有三种可能。
formItemDefinitionsVO参数说明
itemKey	字段键	String
itemName	字段名称	String
itemType	字段类型	String	ChildField表示该字段下有子字段
parentKey	父字段键	String	可通过父字段键找到子字段的父类
childItemDefinitions	子字段集合	Array
childItemDefinitions（子字段集合，其属性和formItemDefinitionsVO一样）
valueStrs	客户自定义字段值的相关情况	Array
valueStrs参数说明
valueStr	字段值	String
sort	排序号	Integer	用于区分该值对应第几个表单
otherValue	其他字段值	String

企业微信

获取填写情况详细数据（旧）

开发说明