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

新增待办(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
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档