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

更新时间：2025-02-11 GMT+08:00

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

功能介绍

用于用户系统创建父任务。

接口名称	调用说明
获取Token	调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。
查询父任务	新增后可以查询是否新增成功

请求头

KEY	VALUE	是否必填	描述
Content-Type	application/json	是	无
Authorization	bearer ${access_token}	是	bearer +“ ”+5.2.1中获取的access_token的值

URL

请求方式	HTTPS地址	服务架构	消息体类型
POST	https://*isdp+域名*/openapi/v1/openSceneTask/createSubTask	OpenAPI	application/json

请求参数

参数	类型	是否必填	描述
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	否	客户名称
geoType	String	否	父任务经纬度类型（值只能为BD或者为空）
longitude	String	否	父任务经度信息
latitude	String	否	父任务纬度信息
geoType	String	否	子任务经纬度类型（值只能为BD或者为空）
longitude	String	否	子任务经度信息
latitude	String	否	子任务纬度信息
subTaskList	List<Object>	是	子任务列表，场景配置了多少子任务，这里就要填写多少个，否则会报错
taskExtendList	List<Object>	否	拓展属性列表
saveDraft	String	否	保存/提交 0：保存草稿 1：提交
isCustomerTaskIdDuplicate	String	否	是否允许客户任务ID重复，Y：允许 N:不允许重复为空或默认为N
Toolset	List<TaskToolVO>	否	工具集

subTaskList列表入参：

参数	类型	是否必填	描述
modeOrder	Int	是	序号，从1开始，对应场景配置的序号
taskName	String	否	子任务名称，以入参为准，入参为空则取场景的名称
signSiteName	String	否	作业对象名称
assignedUserType	Integer	是	执行人类型：1-执行人；2-群组
assignedUser	String	否	执行人（如果是执行人，则传执行人账号，多个用“;”隔开；如果是群组，传群组名称，只能单个，如果入参是空，则取场景里的值）
collectionReviewName	String	否	采集审批流名称，优先取场景里配置的名称，如果没有再取入参的名称
beginTimestamp	Long	否	计划开始时间时间戳
endTimestamp	Long	否	计划完成时间时间戳
taskRemark	String	否	任务描述
administrativeDivisionName	String	否	行政区域
priority	String	否	优先级
jobDuration	Integer	否	标准作业时长
projectDuration	Integer	否	工期
address	String	否	任务地址（最多1000个字符）
requiredStartTime	Long	否	要求开始时间
requiredEndTime	Long	否	要求结束时间
skill	Stirng	否	技能
taskExtendList	List<Object>	否	子任务拓展属性列表
procedureList	List<Object>	否	工序列表，这里只可以给对应的工序配置采集审批流。
Toolset	List<TaskToolVO>	否	工具集

taskExtendList列表入参（父子任务的入参一样）：

参数	类型	是否必填	描述
fieldName	String	是	拓展属性字段名称
extendValue	String	是	拓展属性值（如果是时间和日期，值必须是时间戳）
stage	Integer	否	任务扩展属性阶段：1创建阶段 2执行阶段不填写默认为创建阶段（与场景中的扩展属性阶段匹配）

procedureList列表入参：

参数	类型	是否必填	描述
modeOrder	Int	是	序号，从1开始，对应场景配置的序号
collectionReviewName	Long	否	检查单采集审批流名称，需要审批时为必填（只有挂检查单的场景才有）

preTaskList子任务前后置关系每个Object字段说明：

参数	类型	是否必填	描述
isEnabledScenePre	String	否	是否继承场景前后置关系 Y：从场景获取，不取接口参数 N ：不从场景获取，只取接口入参为准；默认Y，从场景集成
preTaskName	String	是	前置任务名称
preTaskLocation	String	是	前置任务位置信息
taskPreName	String	是	后置任务名称
taskPreLocation	String	是	后置任务位置
preType	String	是	前置后置关系

preTaskLocation参数说明：

参数	类型	是否必填	描述
x	int	是	无现成子任务关系，则初始值赋 X=50 Y=50 后置子任务，则在当前子任务基础上赋值：X不变，Y增加250 兄弟子任务，则在当前子任务基础上赋值：X增加150，Y不变
y	int	是

taskPreLocation参数说明：

参数	类型	是否必填	描述
x	int	是	无现成子任务关系，则初始值赋 X=50 Y=50 后置子任务，则在当前子任务基础上赋值：X不变，Y增加250 兄弟子任务，则在当前子任务基础上赋值：X增加150，Y不变
y	int	是

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": 1667986035676,
    "taskName": "1667986035676lwc测试",
    "signSiteName": "bzh00201",
    "geoType": "BD",
    "longitude": "123.456",
    "latitude": "23.456",
    "creatorAccount": "17791717398",
    "sceneName": "测试openApi",
    "projectNo": "",
    "assignedUserType": 2,
    "assignedUser": "0326test",
    "ccPersonType": 6,
    "ccPerson": "",
    "ownerType": 7,
    "owner": "",
    "supplierName": "",
    "beginTimestamp": "1655913600000",
    "endTimestamp": "1655913600000",
    "requiredStartTime": "",
    "requiredEndTime": "",
    "jobDuration": "",
    "projectDuration": "",
    "schedulingMode": "",
    "administrativeDivisionName": "",
    "address": "",
    "skill": "",
    "customerName": "",
    "taskExtendList": [],
    "toolSet": [
        {
            "toolNo": "T003",
            "toolName": "子任务2-工序1",
            "toolLocation": {
                "x": 100,
                "y": 200
            }
        }
    ],
    "subTaskList": [
        {
            "taskExtendList": [
                {
                    "fieldName": "",
                    "extendValue": ""
                },
                {
                    "fieldName": "",
                    "extendValue": ""
                }
            ],
            "signSiteName": "",
            "modeOrder": 1,
            "projectNo": "UI项目默认",
            "assignedUserType": 1,
            "assignedUser": "17791717398",
            "ccPersonType": 4,
            "ccPerson": "17791717398",
            "ownerType": 5,
            "owner": "17791717398",
            "supplierName": "",
            "reviewRuleName": "",
            "beginTimestamp": "1652803200000",
            "endTimestamp": "1653055200000",
            "requiredStartTime": "1653062400000",
            "longitude": "123.789",
            "latitude": "45.236",
            "geoType": "BD",
            "requiredEndTime": "1653926400000",
            "taskRemark": "测试任务备注",
            "collectionReviewName": "",
            "priority": "",
            "jobDuration": "",
            "projectDuration": "",
            "schedulingMode": "",
            "administrativeDivisionName": "",
            "address": "",
            "skill": "",
            "customerName": "",
            "procedureList": [],
            "toolSet": [
                {
                    "toolNo": "T003",
                    "toolName": "子任务2-工序1",
                    "toolLocation": {
                        "x": 100,
                        "y": 200
                    }
                }
            ]
        },
        {
            "taskExtendList": [],
            "signSiteName": "",
            "modeOrder": 2,
            "projectNo": "UI项目默认",
            "assignedUserType": 1,
            "assignedUser": "17791717398",
            "ccPersonType": 6,
            "ccPerson": "0326test",
            "ownerType": 7,
            "owner": "0326test",
            "reviewRuleName": "QQ-dan",
            "beginTimestamp": "1652803200000",
            "endTimestamp": "1653055200000",
            "requiredStartTime": "1653062400000",
            "requiredEndTime": "1653926400000",
            "taskRemark": "",
            "collectionReviewName": "",
            "priority": "",
            "jobDuration": "",
            "projectDuration": "",
            "schedulingMode": "",
            "administrativeDivisionName": "",
            "address": "",
            "skill": "证",
            "customerName": "",
            "procedureList": []
        }
    ]
}

响应示例

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

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 任务进展管理

上一篇：新增任务（API名称：createTask）

下一篇：批量创建父子任务（API名称：batchCreateSubTaskList）

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

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

智能客服提问云社区提问

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

功能介绍

相关接口

请求头

URL

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

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

7*24

备案

专业服务

退订

建议反馈

售前咨询热线