API开发文档 - 道一云

开发说明

开发说明

功能说明：获取到任务分派信息列表
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/taskApiCtl/getTaskInfo.do?token=token&corpId=corpId

请求包体：

{
	"currentPage":"1",
	"endTime":"2016-06-01",
	"pageSize":"1",
	"startTimes":"2016-05-01"
}

请求参数说明：

参数	说明	类型	是否必须	备注
token	用于验证	String	是
corpId	公司唯一标识	String	是
startTimes	创建时间上限	String	是	格式必须为:yyy-MM-dd
endTime	创建时间下限	String	是	创建时间间隔不的超过两个月
currentPage	查询页码	String	是	必须是正整数,如果超过最大页,当前页默认为最大页
pageSize	分页大小	String	否	默认为100,并且不超过1000

SDK调用示例：

		TaskListVO taskListVO = new TaskListVO();
		// 设置查询的创建时间，格式必须为:yyyy-MM-dd，创建时间间隔不的超过两个月
		taskListVO.setStartTimes("2019-01-01");
		taskListVO.setEndTime("2019-01-31");
		// 设置查询页码，必须是正整数，如果超过最大页数,会默认为最大页数
		taskListVO.setCurrentPage("1");
		// 分页大小，即每次获取的数据条数， 默认为100,并且不超过1000
		taskListVO.setPageSize("10");
		TaskApi taskApi = QwSdkUtil.getInter(TaskApi.class);
		ApiTaskGetTaskInfoResultVO resultVO = taskApi.getTaskInfo(
				QwSdkUtil.getCacheToken(), taskListVO);
		System.out.println(JSONUtil.stringify(resultVO));

返回结果：

{
	"currPage":1,
	"maxPage":1,
	"pageData":
	[
		{
			"accessAddress":"北京市",
			"allSubtaskCount":"1",
			"closeReason":"任务已完成",
			"closeTime":"2019-02-27 09:18:45",
			"closer":"cbbf7e9ab38549d3822476feabefdec2",
			"closerName":"企小微",
			"commentList":
			[
				{
					"commentStatus":"4",
					"content":"@所有人 完成了任务，任务已完成，这就是原因",
					"creator":"cbbf7e9ab38549d3822476feabefdec2",
					"creatorTime":"2019-02-27 09:18:45",
					"personName":"企小微",
					"taskId":"415f00ba-b06f-485b-afd5-224e453ba298"
				}

			],
			"content":"任务内容示例",
			"createTime":"2019-02-25 15:55:24",
			"creator":"cbbf7e9ab38549d3822476feabefdec2",
			"creatorName":"企小微",
			"creatorWxId":"qy_123456",
			"fileMediaList":
			[
				{
					"fileName":"附件文件名称示意.pptx",
					"url":"/upload/file/b17efb43292e4cc9ac5d0b46bce059c4/20190225/0871dbea3f004570a7459af9f26ea1f2.pptx"
				}

			],
			"inchargeRateList":
			[
				{
					"isOver":"0",
					"personName":"企小微",
					"rate":"0.0000",
					"rateType":"0",
					"taskId":"415f00ba-b06f-485b-afd5-224e453ba298",
					"type":"1",
					"workHour":"0",
					"wxUserId":"qy_123456"
				}

			],
			"isUseRate":"0",
			"latitude":"39.916527",
			"longitude":"116.397125",
			"picList":
			[
				"/upload/img/b17efb43292e4cc9ac5d0b46bce059c4/20190225/613e318a103c4318b8b7393d95af5dd3.jpeg"
			],
			"priority":"0",
			"relevantList":
			[
				{
					"personName":"企小微",
					"taskId":"415f00ba-b06f-485b-afd5-224e453ba298",
					"wxUserId":"qy_123456"
				}

			],
			"subtaskList":
			[
				{
					"fileMediaList":
					[
						{
							"fileName":"附件名称示意.pptx",
							"url":"/upload/file/b17efb43292e4cc9ac5d0b46bce059c4/20190225/da07033b18354f10a8b892409b033af3.pptx"
						}

					],
					"mainTaskId":"415f00ba-b06f-485b-afd5-224e453ba298",
					"picList":
					[
						"/upload/img/b17efb43292e4cc9ac5d0b46bce059c4/20190225/78b38c98d11046bbbddc6960a1426b3e.jpeg"
					],
					"startSubtaskTime":"2019-02-25 16:53:00",
					"stopSubtaskTime":"2019-02-26 16:53:00",
					"subCloseReason":"任务已完成",
					"subCloseTime":"2019-02-27 09:18:44",
					"subCloserId":"cbbf7e9ab38549d3822476feabefdec2",
					"subCloserName":"企小微",
					"subCloserWxId":"qy_123456",
					"subContent":"子任务内容示意",
					"subCreatorTime":"2019-02-25 15:55:24",
					"subExecutorRateList":
					[
						{
							"isOver":"0",
							"personName":"企小微",
							"rate":"0.0000",
							"rateType":"0",
							"taskId":"df0b7c3bff3c42bb8555bbadf31e01be",
							"type":"4",
							"wxUserId":"qy_123456"
						}

					],
					"subInchargeName":"企小二",
					"subInchargeWxId":"qy_151162",
					"subNumber":"201902251553",
					"subPriority":"0",
					"subTitle":"子任务标题示意",
					"subTotalRate":"0/1",
					"subtaskCloseType":"1",
					"subtaskId":"df0b7c3bff3c42bb8555bbadf31e01be",
					"subtaskStatus":"2"
				}

			],
			"taskId":"415f00ba-b06f-485b-afd5-224e453ba298",
			"taskStart":"2019-02-25 16:53:00",
			"taskStatus":"2",
			"taskStop":"2019-02-26 16:53:00",
			"title":"标题示例",
			"totalRate":"0/3",
			"typeName":"通知"
		}

	],
	"totalRows":1
}

返回参数说明：

参数	说明
maxPage	最大页
currentPage	当前页
totalRows	信息总条数

pageData 参数说明：

参数	类型	说明
taskId	String	任务id
typeName	String	任务类型（详情请查询任务类型信息获取接口）
title	String	任务标题
content	String	任务内容
isUseRate	String	进度反馈方式：1-按百分比， 2-按时长， 3-按工时
totalRate	String	任务进度
creatorName	String	发起人名称
creatorWxId	String	发起人账号
inchargeRateList	json	任务负责人以及其进度信息列表
relevantList	json	任务相关人信息列表
creatorTime	String	任务创建时间：yyyy-MM-dd HH:mm:ss
taskStart	String	任务开始时间：yyyy-MM-dd HH:mm:ss
taskStop	String	任务截止时间：yyyy-MM-dd HH:mm:ss
priority	String	优先级：0普通 1不紧急但重要 2紧急但不重要 3紧急且重要
accessAddress	String	任务地点名称
latitude	String	任务地点：纬度
longitude	String	任务地点：经度
allSubtaskCount	String	子任务个数
subtaskList	json	子任务信息列表
taskStatus	String	任务发布状态：0待提交 1已提交 2已关闭
closeStatus	String	任务关闭状态：1完成 2终止 3取消 4拒绝
closeReason	String	任务关闭原因
closeTime	String	任务关闭时间：yyyy-MM-dd HH:mm:ss
closerName	String	关闭人名称
commentList	String	任务评论信息：获取该主任务全部评论信息
fileMediaList	json	附件信息：获取该主任务全部附件信息
picList	json	图片信息：获取该主任务全部图片信息
score	String	任务评分
scoreName	String	任务评分人员

inchargeRateList / relevantList 参数说明：

参数	类型	说明
taskId	String	任务id
personName	String	（主任务负责人/子任务执行人）名称
wxUserId	String	（主任务负责人/子任务执行人）帐号
rate	String	（主任务负责人/子任务执行人）任务进度
isOver	String	是否完成：0未完成 1完成
workHour	String	预计工时
rateType	String	进度类别，0-完成状态，1-百分比，2-时长
type	String	人员进度类型，1-主任务负责人，3-子任务负责人， 4-子任务执行人

subtaskList 参数说明：

参数	类型	说明
mainTaskId	String	主任务id
subtaskId	String	子任务id
subNumber	String	子任务编号
subTitle	String	子任务标题
subContent	String	子任务内容
subCreatorName	String	子任务创建人名称
subCreatorWxId	String	子任务创建人账号
subInchargeName	String	子任务负责人名称
subInchargeWxId	String	子任务负责人账号
subTotalRate	String	子任务进度
subCreatorTime	String	子任务创建时间：yyyy-MM-dd HH:mm:ss
startSubtaskTime	String	子任务开始时间：yyyy-MM-dd HH:mm:ss
stopSubtaskTime	String	子任务截止时间：yyyy-MM-dd HH:mm:ss
subPriority	String	子任务优先级：0普通 1不紧急但重要 2紧急但不重要 3紧急且重要
subtaskStatus	String	子任务发布状态：0待提交 1已提交 2已关闭
subtaskCloseType	String	子任务关闭状态：1完成 2终止 3取消 4拒绝
subCloseReason	String	子任务关闭原因
subCloseTime	String	子任务关闭时间：yyyy-MM-dd HH:mm:ss
subCloserName	String	关闭人名称
subScore	String	子任务任务评分
subScoreName	String	子任务评分人员
subExecutorRateList	json	子任务执行人信息及进度列表
fileMediaList	json	子任务附件列表
picList	json	子任务图片列表

commentList 参数说明：

参数	类型	说明
taskId	String	任务id
content	String	评论内容
creator	String	评论人用户id
creatorTime	String	评论时间：yyyy-MM-dd HH:mm:ss
personName	String	评论人名字
type	String	评论时提交的内容的类型：1-纯文字，2-纯图片，3-纯附件，6-混合
commentStatus	String	评论状态值：0-单纯的评论，3-修改某一字段，4-关闭的评论，5-评价的评论，6-修改截止时间的评论，7-更新任务进度的评论，8-关闭任务进度的评论， 9-关闭子任务的评论，10-操作记录的评论

fileMediaList 参数说明：

参数	类型	说明
fileName	String	附件名字
url	String	附件url

企业微信

获取任务分派信息列表

开发说明