批量新增修改作业对象(API名称:batchAddAndUpdateTaskObject)
功能介绍
用于批量新增修改作业对象
相关接口
| 接口名称 | 调用说明 |
|---|---|
| 调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 | |
| 如新增错误可进行删除 | |
| 位置批量保存(新增/修改) | |
| 位置分页查询(可根据位置ID/编码集合精确查询) | |
| 位置批量删除(位置有引用时不能删除) |
URL
| 请求方式 | HTTPS地址 | 服务架构 | 消息体类型 |
|---|---|---|---|
| POST | https://isdp+域名/openapi/v1/taskObjectFacede/batchAddAndUpdateTaskObject | OpenAPI | application/json |
请求头
| KEY | VALUE | 是否必填 | 描述 |
|---|---|---|---|
| Content-Type | application/json | 是 | 无 |
| Authorization | bearer ${access_token} | 是 | bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| signSiteModels | object | 是 | data如下(批量条数不能超过5条) |
Data入参:
| 字段名 | 字段类型 | 是否必填 | 字段名称 |
|---|---|---|---|
| signSiteCode | String | 是 | 作业对象编码 |
| signSiteName | String | 是 | 作业对象名称 |
| signSiteType | String | 否 | 位置类型编码(对应数据字典:QC_LOCATION_TYPE 中的编码) |
| customerCode | String | 否 | 客户编码 |
| supplierCode | String | 否 | 供应商编码 |
| secret | String | 否 | 是否敏感编码(0/1,否/是,默认0) |
| ownerCode | String | 否 | 责任人编码(与责任群组编码不能同时录入,多个时以英文逗号分隔(如:“code1,code2”),如果同时为空,将清除责任人) |
| ownerGroupCode | String | 否 | 责任群组编码(与责任人编码不能同时录入,如果同时为空,将清除责任人) |
| orgNo | String | 否 | 组织编码 |
| projectNo | String | 否 | 项目编码 |
| adminRegionName | String | 否 | 区域位置编码 |
| positionSystem | String | 否 | 定位系统类型 |
| longitude | String | 否 | 经度(与coordinateType=GPS配套传参) |
| latitude | String | 否 | 纬度(与coordinateType=GPS配套传参) |
| coordinate | String | 否 | 位置坐标xyz(与coordinateType= UWB配套传参,值格式:x坐标, y坐标, z坐标。如"10,20,30") |
| signSiteAddress | String | 否 | 站点(位置)详细地址 |
| taskObjectGroupId | Long | 否 | 作业对象分组Id |
| signSiteParentId | Long | 否 | 上级作业对象Id |
| signSiteParentNo | String | 否 | 上级作业对象编码(优先根据id校验) |
| deviceId | String | 否 | 设备Id |
| deviceTypeId | String | 否 | 设备类型Id |
| signSiteSource | String | 否 | 第三方数据来源 |
| udfExtend1 | String | 否 | 扩展属性1 |
| udfExtend2 | String | 否 | 扩展属性2 |
| udfExtend3 | String | 否 | 扩展属性3 |
| udfExtend4 | String | 否 | 扩展属性4 |
| udfExtend5 | Date | 否 | 扩展属性5(日期格式:yyyy-MM-dd) |
| udfExtend6 | Date | 否 | 扩展属性6(日期格式:yyyy-MM-dd) |
| udfExtend7 | String | 否 | 扩展属性7 |
| udfExtend8 | String | 否 | 扩展属性8 |
| udfExtend9 | String | 否 | 扩展属性9 |
| udfExtend10 | String | 否 | 扩展属性10 |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| stateCode | String | 处理结果(0代表success) |
| errorMessage | String | 错误消息 |
| result | Object | 返回结果 |
请求示例
{
"signSiteModels": [
{
"signSiteCode": "hzjTestSite001",
"signSiteName": "hzj测试作业对象名称001",
"signSiteType": "5",
"customerCode": "hzjTestCustomer001",
"supplierCode": "hzjTestSupplier001",
"secret": "0",
"ownerCode": "15820553632",
"ownerGroupCode": "",
"orgNo": "software",
"projectNo": "hzjTestProject001",
"adminRegionName": "hzjTest1",
"positionSystem": "GPS",
"longitude": "114.114449",
"latitude": "22.604495",
"coordinate": "",
"signSiteAddress": "深圳东站 ? 广东省深圳市龙岗区布吉街道吉华路94号",
"taskObjectGroupId": 5000117,
"signSiteParentId": 9911494962,
"signSiteParentNo": null,
"deviceId": null,
"deviceTypeId ": null,
"sighSiteSource": null,
"udfExtend1": "udf1",
"udfExtend2": "udf2",
"udfExtend3": "udf3",
"udfExtend4": "udf4",
"udfExtend5": "2024-09-21",
"udfExtend6": "2024-09-21",
"udfExtend7": "udf7",
"udfExtend8": "udf8",
"udfExtend9": "udf9",
"udfExtend10": "udf10"
},
{
"signSiteCode": "hzjTestSite002",
"signSiteName": "hzj测试作业对象名称002",
"signSiteType": "5",
"customerCode": "hzjTestCustomer001",
"supplierCode": "hzjTestSupplier001",
"secret": "0",
"ownerCode": "15820553632",
"ownerGroupCode": "",
"orgNo": "software",
"projectNo": "hzjTestProject001",
"adminRegionName": "hzjTest2",
"positionSystem": "UWB",
"longitude": null,
"latitude": null,
"coordinate": "10,20,30",
"signSiteAddress": "",
"taskObjectGroupId": 5000117,
"signSiteParentId": 9911494962,
"signSiteParentNo": null,
"deviceId": null,
"deviceTypeId ": null,
"sighSiteSource": null,
"udfExtend1": "udf1",
"udfExtend2": "udf2",
"udfExtend3": "udf3",
"udfExtend4": "udf4",
"udfExtend5": "2024-09-21",
"udfExtend6": "2024-09-21",
"udfExtend7": "udf7",
"udfExtend8": "udf8",
"udfExtend9": "udf9",
"udfExtend10": "udf10"
},
{
"signSiteCode": "hzjTestSite003",
"signSiteName": "hzj测试作业对象名称003",
"signSiteType": "5",
"customerCode": "hzjTestCustomer001",
"supplierCode": "hzjTestSupplier001",
"secret": "0",
"ownerCode": "15820553632",
"ownerGroupCode": "",
"orgNo": "software",
"projectNo": "hzjTestProject001",
"adminRegionName": "hzjTest3",
"positionSystem": "",
"longitude": "",
"latitude": "",
"coordinate": "",
"signSiteAddress": "",
"taskObjectGroupId": 5000117,
"signSiteParentId": 9911494962,
"signSiteParentNo": null,
"deviceId": null,
"deviceTypeId ": null,
"sighSiteSource": null,
"udfExtend1": "udf1",
"udfExtend2": "udf2",
"udfExtend3": "udf3",
"udfExtend4": "udf4",
"udfExtend5": "2024-09-21",
"udfExtend6": "2024-09-21",
"udfExtend7": "udf7",
"udfExtend8": "udf8",
"udfExtend9": "udf9",
"udfExtend10": "udf10"
}
]
} 响应示例
{
"status": "success",
"msg": null,
"data": null,
"success": true,
"failed": false
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。