文档首页/ ISDP/ API参考/ API接口/ 任务管理/ 任务进展管理/ 新增工序任务（API名称：createProcedureTask）
更新时间：2024-07-22 GMT+08:00
查看PDF
分享

新增工序任务（API名称：createProcedureTask）

功能介绍

用于用户系统创建工序任务

相关接口

接口名称

调用说明

获取Token

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

查询任务场景

调用该接口获取到任务场景的场景名称。

创建任务时，需要输入获取到的场景名称。

查询租户下用户信息（API名称：getPersonListByTenant）

调用该接口获取执行人。

创建任务时，任务模式为“启用子任务”时，需要输入获取到执行人；其他任务模式“执行人”为空则提交后为“待调度”状态，“执行人”填写后提交为“待执行”或“任务申请待审批”状态。

查询父任务

创建任务后，可以调用该接口查询创建的任务。

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/openSceneTask/createProcedureTask

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

是

无

Authorization

bearer ${access_token}

是

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数

类型

是否必填

描述

taskQueries

List

是

入参

taskQueries入参（注意：由于任务的基础字段和拓展字段是否必填是由场景配置的）：

参数

类型

是否必填

描述

customerTaskId

String

是

客户任务ID

creatorAccount

String

否

创建人账号（isdp+中存在的人员账号）

taskName

String

是

父任务名称

signSiteName

String

否

作业对象名称

sceneName

String

是

场景名称，取最新版本

projectNo

String

是

项目编码

assignedUserType

Integer

是

执行人类型：1-执行人；2-群组

assignedUser

String

是

执行人（如果是执行人，则传执行人账号，多个用“;”隔开；如果是群组，传群组名称，只能单个）

supplierName

String

否

供应商名称

reviewRuleName

Long

否

任务申请审批流名称，需要审批时为必填

collectionReviewName

Long

否

检查单采集审批流名称，需要审批时为必填（只有挂检查单的场景才有）

beginTimestamp

Long

否

计划开始时间时间戳

endTimestamp

Long

否

计划完成时间时间戳

taskRemark

String

否

任务描述

administrativeDivisionName

String

否

行政区域

priority

String

否

优先级

jobDuration

Integer

否

标准作业时长

projectDuration

Integer

否

工期

schedulingMode

String

否

调度模式

address

String

否

任务地址（最多1000个字符）

requiredStartTime

Long

否

要求开始时间

requiredEndTime

Long

否

要求结束时间

skill

Stirng

否

技能

customerName

String

否

客户名称

taskExtendList

List<Object>

否

拓展属性列表

procedureList

List<Object>

否

工序列表，这里只可以给对应的工序配置采集审批流。

Toolset

List<TaskToolVO>

否

工具集

taskExtendList列表入参：

参数

类型

是否必填

描述

fieldName

String

是

拓展属性字段名称

extendValue

String

是

拓展属性值（如果是时间和日期，值必须是时间戳）

procedureList列表入参：

参数

类型

是否必填

描述

modeOrder

Int

是

序号，从1开始，对应场景配置的序号

collectionReviewName

Long

否

检查单采集审批流名称，需要审批时为必填（只有挂检查单的场景才有）

Toolset

List<TaskToolVO>

否

工具集

toolSet入参

参数

类型

是否必填

描述

id

Long

否

主键id

parentTaskId

Long

否

父任务id

toolNo

String

是

工具编号

toolName

String

是

工具名称

redirectUrl

String

否

第三方工具跳转url

extensionType

Integer

否

扩展属性类型（1：表单；2：json）

toolLocation

Map<String, Object>

是

工具在画布中的位置json

toolAttrList

Object

否

工具扩展属性配置json

NextToolList

List<Map<String,Object>>

否

拓展属性值（如果是时间和日期，值必须是时间戳）

响应参数

参数

类型

描述

stateCode

String

响应状态码：0-成功；其他-失败

errorMessage

String

响应描述

result

Object

响应结果内容data、分页数据

data出参:

参数

类型

描述

customerTaskId

String

客户任务ID

taskId

Long

创建成功的任务id

status

Integer

返回状态：0-成功;1-失败

message

String

返回的失败消息。

请求示例

{
    "customerTaskId": 1667986503488,
    "taskName": "1667986503734lwc测试",
    "signSiteName": "",
    "creatorAccount": "17791717398",
    "sceneName": "新建工序-测试",
    "projectNo": "",
    "assignedUserType": 1,
    "assignedUser": "13229474258",
    "reviewRuleName": "",
    "beginTimestamp": "",
    "endTimestamp": "",
    "requiredStartTime": "",
    "requiredEndTime": "",
    "taskRemark": "",
    "priority": "",
    "jobDuration": "",
    "projectDuration": "",
    "schedulingMode": "",
    "administrativeDivisionName": "1508098844233300",
    "address": "",
    "skill": "",
    "customerName": "",
    "supplierName": "",
    "taskExtendList": [],
    "toolSet": [
        {
            "toolNo": "T003",
            "toolName": "子任务2-工序1",
            "toolLocation": {
                "x": 100,
                "y": 200
            }
        }
    ],
    "procedureList": [
        {
            "modeOrder": "1",
            "collectionReviewName": "",
            "toolSet": [
                {
                    "toolNo": "T003",
                    "toolName": "子任务2-工序1",
                    "toolLocation": {
                        "x": 100,
                        "y": 200
                    }
                }
            ]
        }
    ]
}

响应示例

{
    "stateCode": "0",
    "errorMessage": null,
    "result": {
        "customerTaskId": "1667986503488",
        "subTaskOrNot": 0,
        "procedureOrNot": 1,
        "ticketId": 0,
        "tenantId": 1463,
        "sceneMode": 3,
        "reviewRuleId": null,
        "isApplyApprove": 0,
        "reviewRuleName": "",
        "licenseSwitch": null,
        "status": 1,
        "deleteFlag": 0,
        "submitBy": 1823,
        "submitName": "superman",
        "submitDate": 1667986531707,
        "creationDate": 1667986531987,
        "creationTimestamp": 1667986531707,
        "createName": "张三",
        "createdBy": 1957,
        "lastUpdateTimestamp": 1667986531707,
        "lastUpdateDate": 1667986531987,
        "lastUpdateName": "张三",
        "lastUpdatedBy": 1957,
        "schedulerTimestamp": 1667986531707,
        "schedulerDate": 1667986531707,
        "operationTimestamp": 1667986531707,
        "signInConfig": null,
        "schedulerName": "OpenApi",
        "schedulerBy": -1,
        "entityName": "SceneTask",
        "sceneTaskId": 5005759,
        "appName": "isdp-task-server",
        "affectedRows": 1
    }
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 任务进展管理

相关文档