文档首页/ ISDP/ API参考/ API接口/ 任务管理/ 任务进展管理/ 新增任务（API名称：createTask）

更新时间：2025-06-16 GMT+08:00

查看PDF

新增任务（API名称：createTask）

功能介绍

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

接口名称	调用说明
获取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：执行阶段不填或没有该字段时默认为创建阶段

参数

类型

是否必填

描述

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、分页数据。

参数

类型

描述

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
        }
    ]
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 任务进展管理

上一篇：任务进展管理

下一篇：新增父子任务（API名称：createSubTask）

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

新增任务（API名称：createTask）

功能介绍

相关API

调用流程

URL

请求头

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？