新增待办(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
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。