# 新增检查单（API名称：createTask） #### 功能介绍 该接口用于创建检查单任务，包括视频检查单、巡检检查单、质检检查单等，创建的检查单可用于现场检查单作业的管理。 #### 相关接口 | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 | | [查询租户下用户信息（API名称：getPersonListByTenant）](https://support.huaweicloud.com/api-isdp/api_01_0109.html) | 调用该接口获取执行人。 创建检查单时，需要输入执行人。 | | [查询项目信息（API名称：findPagedProjectList）](https://support.huaweicloud.com/api-isdp/api_01_0051.html) | 调用该接口获取项目编码。 创建检查单时，需要输入项目编码。 | | [查询模板列表](https://support.huaweicloud.com/api-isdp/api_01_0089.html) | 调用该接口获取作业模板编码。 创建检查单时，需要输入作业模板编码。 | | [更新检查单](https://support.huaweicloud.com/api-isdp/api_01_0076.html) | 调用该接口查询更新检查单。 | | [查询EHS检查单（API名称：findTask）](https://support.huaweicloud.com/api-isdp/api_01_0221.html) | 调用该接口查询检查单状态。 | | [删除检查单](https://support.huaweicloud.com/api-isdp/api_01_0076.html) | 调用该接口可以删除已经创建的检查单。 | #### 调用流程 图1创建检查单流程 ![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002522734593.png "点击放大") #### URL | **请求方式** | **HTTPS地址** | **服务架构** | **消息体类型** | |:---|:---|:---|:---| | POST | https://***isdp+域名***/openapi/v1/openTask/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 | Object | 是 | 任务查询 | | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | customerTaskId | String | 是 | 客户检查单ID | | taskName | String | 是 | 检查单名称 | | taskSheetType | int | 是 | 检查单类型： - 0-EHS视频 - 1-质量检查 - 2-巡检 | | signSiteCode | String | 是 | 作业对象编码 | | signSiteName | String | 否（需要新增作业对象时必填） | 作业对象名称 | | signSiteType | String | 否 | 作业对象类型，客户传入，按ISDP+中已配置的枚举写入，用英文key写 代维对应"作业对象级别" | | signSiteAddress | String | 否（需要新增作业对象时必填） | 作业对象详细地址，如果是新增的作业对象必填 | | adminRegion | String | 否 | 行政区域，传入国家省份城市名称，如：中国-广东-深圳 | | longitude | double | 否 | 经度 | | latitude | double | 否 | 维度 | | projectNo | String | 否 | 项目编码 获取项目编码API请参见：[查询项目信息（API名称：findPagedProjectList）](https://support.huaweicloud.com/api-isdp/api_01_0051.html) | | projectName | String | 否（需要新增项目时必填） | 项目名称 | | customerName | String | 否 | 客户名称 | | partner | String | 否 | 供应商名称 | | type | String | 否 | 业务类型 | | deliveryScene | String | 否 | 交付场景（EHS不涉及） | | productType | String | 否 | 产品类别（EHS不涉及） | | udf3 | String | 否 | 产品形态（EHS不涉及） | | templateCode | String | 是 | 作业模板编码 获取作业模板编码API请参见：[查询模板列表（API名称：findTemplate）](https://support.huaweicloud.com/api-isdp/api_01_0089.html) | | templateName | String | 否 | 作业模板名称 | | planBeginDate | Long | 否 | 计划开始时间，时间戳 | | planEndDate | Long | 否 | 计划完成时间，时间戳 | | remarks | String | 否 | 备注 | | assignedUserType | int | 是 | 执行人类别： - 1-个人 - 2-群组（EHS不支持群组） | | assignedUserName | String | 是 | 执行人账号或群组名称，多个用分号分隔（EHS不支持群组） 获取执行人API请参见：[查询租户下用户信息（API名称：getPersonListByTenant）](https://support.huaweicloud.com/api-isdp/api_01_0109.html) | | isReview | int | 否 | 是否需要评审： - 0-否 - 1-是 | | reviewUserAccountLevelOne | String | 否 | L1评审人账号，多个用分号分隔（EHS不涉及评审） | | levelOneIsOnlineReview | int | 否 | L1是否随机审批： - 0-否 - 1-是 | | reviewUserAccountLevelTwo | String | 否 | L2评审人账号，多个用分号分隔（EHS不涉及评审） | | levelTwoIsOnlineReview | int | 否 | L2是否随机审批（EHS不涉及评审） - 0-否 - 1-是 | | reviewUserAccountLevelThree | String | 否 | L3评审人账号，多个用分号分隔（EHS不涉及评审） | #### 响应参数 | **参数** | **类型** | **描述** | |:---|:---|:---| | stateCode | String | 响应状态码： - 0-成功 - 其他-失败 | | errorMessage | String | 响应描述 | | result | List\ | 响应结果内容List，数量对应入参的数量，result:{} | result出参： | **参数** | **类型** | **描述** | |:---|:---|:---| | customerTaskId | String | 客户检查单ID | | taskId | Long | 检查单id | | status | int | 返回状态： - 0-成功 - 1-失败 | | message | String | 返回的失败消息 | #### 请求示例 ``` { "taskQueries": [ { "customerTaskId": 2021042903, "taskName": "测试", "taskSheetType": 0, "signSiteCode": "加密", "signSiteName": "加密", "signSiteType": "", "adminRegion": "中国(CN)-XX市", "longitude": "126", "latitude": "26", "signSiteAddress": "作业对象的位置详细地址", "projectNo": "P001", "customerName": "", "partner": "null", "type": "asd", "deliveryScene": "", "productType": "", "templateCode": "EHS20210126105343752", "templateName": "安全监测-视频模板", "planBeginDate": "", "planEndDate": 1598324811850, "remarks": "检查单备注测试", "assignedUserType": "1", "assignedUserName": "18672783257", } ] } ``` #### 响应示例 ``` { "stateCode": "0", "errorMessage": "成功", "result": [ { "status": "0", "message": "保存成功", "customerTaskId": "2021042903", "taskId": 171149 } ] } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。 #### 错误码 错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。