文档首页/ ISDP/ API参考/ API接口/ 作业对象管理/ 批量新增修改作业对象(API名称:batchAddAndUpdateTaskObject)
更新时间:2025-02-11 GMT+08:00
分享

批量新增修改作业对象(API名称:batchAddAndUpdateTaskObject)

功能介绍

用于批量新增修改作业对象

相关接口

接口名称

调用说明

获取Token

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

删除作业对象

如新增错误可进行删除

批量保存位置信息(API名称:address/batchSave)

位置批量保存(新增/修改)

按层级(下一层)查询位置信息(API名称:findPagedAddress)

位置分页查询(可根据位置ID/编码集合精确查询)

批量删除位置信息(API名称:address/batchDelete)

位置批量删除(位置有引用时不能删除)

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
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

相关文档