# 新增任务（API名称：createTask） #### 功能介绍 该接口用于创建工单任务，工单任务可定义任务类型、字段、采集清单、审批流程、作业工序等，创建的任务可用于现场作业的管理。 #### 相关API | **接口名称** | **调用说明** | |:---|:---| | [获取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) | 创建任务后，可以调用该接口查询创建的任务。 | #### 调用流程 图1创建任务流程 ![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002490654856.png "点击放大") #### URL | **请求方式** | **HTTPS地址** | **服务架构** | **消息体类型** | |:---|:---|:---|:---| | POST | https://***isdp+域名***/openapi/v1/openSceneTask/createTask | 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 | 是 | 任务集合。 | | operUserId | Long | 否 | 操作人。 | | operUserNo | Long | 否 | 操作人账号。 | | customerTaskId | Long | 否 | 客户任务ID。 | | resource | String | 否 | 任务来源。 | | taskName | String | 是 | 任务名称。 | | sceneName | String | 是 | 任务场景名称。 | | sceneId | Long | 是 | 任务场景ID。 | | signSiteId | Long | 否 | 作业对象ID。 | | signSiteCode | String | 否 | 作业对象编码。 | | signSiteName | String | 否 | 作业对象名称。 | | projectNo | String | 否 | 项目编码。 | | projectName | String | 否 | 项目名称。 | | supplierName | String | 否 | 供应商。 | | assignedUserType | String | 否 | 执行人类型。 - 1：用户 - 2：群组 | | assignedUser | String | 否 | 执行人账号。 | | beginTimestamp | Long | 否 | 计划开始时间。 | | endTimestamp | Long | 否 | 计划完成时间。 | | requiredStartTime | Long | 否 | 要求开始时间。 | | requiredEndTime | Long | 否 | 要求完成时间。 | | projectDuration | String | 否 | 工期。 | | jobDuration | String | 否 | 标准时长。 | | adminOrganizationName | String | 是 | 组织单元名称。 | | adminOrganization | String | 是 | 组织单元编码。 | | administrativeDivision | String | 否 | 行政区域。 | | administrativeDivisionName | String | 否 | 行政区域名称。 说明： 支持输入多个值，多个值时用分号隔开。 | | regionName | String | 否 | 行政区域名称。 | | regionId | String | 否 | 行政区域ID。 | | regionPath | String | 否 | 行政区域路径。 | | skill | String | 否 | 技能。 | | address | String | 否 | 任务地址（最多1000个字符）。 | | templateId | Long | 否 | 模板ID。 | | templateCode | String | 否 | 模板编码。 | | templateName | String | 否 | 模板名称。 | | version | String | 否 | 版本。 | | reviewRuleId | Long | 否 | 任务申请审批流ID。 | | reviewRuleName | String | 否 | 任务申请审批流名称。 | | taskRemark | String | 否 | 任务备注。 | | isAppraisal | String | 否 | 任务是否需要审批。 - 0：不需要审批 - 1：需要审批 | | collectionReviewId | Long | 否 | 采集审批流ID。 | | collectionReviewName | String | 否 | 采集审批流名称。 | | collectionProcessType | String | 否 | 采集审批流类型。 - 0：标准审批流 - 1：临时审批流 - 2：自定义审批流 | | priority | String | 否 | 优先级。 | | schedulingMode | String | 否 | 调度模式。 | | customerName | String | 否 | 客户名称。 | | customerId | String | 否 | 客户ID。 | | operationGuideList | List | 否 | 操作指导。 | | attachmentList | List | 否 | 附件。 | | taskMode | String | 是 | 任务模式。 - 1：简单任务 - 2：任务下挂检查单 | | saveDraft | String | 是 | 保持草稿、提交。 - 0：保存草稿 - 1：提交 | | taskExtendList | List | 否 | 任务扩展属性。 | | url | String | 否 | 待办地址。 | | thirdUrl | String | 否 | 第三方待办地址。 | | geoType | String | 否 | 经纬度类型（值只能为BD或者为空） | | longitude | String | 否 | 任务经度信息 | | latitude | String | 否 | 任务纬度信息 | | isCustomerTaskIdDuplicate | String | 否 | 是否允许客户任务ID重复，Y:允许，N,不允许重复 为空或默认为N，不允许重复 | | Toolset | List\ | 否 | 工具集 | taskExtendList列表入参： | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | fieldName | String | 是 | 拓展属性字段名称 | | extendValue | String | 是 | 拓展属性值（如果是时间和日期，值必须是时间戳） | | stage | Integer | 否 | 任务扩展属性阶段：1创建阶段 2：执行阶段 不填或没有该字段时默认为创建阶段 | 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 | 返回的失败消息。 | #### 请求示例 ``` { "taskQueries": [ { "supplierName": "", "taskRemark": "", "beginTimestamp": "", "collectionReviewName": "", "sceneName": "openApi-简单任务场景", "latitude": "23.456", "signSiteName": "bzh00201", "customerTaskId": "1255d-104456789123789001026", "projectNo": "", "assignedUserType": "1", "geoType": "BD", "reviewRuleName": "人员数量", "taskName": "简单任务012", "assignedUser": "15080988442", "endTimestamp": "", "taskExtendList": "", "longitude": "123.456", "toolSet": [ { "toolNo": "T003", "toolName": "子任务2-工序1", "toolLocation": { "x": 100, "y": 200 }, "toolAttrList": [ { "attrName": "显示名称", "attrCode": "displayName", "attrValue": "子任务2-工序1" } ] } ] } ] } ``` #### 响应示例 ``` { "stateCode": "0", "errorMessage": null, "result": [ { "status": "0", "message": "保存成功", "customerTaskId": null, "taskId": 2900025 } ] } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。 #### 错误码 错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。