新增检查单（API名称：createTask）
功能介绍
该接口用于创建检查单任务，包括视频检查单、巡检检查单、质检检查单等，创建的检查单可用于现场检查单作业的管理。
相关接口
接口名称 |
调用说明 |
|---|---|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
|
调用该接口获取执行人。 创建检查单时，需要输入执行人。 |
|
调用该接口获取项目编码。 创建检查单时，需要输入项目编码。 |
|
调用该接口获取作业模板编码。 创建检查单时，需要输入作业模板编码。 |
|
调用该接口查询更新检查单。 |
|
调用该接口查询检查单状态。 |
|
调用该接口可以删除已经创建的检查单。 |
调用流程
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的值 |
请求参数
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
customerTaskId |
String |
必填 |
客户检查单ID |
taskName |
String |
必填 |
检查单名称 |
taskSheetType |
int |
必填 |
检查单类型：
|
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 |
必填 |
执行人类别：
|
assignedUserName |
String |
必填 |
执行人账号或群组名称，多个用分号分隔（EHS不支持群组） 获取执行人API请参见：查询租户下用户信息（API名称：getPersonListByTenant） |
isReview |
int |
否 |
是否需要评审：
|
reviewUserAccountLevelOne |
String |
否 |
L1评审人账号，多个用分号分隔（EHS不涉及评审） |
levelOneIsOnlineReview |
int |
否 |
L1是否随机审批：
|
reviewUserAccountLevelTwo |
String |
否 |
L2评审人账号，多个用分号分隔（EHS不涉及评审） |
levelTwoIsOnlineReview |
int |
否 |
L2是否随机审批（EHS不涉及评审）
|
reviewUserAccountLevelThree |
String |
否 |
L3评审人账号，多个用分号分隔（EHS不涉及评审） |
响应参数
参数 |
类型 |
描述 |
|---|---|---|
stateCode |
String |
响应状态码：
|
errorMessage |
String |
响应描述 |
result |
List<Object> |
响应结果内容List，数量对应入参的数量，result:{} |
result出参：
参数 |
类型 |
描述 |
|---|---|---|
customerTaskId |
String |
客户检查单ID |
taskId |
Long |
检查单id |
status |
int |
返回状态：
|
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
}
]
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
