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

