文档首页/ 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
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档