新增父子任务（API名称：createSubTask）
功能介绍
用于用户系统创建父任务
相关接口
请求头
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 |
是 |
|
y |
int |
是 |
taskPreLocation参数说明：
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
x |
int |
是 |
|
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
}
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
