新增待办（API名称：addMyTodo）
功能介绍
该接口用于第三方新增待办。
相关接口
接口名称 |
调用说明 |
|---|---|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
|
查询父任务（API名称：queryParentTaskList） |
调用该接口获取到任务id、任务标题。 新增待办时，需要输入任务id、任务标题。 |
调用该接口获取到当前任务对应审批层级、当前任务对应审批人。 新增待办时，需要输入当前任务对应审批层级、当前任务对应审批人。 |
|
新增待办后，可以调用该接口更新待办。 |
|
新增待办后，可以调用该接口删除待办。 |
|
新增待办后，可以调用该接口完结待办。 |
调用流程
URL
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
POST |
https://isdp+域名/openapi/v1/myTodoWrap/addMyTodo |
OpenAPI |
application/json |
请求头
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
Content-Type |
application/json |
是 |
无 |
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
mytodoList |
List |
必填 |
任务列表 |
mytodoList列表：
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
assignedUserIdList |
Long[] |
否 |
执行人列表 |
reviewerIdList |
Long[] |
否 |
审批人列表 |
groupIdList |
Long[] |
否 |
群组id列表 |
sceneTaskId |
Long |
是 |
任务id 获取任务id API请参见：查询父任务（API名称：queryParentTaskList），查询子任务（API名称：OpenSceneTask/querySubTaskList）或查询工序（API名称：queryProcedureList） |
submitter |
Long |
否 |
创建人 |
taskName |
String |
否 |
任务标题 获取任务标题API请参见：查询父任务（API名称：queryParentTaskList），查询子任务（API名称：OpenSceneTask/querySubTaskList）或查询工序（API名称：queryProcedureList） |
parentTaskId |
Long |
否 |
父任务id |
parentTaskName |
String |
否 |
父任务名称 |
templateId |
Long |
否 |
关联采集模板ID |
templateName |
String |
否 |
关联采集模板名称 |
content |
String |
否 |
内容 |
status |
String |
否 |
任务状态：
|
url |
String |
否 |
跳转url |
thirdUrl |
String |
否 |
第三方跳转url或用于移动端跳转的url |
todoBusinessType |
String |
否 |
待办类别（JobToDo:作业待办，ApproveToDo:审核待办，..），取值为数据字典中大类为待办类型下的子项编码 |
toDoTips |
String |
否 |
任务标签（100：第三方待办，..）取值为数据字典中大类为任务标签下的子项编码 |
reviewLevel |
String |
否 |
当时审批层级 |
reviewStatus |
String |
否 |
审批结果 |
signSiteName |
String |
否 |
作业对象名称 |
signSiteCode |
String |
否 |
作业对象编码 |
procedureOrNot |
String |
否 |
是否带工序：
|
taskTagType |
String |
否 |
任务标识 |
subTaskOrNot |
String |
否 |
是否带子任务 |
projectNo |
String |
否 |
项目编码 |
businessKey |
String |
否 |
业务key，将服务名称比如isdp-rp-server |
siteId |
String |
否 |
作业对象ID |
statusCollection |
String |
否 |
采集状态 |
statusApprove |
String |
否 |
评审状态 |
signMode |
Int |
否 |
评审模式：
|
assignedGroupId |
Long[] |
否 |
执行人群组Id |
procedureInfo |
String |
否 |
描述，合成map存入other_info字段 |
taskTicketInfo |
String |
否 |
同procedureInfo |
checkTaskInfo |
String |
否 |
同procedureInfo |
currentReviewLevel |
String |
否 |
当前任务对应审批层级 获取当前任务对应审批层级API请参见：查询任务执行人或评审人（API名称：queryTaskUserInfoList） |
currentReviewerId |
String |
否 |
当前任务对应审批人 获取当前任务对应审批人API请参见：查询任务执行人或评审人（API名称：queryTaskUserInfoList） |
isUpdateHandled |
String |
否 |
是否更新已办：
|
响应参数
参数 |
类型 |
描述 |
|---|---|---|
status |
int |
状态码 |
msg |
String |
失败原因 |
data |
List |
数据 |
请求示例
{
"mytodoList":[{
"currentReviewLevel":1,
"isUpdateHandled":"Y",
"signMode":1,
"reviewLevel":1,
"reviewerIdList":[4107,2,3],
"sceneTaskId":88,
"signSiteCode":"",
"signSiteName":"",
"status":5,
"subTaskOrNot":0,
"submitter":25804,
"taskName":"测试审批流名称730",
"taskTagType":1,
"templateName":"",
"toDoTips":14,
"todoBusinessType":"Appcube_ApproveToDo",
"url":"#/qc/toDoList/taskReview?sceneTaskId=90084&parentTaskId=90084&taskType=1&type=206",
"thirdUrl":"#/qc/toDoList/taskReview?sceneTaskId=90084&parentTaskId=90084&taskType=1&type=206"
}]
}
响应示例
{
"status":"success",
"msg":null,
"data":null
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
