# 新增待办（API名称：addMyTodo） #### 功能介绍 该接口用于第三方新增待办。 #### 相关接口 | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 | | [查询父任务（API名称：queryParentTaskList）](https://support.huaweicloud.com/api-isdp/api_01_0037.html) [查询子任务（API名称：OpenSceneTask/querySubTaskList）](https://support.huaweicloud.com/api-isdp/api_01_0038.html) [查询工序（API名称：queryProcedureList）](https://support.huaweicloud.com/api-isdp/api_01_0050.html) | 调用该接口获取到任务id、任务标题。 新增待办时，需要输入任务id、任务标题。 | | [查询任务执行人或评审人（API名称：queryTaskUserInfoList）](https://support.huaweicloud.com/api-isdp/api_01_0046.html) | 调用该接口获取到当前任务对应审批层级、当前任务对应审批人。 新增待办时，需要输入当前任务对应审批层级、当前任务对应审批人。 | | [更新待办](https://support.huaweicloud.com/api-isdp/api_01_0104.html) | 新增待办后，可以调用该接口更新待办。 | | [删除待办](https://support.huaweicloud.com/api-isdp/api_01_0105.html) | 新增待办后，可以调用该接口删除待办。 | | [完结待办](https://support.huaweicloud.com/api-isdp/api_01_0106.html) | 新增待办后，可以调用该接口完结待办。 | #### 调用流程 图1新增待办流程 ![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002490654836.png "点击放大") #### 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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 | #### 请求参数 | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | mytodoList | List | 必填 | 任务列表 | mytodoList列表： | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | assignedUserIdList | Long\[\] | 否 | 执行人列表 | | reviewerIdList | Long\[\] | 否 | 审批人列表 | | groupIdList | Long\[\] | 否 | 群组id列表 | | sceneTaskId | Long | 是 | 任务id 获取任务id API请参见：[查询父任务（API名称：queryParentTaskList）](https://support.huaweicloud.com/api-isdp/api_01_0037.html) [查询子任务（API名称：OpenSceneTask/querySubTaskList）](https://support.huaweicloud.com/api-isdp/api_01_0038.html) [查询工序（API名称：queryProcedureList）](https://support.huaweicloud.com/api-isdp/api_01_0050.html) | | submitter | Long | 否 | 创建人 | | taskName | String | 否 | 任务标题 获取任务标题API请参见：[查询父任务（API名称：queryParentTaskList）](https://support.huaweicloud.com/api-isdp/api_01_0037.html) [查询子任务（API名称：OpenSceneTask/querySubTaskList）](https://support.huaweicloud.com/api-isdp/api_01_0038.html) [查询工序（API名称：queryProcedureList）](https://support.huaweicloud.com/api-isdp/api_01_0050.html) | | parentTaskId | Long | 否 | 父任务id | | parentTaskName | String | 否 | 父任务名称 | | templateId | Long | 否 | 关联采集模板ID | | templateName | String | 否 | 关联采集模板名称 | | content | String | 否 | 内容 | | status | String | 否 | 任务状态： - 0：草稿 - 1：待执行 - 2：执行中 - 3：已完成 - 4：已取消 - 5：申请待审批 - 9：已驳回 | | 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 | 否 | 是否带工序： - 0 否 - 1 是 | | taskTagType | String | 否 | 任务标识 | | subTaskOrNot | String | 否 | 是否带子任务 | | projectNo | String | 否 | 项目编码 | | businessKey | String | 否 | 业务key，将服务名称比如isdp-rp-server | | siteId | String | 否 | 作业对象ID | | statusCollection | String | 否 | 采集状态 | | statusApprove | String | 否 | 评审状态 | | signMode | Int | 否 | 评审模式： - 0 单签 - 1 会签 | | assignedGroupId | Long\[\] | 否 | 执行人群组Id | | procedureInfo | String | 否 | 描述，合成map存入other_info字段 | | taskTicketInfo | String | 否 | 同procedureInfo | | checkTaskInfo | String | 否 | 同procedureInfo | | currentReviewLevel | String | 否 | 当前任务对应审批层级 获取当前任务对应审批层级API请参见：[查询任务执行人或评审人（API名称：queryTaskUserInfoList）](https://support.huaweicloud.com/api-isdp/api_01_0046.html) | | currentReviewerId | String | 否 | 当前任务对应审批人 获取当前任务对应审批人API请参见：[查询任务执行人或评审人（API名称：queryTaskUserInfoList）](https://support.huaweicloud.com/api-isdp/api_01_0046.html) | | isUpdateHandled | String | 否 | 是否更新已办： - Y 更新 - N 不更新 | #### 响应参数 | **参数** | **类型** | **描述** | |:---|:---|:---| | 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 } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。 #### 错误码 错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。