# 新增工序任务（API名称：createProcedureTask） #### 功能介绍 用于用户系统创建工序任务。 #### 相关接口 | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 | | [查询任务场景](https://support.huaweicloud.com/api-isdp/api_01_0024.html) | 调用该接口获取到任务场景的场景名称。 创建任务时，需要输入获取到的场景名称。 | | [查询租户下用户信息（API名称：getPersonListByTenant）](https://support.huaweicloud.com/api-isdp/api_01_0109.html) | 调用该接口获取执行人。 创建任务时，任务模式为"启用子任务"时，需要输入获取到执行人；其他任务模式"执行人"为空则提交后为"待调度"状态，"执行人"填写后提交为"待执行"或"任务申请待审批"状态。 | | [查询父任务](https://support.huaweicloud.com/api-isdp/api_01_0037.html) | 创建任务后，可以调用该接口查询创建的任务。 | #### 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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的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\ | 否 | 拓展属性列表 | | procedureList | List\ | 否 | 工序列表，这里只可以给对应的工序配置采集审批流。 | | Toolset | List\ | 否 | 工具集 | taskExtendList列表入参： | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | fieldName | String | 是 | 拓展属性字段名称 | | extendValue | String | 是 | 拓展属性值（如果是时间和日期，值必须是时间戳） | procedureList列表入参： | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | modeOrder | Int | 是 | 序号，从1开始，对应场景配置的序号 | | collectionReviewName | Long | 否 | 检查单采集审批流名称，需要审批时为必填（只有挂检查单的场景才有） | | Toolset | List\ | 否 | 工具集 | toolSet入参 | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | id | Long | 否 | 主键id | | parentTaskId | Long | 否 | 父任务id | | toolNo | String | 是 | 工具编号 | | toolName | String | 是 | 工具名称 | | redirectUrl | String | 否 | 第三方工具跳转url | | extensionType | Integer | 否 | 扩展属性类型（1：表单；2：json） | | toolLocation | Map\ | 是 | 工具在画布中的位置json | | toolAttrList | Object | 否 | 工具扩展属性配置json | | NextToolList | List\\> | 否 | 拓展属性值（如果是时间和日期，值必须是时间戳） | #### 响应参数 | **参数** | **类型** | **描述** | |:---|:---|:---| | 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 } } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。 #### 错误码 错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。