文档首页/ ISDP/ API参考/ API接口/ 任务管理/ 作业标准管理/ 新增检查单（API名称：createTask）
更新时间：2024-07-22 GMT+08:00
查看PDF
分享

新增检查单（API名称：createTask）

功能介绍

该接口用于创建检查单任务，包括视频检查单、巡检检查单、质检检查单等，创建的检查单可用于现场检查单作业的管理。

相关接口

接口名称

调用说明

获取Token

调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。

查询租户下用户信息（API名称：getPersonListByTenant）

调用该接口获取执行人。

创建检查单时，需要输入执行人。

查询项目信息（API名称：findPagedProjectList）

调用该接口获取项目编码。

创建检查单时，需要输入项目编码。

查询模板列表

调用该接口获取作业模板编码。

创建检查单时，需要输入作业模板编码。

更新检查单

调用该接口查询更新检查单。

查询EHS检查单（API名称：findTask）

调用该接口查询检查单状态。

删除检查单

调用该接口可以删除已经创建的检查单。

调用流程

图1 创建检查单流程

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中获取的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）

projectName

String

否（需要新增项目时必填）

项目名称

customerName

String

否

客户名称

partner

String

否

供应商名称

type

String

否

业务类型

deliveryScene

String

否

交付场景（EHS不涉及）

productType

String

否

产品类别（EHS不涉及）

udf3

String

否

产品形态（EHS不涉及）

templateCode

String

是

作业模板编码

获取作业模板编码API请参见：查询模板列表（API名称：findTemplate）

templateName

String

否

作业模板名称

planBeginDate

Long

否

计划开始时间，时间戳

planEndDate

Long

否

计划完成时间，时间戳

remarks

String

否

备注

assignedUserType

int

是

执行人类别：

  • 1-个人
  • 2-群组（EHS不支持群组）

assignedUserName

String

是

执行人账号或群组名称，多个用分号分隔（EHS不支持群组）

获取执行人API请参见：查询租户下用户信息（API名称：getPersonListByTenant）

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<Object>

响应结果内容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
        }
    ]
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 作业标准管理

相关文档