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

新增任务（API名称：createTask）

功能介绍

该接口用于创建工单任务，工单任务可定义任务类型、字段、采集清单、审批流程、作业工序等，创建的任务可用于现场作业的管理。

相关API

接口名称

调用说明

获取Token

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

查询任务场景

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

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

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

调用该接口获取执行人。

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

查询父任务

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

调用流程

图1 创建任务流程

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

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

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

是

无

Authorization

bearer ${access_token}

是

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

请求参数

参数

类型

是否必填

描述

taskQueries

List

是

任务集合。

operUserId

Long

否

操作人。

operUserNo

Long

否

操作人账号。

customerTaskId

Long

否

客户任务ID。

resource

String

否

任务来源。

taskName

String

是

任务名称。

sceneName

String

是

任务场景名称。

sceneId

Long

是

任务场景ID。

signSiteId

Long

否

作业对象ID。

signSiteCode

String

否

作业对象编码。

signSiteName

String

否

作业对象名称。

projectNo

String

否

项目编码。

projectName

String

否

项目名称。

supplierName

String

否

供应商。

assignedUserType

String

否
执行人类型。
  • 1：用户
  • 2：群组

assignedUser

String

否

执行人账号。

beginTimestamp

Long

否

计划开始时间。

endTimestamp

Long

否

计划完成时间。

requiredStartTime

Long

否

要求开始时间。

requiredEndTime

Long

否

要求完成时间。

projectDuration

String

否

工期。

jobDuration

String

否

标准时长。

adminOrganizationName

String

是

组织单元名称。

adminOrganization

String

是

组织单元编码。

administrativeDivision

String

否

行政区域。

administrativeDivisionName

String

否

行政区域名称。

说明：

支持输入多个值，多个值时用分号隔开。

regionName

String

否

行政区域名称。

regionId

String

否

行政区域ID。

regionPath

String

否

行政区域路径。

skill

String

否

技能。

address

String

否

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

templateId

Long

否

模板ID。

templateCode

String

否

模板编码。

templateName

String

否

模板名称。

version

String

否

版本。

reviewRuleId

Long

否

任务申请审批流ID。

reviewRuleName

String

否

任务申请审批流名称。

taskRemark

String

否

任务备注。

isAppraisal

String

否
任务是否需要审批。
  • 0：不需要审批
  • 1：需要审批

collectionReviewId

Long

否

采集审批流ID。

collectionReviewName

String

否

采集审批流名称。

collectionProcessType

String

否
采集审批流类型。
  • 0：标准审批流
  • 1：临时审批流
  • 2：自定义审批流

priority

String

否

优先级。

schedulingMode

String

否

调度模式。

customerName

String

否

客户名称。

customerId

String

否

客户ID。

operationGuideList

List

否

操作指导。

attachmentList

List

否

附件。

taskMode

String

是
任务模式。
  • 1：简单任务
  • 2：任务下挂检查单

saveDraft

String

是
保持草稿、提交。
  • 0：保存草稿
  • 1：提交

taskExtendList

List

否

任务扩展属性。

url

String

否

待办地址。

thirdUrl

String

否

第三方待办地址。

geoType

String

否

经纬度类型（值只能为BD或者为空）

longitude

String

否

任务经度信息

latitude

String

否

任务纬度信息

isCustomerTaskIdDuplicate

String

否

是否允许客户任务ID重复，Y:允许，N,不允许重复 为空或默认为N，不允许重复

Toolset

List<TaskToolVO>

否

工具集

taskExtendList列表入参：

参数

类型

是否必填

描述

fieldName

String

是

拓展属性字段名称

extendValue

String

是

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

stage

Integer

否

任务扩展属性阶段：1创建阶段 2：执行阶段

不填或没有该字段时默认为创建阶段

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

返回的失败消息。

请求示例

{
    "taskQueries": [
        {
            "supplierName": "",
            "taskRemark": "",
            "beginTimestamp": "",
            "collectionReviewName": "",
            "sceneName": "openApi-简单任务场景",
            "latitude": "23.456",
            "signSiteName": "bzh00201",
            "customerTaskId": "1255d-104456789123789001026",
            "projectNo": "",
            "assignedUserType": "1",
            "geoType": "BD",
            "reviewRuleName": "人员数量",
            "taskName": "简单任务012",
            "assignedUser": "15080988442",
            "endTimestamp": "",
            "taskExtendList": "",
            "longitude": "123.456",
            "toolSet": [
                {
                    "toolNo": "T003",
                    "toolName": "子任务2-工序1",
                    "toolLocation": {
                        "x": 100,
                        "y": 200
                    },
                    "toolAttrList": [
                        {
                            "attrName": "显示名称",
                            "attrCode": "displayName",
                            "attrValue": "子任务2-工序1"
                        }
                    ]
                }
            ]
        }
    ]
}

响应示例

{
 "stateCode": "0",
    "errorMessage": null,
    "result": [
        {
            "status": "0",
            "message": "保存成功",
            "customerTaskId": null,
            "taskId": 2900025
        }
    ]
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 任务进展管理

相关文档