API开发文档 - 道一云

开发说明

开发说明

功能说明：新增新建任务的接口，帮助企业通过数据接口的形式创建任务，增加用户的使用场景的多样性，帮助企业更好地将任务分派的数据信息集成同步至企业OA系统中。
请求方式：POST（HTTPS）multipart/form-data
请求地址：https://qwif.do1.com.cn/qwcgi/api/taskApiCtl/ajaxAddTask.do?token=token&corpId=corpId

请求包体：

{
	"subtaskJsonStr":
	{
		"subtask":
		[
			{
				"content":"这是子任务内容",
				"creatorWxUserId":"qw123456",
				"executorsWxUserId":"do123456,lin",
				"inchargesWxUserId":"qw123456",
				"mainTaskId":"0388730835ec48c0b97cdd11e5549931",
				"number":"这是子任务编号",
				"priority":"0",
				"startTime":"2019-03-06 17:15:00",
				"stopTime":"2019-03-07 17:15:00",
				"subtaskId":"f68c8ed186d44803b98cf777b98045a2",
				"title":"这是子任务标题"
			}

		]

	},
	"task":
	{
		"accessAddress":"广州天河",
		"commentSendMsg":"1",
		"content":"这是任务内容",
		"creatorWxUserId":"qw123456",
		"deadlineRemindMsg":"0",
		"inchargeWxUserIdStr":"qw123456,lin",
		"isUseRate":"0",
		"priority":"0",
		"rateSendMsg":"1",
		"relevantWxUserIdStr":"lin",
		"remindTaskVO":
		{
			"remindCycle":1,
			"remindTime":"2019-03-06 12:00:00"
		},
		"sendStartRemindMsg":"0",
		"taskId":"0388730835ec48c0b97cdd11e5549931",
		"taskStart":"2019-03-06 17:15:00",
		"taskStop":"2019-03-07 17:15:00",
		"taskType":"db54be9a-d618-48f4-a008-84ebe20c6b7c",
		"title":"这是任务标题"
	}

}

请求参数说明：

参数名	释义	类型	是否必须	备注
corpId	公司唯一标识	String	是
token	用于验证	String	是

data参数，以json格式传送

参数名	释义	类型	是否必须	备注
task	任务	Object	是
subtaskJsonStr	子任务json	json	否

task参数说明

参数名	类型	说明	是否必填	备注
taskId	String	任务id	是	建议用UUID32
taskType	String	任务类型id	是	必须为启用状态；最多只能填写一个
title	String	任务标题	是	仅支持0到3000个字符
content	String	任务内容	否	仅支持0到3000个字符
creatorWxUserId	String	发起人账号	是	必须是存在于道一云通讯录中的账号；该账号需拥有发布任务权限；最多只能填写一个
inchargesWxUserId	String	负责人账号	否	必须是存在于道一云通讯录中的账号；多个负责人，可用英文逗号隔开
relativesWxUserId	String	相关人账号	否	必须是存在于道一云通讯录中的账号；多个相关人，可用英文逗号隔开
isUseRate	String	进度反馈方式	否	1、按工时 2、按完成状态 3、按百分比（默认按完成状态）
taskHours	String	设置预计工时	否
taskStart	String	开始时间	是	yyyy-MM-dd HH:mm:ss
taskStop	String	截止时间	是	yyyy-MM-dd HH:mm:ss
priority	String	优先级	否	0普通 1不紧急但重要 2紧急但不重要 3紧急且重要
accessAddress	String	任务地点	否
sendStartRemindMsg	String	任务开始前30分钟提醒负责人	否	默认开启
deadlineRemindMsg	String	任务截止前30分钟提醒负责人	否	默认开启
commentSendMsg	String	有新评论时提醒负责人	否	默认开启
rateSendMsg	String	更新进度时通知提醒	否	默认开启
reminderTask	Object	重复提醒	否	不开启（默认）

subtaskJsonStr参数说明

参数名	类型	说明	是否必填	备注
subtaskId	String	子任务id	是	建议用UUID32
number	String	子任务编号	是
title	String	子任务标题	是	仅支持0到3000个字符
content	String	子任务内容	否	仅支持0到3000个字符
creatorWxUserId	String	发起人账号	是	必须是存在于道一云通讯录中的账号；该账号需拥有发布任务权限；最多只能填写一个
inchargesWxUserId	String	负责人账号	否	必须是存在于道一云通讯录中的账号；最多只能填写一个
executorsWxUserId	String	相关人账号	否	必须是存在于道一云通讯录中的账号；多个相关人，可用英文逗号隔开
priority	String	进度反馈方式	否	0普通 1不紧急但重要 2紧急但不重要 3紧急且重要
workHour	String	设置预计工时	否	1、统一设置 2、按执行人设置（进度反馈方式需为【按工时】）
taskStart	String	开始时间	是	yyyy-MM-dd HH:mm:ss
taskStop	String	截止时间	是	yyyy-MM-dd HH:mm:ss

reminderTask参数说明

参数名	类型	说明	是否必填	备注
remindTime	String	提醒时间	否	yyyy-MM-dd HH:mm:ss
remindCycle	Integer	提醒类型	否	0：不重复， 1：每天， 2：每周， 3：每月， 8：自定义
regExp	json	任务标题	否	仅支持0到3000个字符

regExp参数说明

参数名	类型	说明	是否必填	备注
type	String		否	week_for_day每周提醒
rate	String	提醒频率	否	0：不重复， 1：每天， 2：每周， 3：每月， 8：自定义
value	String		否

SDK调用示例：

		TaskAddJsonReqVO taskVO = new TaskAddJsonReqVO();
		//主任务id
		taskVO.setTaskId(UUID.randomUUID().toString().replace("-", ""));
		//设置任务标题
		taskVO.setTitle("这是任务标题");
		//设置任务类型
		taskVO.setTaskType("db54be9a-d618-48f4-a008-84ebe20c6b7c");
		//设置任务内容
		taskVO.setContent("这是任务内容");
		//设置任务创建人
		taskVO.setCreatorWxUserId("qw123456");
		//设置任务负责人
		taskVO.setInchargeWxUserIdStr("qw123456,lin");
		//设置任务相关人
		taskVO.setRelevantWxUserIdStr("lin");
		//设置任务反馈方式
		taskVO.setIsUseRate("0");
		//设置任务时长
		taskVO.setTaskHours("");
		//设置任务开始时间
		taskVO.setTaskStart("2019-03-06 17:15:00");
		//设置任务结束时间
		taskVO.setTaskStop("2019-03-07 17:15:00");
		//设置任务优先级
		taskVO.setPriority("0");
		//设置任务地点
		taskVO.setAccessAddress("广州天河");
		//设置任务【任务开始前30分钟提醒负责人】开关
		taskVO.setSendStartRemindMsg("0");
		//设置任务【任务截止前30分钟提醒负责人】开关
		taskVO.setDeadlineRemindMsg("0");
		//设置任务【有新评论时提醒负责人】开关
		taskVO.setCommentSendMsg("1");
		//设置任务【更新进度时通知提醒】开关
		taskVO.setRateSendMsg("1");

		//设置任务重复提醒
		RemindTaskReqVO remindTaskVO = new RemindTaskReqVO();
		//设置任务提醒时间
		remindTaskVO.setRemindTime("2019-03-06 12:00:00");
		//设置任务提醒类型
		remindTaskVO.setRemindCycle(1);
		//设置任务自定义提醒
		remindTaskVO.setRegExp("");
		taskVO.setRemindTaskVO(remindTaskVO);

		//设置子任务
		List<SubtaskAddJsonReqVO> subtaskList = new ArrayList<SubtaskAddJsonReqVO>();
		SubtaskAddJsonReqVO subtaskVO = new SubtaskAddJsonReqVO();
		//主任务id
		subtaskVO.setMainTaskId(taskVO.getTaskId());
		//子任务id
		subtaskVO.setSubtaskId(UUID.randomUUID().toString().replace("-", ""));
		//子任务编号
		subtaskVO.setNumber("这是子任务编号");
		//子任务标题
		subtaskVO.setTitle("这是子任务标题");
		//子任务内容
		subtaskVO.setContent("这是子任务内容");
		//子任务创建人账号
		subtaskVO.setCreatorWxUserId("qw123456");
		//子任务负责人账号
		subtaskVO.setInchargesWxUserId("qw123456");
		//子任务执行人账号
		subtaskVO.setExecutorsWxUserId("do123456,lin");
		//子任务优先级
		subtaskVO.setPriority("0");
		//子任务预计时长
		subtaskVO.setWorkHour("");
		//子任务开始时间
		subtaskVO.setStartTime("2019-03-06 17:15:00");
		//子任务结束时间
		subtaskVO.setStopTime("2019-03-07 17:15:00");
		subtaskList.add(subtaskVO);

		JSONArray subtaskListJsonArray = JSONArray.fromObject(subtaskList);
		JSONObject subtaskJsonObject = new JSONObject();
		subtaskJsonObject.put("subtask", subtaskListJsonArray);

		TaskApi taskApi = QwSdkUtil.getInter(TaskApi.class);
		// 调用接口
		TaskAddResultVO resultVO = taskApi.ajaxAddTask(QwSdkUtil.getCacheToken(), taskVO, subtaskJsonObject.toString());
		//任务id
		System.out.println(resultVO.getTaskId());
		//任务类型
		System.out.println(resultVO.getTaskType());
		//任务标题
		System.out.println(resultVO.getTitle());
		//创建人账号
		System.out.println(resultVO.getCreatorWxUserId());

返回结果：

{
	"code":"0",
	"data":
	{
		"creatorWxUserId":"qy_15989131328",
		"taskId":"a2bb9907e02a4b78bcfa90dce212a796",
		"taskType":"db54be9a-d618-48f4-a008-84ebe20c6b7c",
		"title":"这是任务标题"
	},
	"desc":"成功"
}

返回参数说明：

参数	类型	说明
taskId	String	任务id
taskType	String	任务类型
title	String	任务标题
creatorWxUserId	String	发起人账号

企业微信

新增任务

开发说明