新增待办（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） |
submitter | Long | 否 | 创建人 |
taskName | String | 否 | 任务标题 获取任务标题API请参见：查询父任务（API名称：queryParentTaskList） |
parentTaskId | Long | 否 | 父任务id |
parentTaskName | String | 否 | 父任务名称 |
templateId | Long | 否 | 关联采集模板ID |
templateName | String | 否 | 关联采集模板名称 |
content | String | 否 | 内容 |
status | String | 否 | 任务状态：
|
url | String | 否 | PC端跳转url |
thirdUrl | String | 否 | 第三方跳转url或用于移动端跳转的url（若thirdUrl为第三方代办则必填） |
todoBusinessType | String | 否 | 待办类别（JobToDo:作业待办，ApproveToDo:审核待办，..），取值为数据字典中大类为待办类型下的子项编码 |
toDoTips | String | 否 | 任务标签取值（第三方代办todotips必填并且值100，若不填，则校验isdp自有的待办类型），为数据字典中大类为任务标签下的子项编码 |
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
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
