新增检查单（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:{}

参数

类型

描述

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
        }
    ]
}