新增父子任务(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 } }
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。