新增工序任务（API名称：createProcedureTask）
功能介绍
用于用户系统创建工序任务。
相关接口
|
接口名称 |
调用说明 |
|---|---|
|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
|
|
调用该接口获取到任务场景的场景名称。 创建任务时，需要输入获取到的场景名称。 |
|
|
调用该接口获取执行人。 创建任务时，任务模式为“启用子任务”时，需要输入获取到执行人；其他任务模式“执行人”为空则提交后为“待调度”状态，“执行人”填写后提交为“待执行”或“任务申请待审批”状态。 |
|
|
创建任务后，可以调用该接口查询创建的任务。 |
URL
|
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
|
POST |
https://isdp+域名/openapi/v1/openSceneTask/createProcedureTask |
OpenAPI |
application/json |
请求头
|
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
|
Content-Type |
application/json |
是 |
无 |
|
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
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 |
否 |
客户名称 |
|
taskExtendList |
List<Object> |
否 |
拓展属性列表 |
|
procedureList |
List<Object> |
否 |
工序列表，这里只可以给对应的工序配置采集审批流。 |
|
Toolset |
List<TaskToolVO> |
否 |
工具集 |
taskExtendList列表入参：
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
fieldName |
String |
是 |
拓展属性字段名称 |
|
extendValue |
String |
是 |
拓展属性值（如果是时间和日期，值必须是时间戳） |
procedureList列表入参：
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
modeOrder |
Int |
是 |
序号，从1开始，对应场景配置的序号 |
|
collectionReviewName |
Long |
否 |
检查单采集审批流名称，需要审批时为必填（只有挂检查单的场景才有） |
|
Toolset |
List<TaskToolVO> |
否 |
工具集 |
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": 1667986503488,
"taskName": "1667986503734lwc测试",
"signSiteName": "",
"creatorAccount": "17791717398",
"sceneName": "新建工序-测试",
"projectNo": "",
"assignedUserType": 1,
"assignedUser": "13229474258",
"reviewRuleName": "",
"beginTimestamp": "",
"endTimestamp": "",
"requiredStartTime": "",
"requiredEndTime": "",
"taskRemark": "",
"priority": "",
"jobDuration": "",
"projectDuration": "",
"schedulingMode": "",
"administrativeDivisionName": "1508098844233300",
"address": "",
"skill": "",
"customerName": "",
"supplierName": "",
"taskExtendList": [],
"toolSet": [
{
"toolNo": "T003",
"toolName": "子任务2-工序1",
"toolLocation": {
"x": 100,
"y": 200
}
}
],
"procedureList": [
{
"modeOrder": "1",
"collectionReviewName": "",
"toolSet": [
{
"toolNo": "T003",
"toolName": "子任务2-工序1",
"toolLocation": {
"x": 100,
"y": 200
}
}
]
}
]
}
响应示例
{
"stateCode": "0",
"errorMessage": null,
"result": {
"customerTaskId": "1667986503488",
"subTaskOrNot": 0,
"procedureOrNot": 1,
"ticketId": 0,
"tenantId": 1463,
"sceneMode": 3,
"reviewRuleId": null,
"isApplyApprove": 0,
"reviewRuleName": "",
"licenseSwitch": null,
"status": 1,
"deleteFlag": 0,
"submitBy": 1823,
"submitName": "superman",
"submitDate": 1667986531707,
"creationDate": 1667986531987,
"creationTimestamp": 1667986531707,
"createName": "张三",
"createdBy": 1957,
"lastUpdateTimestamp": 1667986531707,
"lastUpdateDate": 1667986531987,
"lastUpdateName": "张三",
"lastUpdatedBy": 1957,
"schedulerTimestamp": 1667986531707,
"schedulerDate": 1667986531707,
"operationTimestamp": 1667986531707,
"signInConfig": null,
"schedulerName": "OpenApi",
"schedulerBy": -1,
"entityName": "SceneTask",
"sceneTaskId": 5005759,
"appName": "isdp-task-server",
"affectedRows": 1
}
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
