文档首页/ ISDP/ API参考/ API接口/ 公共-待办管理/ 新增待办（API名称：addMyTodo）
更新时间：2024-07-22 GMT+08:00
查看PDF
分享

新增待办（API名称：addMyTodo）

功能介绍

该接口用于第三方新增待办。

相关接口

接口名称

调用说明

获取Token

调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。

查询父任务（API名称：queryParentTaskList）

查询子任务（API名称：OpenSceneTask/querySubTaskList）

查询工序（API名称：queryProcedureList）

调用该接口获取到任务id、任务标题。

新增待办时，需要输入任务id、任务标题。

查询任务执行人或评审人（API名称：queryTaskUserInfoList）

调用该接口获取到当前任务对应审批层级、当前任务对应审批人。

新增待办时，需要输入当前任务对应审批层级、当前任务对应审批人。

更新待办

新增待办后，可以调用该接口更新待办。

删除待办

新增待办后，可以调用该接口删除待办。

完结待办

新增待办后，可以调用该接口完结待办。

调用流程

图1 新增待办流程

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

否

任务状态：

  • 0：草稿
  • 1：待执行
  • 2：执行中
  • 3：已完成
  • 4：已取消
  • 5：申请待审批
  • 9：已驳回

url

String

否

跳转url

thirdUrl

String

否

第三方跳转url或用于移动端跳转的url

todoBusinessType

String

否

待办类别（JobToDo:作业待办，ApproveToDo:审核待办，..），取值为数据字典中大类为待办类型下的子项编码

toDoTips

String

否

任务标签（100：第三方待办，..）取值为数据字典中大类为任务标签下的子项编码

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）

currentReviewerId

String

否

当前任务对应审批人

获取当前任务对应审批人API请参见：查询任务执行人或评审人（API名称：queryTaskUserInfoList）

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
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 公共-待办管理

相关文档