sx/map

获取设备列表接口修改;

2024-10-28 10:56:15 +08:00

24 KiB

Raw Permalink Blame History

设备相关模块

API接口一览表

接口分类	接口描述	API接口	权限
2.1设备类型	2.1.1获取所有设备类型信息	/api/equipment/type/list
2.2物模型	2.2.1获取物模型列表	/api/equipment/model/list
	2.2.2物模型新增	/api/equipment/model/add	SYS_AUTHORITY_ID_ADMIN
	2.2.3物模型修改	/api/equipment/model/update	SYS_AUTHORITY_ID_ADMIN
	2.2.4物模型删除	/api/equipment/model/delete	SYS_AUTHORITY_ID_ADMIN
2.2物模型属性	2.2.5获取物模型属性列表	/api/equipment/model/attribute/list
	2.2.6物模型属性新增	/api/equipment/model/attribute/add	SYS_AUTHORITY_ID_ADMIN
	2.2.7物模型属性修改	/api/equipment/model/attribute/update	SYS_AUTHORITY_ID_ADMIN
	2.2.8物模型属性删除	/api/equipment/model/attribute/delete	SYS_AUTHORITY_ID_ADMIN
2.2物模型方法	2.2.9获取物模型方法列表	/api/equipment/model/service/list
	2.2.10物模型方法新增	/api/equipment/model/service/add	SYS_AUTHORITY_ID_ADMIN
	2.2.11物模型方法修改	/api/equipment/model/service/update	SYS_AUTHORITY_ID_ADMIN
	2.2.12物模型方法删除	/api/equipment/model/service/delete	SYS_AUTHORITY_ID_ADMIN
	2.2.13 Excel导出物模型属性和方法	/api/equipment/model/export
	2.2.14 Excel导入物模型属性和方法	/api/equipment/model/import	SYS_AUTHORITY_ID_ADMIN
2.3设备台账	2.3.1 设备不分页查询	/api/equipment/list	SYS_AUTHORITY_ID_DEVICE_VIEW
	2.3.2 设备分页查询	/api/equipment/query	SYS_AUTHORITY_ID_DEVICE_VIEW
	2.3.3 设备新增	/api/equipment/add	SYS_AUTHORITY_ID_DEVICE_MGR
	2.3.4 设备修改	/api/equipment/update	SYS_AUTHORITY_ID_DEVICE_MGR
	2.3.5 设备删除	/api/equipment/delete	SYS_AUTHORITY_ID_DEVICE_MGR
	2.3.6 Excel导出设备清单	/api/equipment/export	SYS_AUTHORITY_ID_DEVICE_VIEW
	2.3.7 Excel导入设备清单	/api/equipment/import	SYS_AUTHORITY_ID_DEVICE_MGR
	2.3.8 获取设备树	/api/equipment/getEquipmentTree
	2.3.9 获取所有设备类型	/api/equipment/type

2.1 设备类型相关接口

2.1.1 获取所有设备类型信息

POST 请求接口

/api/equipment/type/list

请求参数

无

返回报文

{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": [
		{
			"equipmentTypeId": "10001",
			"equipmentTypeName": "风电场"
		},
		{
			"equipmentTypeId": "10002",
			"equipmentTypeName": "机组"
		}
	]
}

2.2 物模型相关接口

2.2.1 获取物模型列表

POST 请求接口

/api/equipment/model/list

请求参数

{
    "objectType":"10002",
    "iotModelName":"倍福机组",
    "iotModelCode":"beckhoff"    
}

入参描述

参数名	参数类型	可选	描述
objectType	String	yes	设备类型ID
iotModelName	String	yes	物模型名称
iotModelCode	String	yes	物模型编码

返回报文

{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": [
		{
			"id": "123",
			"objectType": "10002",
			"iotModelCode": "beckhoff",
			"iotModelName": "倍福机组",
			"revision": 1,
			"createdBy": "admin",
			"createdTime": "2024-06-27 15:08:23",
			"updatedBy": "admin",
			"updatedTime": "2024-06-27 15:08:23"
		}
	]
}

注意：按设备类型、物模型名称进行排序

2.2.2物模型新增

POST 请求接口

/api/equipment/model/add

请求参数

{
    "objectType": "10002",
    "iotModelCode": "beckhoff",
    "iotModelName": "倍福机组",
    "revision": 1,
    "createdBy": "admin",
    "createdTime": "2024-06-27 15:08:23"
}

入参描述

参数名	参数类型	可选	描述
objectType	字符串	No	设备类型ID
iotModelCode	字符串	No	物模型编码
iotModelName	字符串	No	物模型名称
revision	数值	No	乐观锁
createdBy	字符串	Yes	创建人
createdTime	字符串	Yes	创建时间

返回报文

{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": [
		{
			"id": "123",
			"objectType": "10002",
			"iotModelCode": "beckhoff",
			"iotModelName": "倍福机组",
			"revision": 1,
			"createdBy": "admin",
			"createdTime": "2024-06-27 15:08:23",
			"updatedBy": "admin",
			"updatedTime": "2024-06-27 15:08:23"
		}
	]
}

2.2.3物模型修改

POST 请求接口

/api/equipment/model/update

请求参数

{
    "id": "123",
    "objectType": "10002",
    "iotModelCode": "beckhoff",
    "iotModelName": "倍福机组",
    "revision": 1,
    "createdBy": "admin",
    "createdTime": "2024-06-27 15:08:23"
}

入参描述

参数名	参数类型	可选	描述
id	字符串	No	主键ID
objectType	字符串	No	设备类型ID
iotModelCode	字符串	No	物模型编码
iotModelName	字符串	No	物模型名称
revision	数值	No	乐观锁
updatedBy	字符串	Yes	更新人
updatedTime	字符串	Yes	更新时间

返回报文

{
	"code": 200,
	"msg": "更新成功",
	"success": true
}

2.2.4物模型删除

POST 请求接口

/api/equipment/model/delete

请求参数

{
    "id": "123"
}

入参描述

参数名	参数类型	可选	描述
id	字符串	No	主键ID

返回报文

{
	"code": 200,
	"msg": "删除成功",
	"success": true
}

2.2.5获取物模型属性列表

POST 请求接口

/api/equipment/model/attribute/list

请求参数

{
    "iotModelId":"123",
    "pageNum":1,
    "pageSize": 30
}

入参描述

参数名	参数类型	可选	描述
iotModelId	String	yes	物模型ID
attributeName	String	yes	属性名称
attributeCode	String	yes	属性编码
attributeType	String	yes	量测类型
pageSize	数值	No	每页显示条数
pageNum	数值	No	页码

返回报文

{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": [
		{
			"id": "45678",
			"iotModelId": "123",
			"attributeCode": "grGenPowerForProcess",
			"attributeName": "发电机功率实时值",
            "attributeType":138,
            "porder":1,
			"revision": 1,
			"createdBy": "admin",
			"createdTime": "2024-06-27 15:08:23",
			"updatedBy": "admin",
			"updatedTime": "2024-06-27 15:08:23"
		}
	]
}

2.2.6物模型属性新增

POST 请求接口

/api/equipment/model/attribute/add

请求参数

{
    "iotModelId": "123",
    "attributeCode": "grGenPowerForProcess",
    "attributeName": "发电机功率实时值",
    "attributeType":138,
    "porder":1,
    "revision": 1,
    "createdBy": "admin",
    "createdTime": "2024-06-27 15:08:23"
}

入参描述

参数名	参数类型	可选	描述
iotModelId	字符串	No	所属物模型ID
attributeCode	字符串	No	属性编码
attributeName	字符串	No	属性名称
attributeType	数值	No	属性类型 138模拟量139累积量140离散量
porder	数值	No	顺序号
revision	数值	No	乐观锁
createdBy	字符串	Yes	创建人
createdTime	字符串	Yes	创建时间

返回报文

{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": [
		{
			"id": "45678",
            "iotModelId": "123",
            "attributeCode": "grGenPowerForProcess",
            "attributeName": "发电机功率实时值",
            "attributeType":138,
            "porder":1,
            "revision": 1,
            "createdBy": "admin",
            "createdTime": "2024-06-27 15:08:23",
            "updatedBy": "admin",
			"updatedTime": "2024-06-27 15:08:23"
		}
	]
}

2.2.7物模型属性修改

POST 请求接口

/api/equipment/model/attribute/update

请求参数

{
    "id": "45678",
    "iotModelId": "123",
    "attributeCode": "grGenPowerForProcess",
    "attributeName": "发电机功率实时值",
    "attributeType":138,
    "porder":1,
    "revision": 1,
    "updatedBy": "admin",
    "updatedTime": "2024-06-27 15:08:23"
}

返回报文

{
	"code": 200,
	"msg": "更新成功",
	"success": true
}

2.2.8物模型属性删除

POST 请求接口

/api/equipment/model/attribute/delete

请求参数

{
    "id": "45678"
}

入参描述

参数名	参数类型	可选	描述
id	字符串	No	主键ID

返回报文

{
	"code": 200,
	"msg": "删除成功",
	"success": true
}

2.2.9获取物模型方法列表

POST 请求接口

/api/equipment/model/service/list

请求参数

{
    "iotModelId":"123"
}

入参描述

参数名	参数类型	可选	描述
iotModelId	String	No	物模型ID

返回报文

{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": [
		{
			"id": "78901",
			"iotModelId": "123",
			"serviceCode": "grActivePowerSetPointValue",
			"serviceName": "功率设定值",
            "serviceType":146,
            "porder":1,
			"revision": 1,
			"createdBy": "admin",
			"createdTime": "2024-06-27 15:08:23",
			"updatedBy": "admin",
			"updatedTime": "2024-06-27 15:08:23"
		}
	]
}

2.2.10物模型方法新增

POST 请求接口

/api/equipment/model/service/add

请求参数

{
    "iotModelId": "123",
    "serviceCode": "grActivePowerSetPointValue",
    "serviceName": "功率设定值",
    "serviceType":146,
    "porder":1,
    "revision": 1,
    "createdBy": "admin",
    "createdTime": "2024-06-27 15:08:23"
}

入参描述

参数名	参数类型	可选	描述
iotModelId	字符串	No	所属物模型ID
serviceCode	字符串	No	方法编码
serviceName	字符串	No	方法名称
serviceType	数值	No	属性类型 146 遥调 147 遥控
porder	数值	No	顺序号
revision	数值	No	乐观锁
createdBy	字符串	Yes	创建人
createdTime	字符串	Yes	创建时间

返回报文

{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": [
		{
			"id": "78901",
            "iotModelId": "123",
            "serviceCode": "grActivePowerSetPointValue",
            "serviceName": "功率设定值",
            "serviceType":146,
            "porder":1,
            "revision": 1,
            "createdBy": "admin",
            "createdTime": "2024-06-27 15:08:23",
            "updatedBy": "admin",
			"updatedTime": "2024-06-27 15:08:23"
		}
	]
}

2.2.11物模型方法修改

POST 请求接口

/api/equipment/model/service/update

请求参数

{
    "id": "78901",
    "iotModelId": "123",
    "serviceCode": "grActivePowerSetPointValue",
    "serviceName": "功率设定值",
    "serviceType":146,
    "porder":1,
    "revision": 1,
    "updatedBy": "admin",
    "updatedTime": "2024-06-27 15:08:23"
}

返回报文

{
	"code": 200,
	"msg": "更新成功",
	"success": true
}

2.2.12物模型方法删除

POST 请求接口

/api/equipment/model/service/delete

请求参数

{
    "id": "78901"
}

入参描述

参数名	参数类型	可选	描述
id	字符串	No	主键ID

返回报文

{
	"code": 200,
	"msg": "删除成功",
	"success": true
}

2.2.13 Excel导出物模型属性和方法

POST 请求接口

/api/equipment/model/export

请求参数

{
    "id": "123"
}

入参描述

参数名	参数类型	可选	描述
id	字符串	No	物模型ID

返回 Excel文件，分成两个Sheet页，第一个sheet页是属性，第二个sheet页是方法，按【porder】排序显示

2.2.14 Excel导入物模型属性和方法

Excel导入

2.3 设备台账相关接口

2.3.1 设备不分页查询

POST请求接口

/api/equipment/list

请求参数

{
    "orgId":"1",
    "parentEquipmentId":"2",
    "objectType":"10001"
}

参数说明

参数名	参数类型	可选	描述
orgId	字符串	Yes	所属机构ID
parentEquipmentId	字符串	Yes	上级设备ID
objectType	字符串	No	设备类型

返回报文

{
	"code": 200,
	"msg": "操作成功",
	"success": true,
	"data": [
		{
			"id": "2017011807",
			"objectType": "10001",
			"code": "Station01",
			"name": "某某风电场",
			"madeinfactory": "生产厂家",
			"model": "规格型号",
			"location": "徐庄软件园",
			"longitude": 46.12345,
			"latitude": 137.01678,
			"installDate": "2024-06-27 15:08:23",
			"remarks": null,
			"orgId": "101",
			"parentEquipmentId": null,
			"iotModelId": "45678",
			"revision": 1,
			"createdBy": "admin",
			"createdTime": "2024-06-27 15:08:23",
			"updatedBy": "admin",
			"updatedTime": "2024-06-27 15:08:23"
		}
	]
}

2.3.2 设备分页查询

/api/equipment/query

请求参数

{
  "orgId": 1,
  "parentEquipmentId": 1,
  "iotModelId": "",
  "pageSize": 1,
  "pageNum": 1
}

入参描述

参数名	参数类型	可选	描述
orgId	数值	yes	所属机构ID
parentEquipmentId	数值	yes	上级设备ID
iotModelId	字符串	yes	所属物模型ID
pageSize	数值	No	每页显示条数
pageNum	数值	No	页码

返回报文

{
  "total": 1,
  "rows": [
    {
      "id": "1809032537527582721",
      "objectType": 1,
      "code": "test",
      "name": "test",
      "madeinFactory": "test",
      "model": "test",
      "location": "test",
      "longitude": 48.69145,
      "latitude": 20.6946,
      "installDate": "2027-04-05 15:30:23",
      "remarks": "test",
      "orgId": "1",
      "parentEquipmentId": "1"
    }
  ],
  "code": 200,
  "msg": "查询成功"
}

2.3.3 设备新增

/api/equipment/add

请求参数

{
  "objectType": 1,
  "code": "test",
  "name": "test",
  "madeinFactory": "test",
  "model": "test",
  "location": "test",
  "longitude": 48.69145,
  "latitude": 20.6946,
  "installDate": "2027-04-05 15:30:23",
  "remarks": "test",
  "orgId": 1,
  "parentEquipmentId": 1,
  "iotModelId": ""
}

入参描述

参数名	参数类型	可选	描述
objectType	数值	No	设备类型
code	字符串	No	设备编码
name	字符串	No	设备名称
madeinFactory	字符串	No	生产厂家
model	字符串	No	规格型号
location	字符串	No	位置
longitude	数值	No	经度
latitude	数值	No	纬度
installDate	字符串	No	安装日期
remarks	字符串	Yes	备注
orgId	数值	No	所属机构ID
parentEquipmentId	数值	No	上级设备ID
iotModelId	字符串	No	所属物模型ID

返回报文

{
  "code": 200,
  "success": true,
  "data": {
    "id": "1809029597391814657",
    "objectType": 1,
    "code": "test",
    "name": "test",
    "madeinFactory": "test",
    "model": "test",
    "location": "test",
    "longitude": 48.69145,
    "latitude": 20.6946,
    "installDate": "2027-04-05 15:30:23",
    "remarks": "test",
    "orgId": "1",
    "parentEquipmentId": "1"
  },
  "msg": "操作成功"
}

2.3.4 设备修改

/api/equipment/update

请求参数

{
  "id":1809029597391814657,
  "objectType": 1,
  "code": "test1",
  "name": "test1",
  "madeinFactory": "test1",
  "model": "test1",
  "location": "test1",
  "longitude": 48.69145,
  "latitude": 20.6946,
  "installDate": "2027-07-05 15:30:23",
  "remarks": "test1",
  "orgId": 1,
  "parentEquipmentId": 1,
  "iotModelId": ""
}

返回报文

{
  "code": 200,
  "success": true,
  "data": {
    "id": "1809029597391814657",
    "objectType": 1,
    "code": "test1",
    "name": "test1",
    "madeinFactory": "test1",
    "model": "test1",
    "location": "test1",
    "longitude": 48.69145,
    "latitude": 20.6946,
    "installDate": "2027-07-05 15:30:23",
    "remarks": "test1",
    "orgId": "1",
    "parentEquipmentId": "1"
  },
  "msg": "操作成功"
}

2.3.5 设备删除

/api/equipment/delete

请求参数

{
    "id":1809029597391814657
}

返回报文

    {
	"code": 200,
	"success": true,
	"msg": "操作成功"
}

2.3.6 Excel导出设备清单

/api/equipment/export

2.3.7 Excel导入设备清单

/api/equipment/import

2.3.8 获取设备树

/api/equipment/getEquipmentTree

请求参数

{
  "orgId":1
}

返回报文

{
  "code": 200,
  "success": true,
  "data": [
    {
      "id": "2",
      "objectType": 10002,
      "code": "10002",
      "name": "机组",
      "longitude": 0,
      "latitude": 0,
      "parentEquipmentId": "0",
      "equipChildren": [
        {
          "createdBy": "测试",
          "createdTime": "2024-07-08 06:50:32",
          "updatedBy": "测试",
          "updatedTime": "2024-07-08 06:50:32",
          "revision": 1,
          "id": "1810204805816188930",
          "objectType": 10002,
          "code": "",
          "name": "GGG",
          "madeinFactory": "",
          "model": "",
          "location": "",
          "longitude": 0,
          "latitude": 0,
          "remarks": "",
          "orgId": "1",
          "parentEquipmentId": "2"
        },
        {
          "createdBy": "测试",
          "createdTime": "2024-07-08 06:52:44",
          "updatedBy": "测试",
          "updatedTime": "2024-07-08 06:52:44",
          "revision": 1,
          "id": "1810205361720852481",
          "objectType": 10002,
          "code": "",
          "name": "RRR",
          "madeinFactory": "",
          "model": "",
          "location": "",
          "longitude": 0,
          "latitude": 0,
          "remarks": "",
          "orgId": "1",
          "parentEquipmentId": "2"
        },
        {
          "createdBy": "测试",
          "createdTime": "2024-07-08 06:53:07",
          "updatedBy": "测试",
          "updatedTime": "2024-07-08 15:01:33",
          "revision": 1,
          "id": "1810205456222715906",
          "objectType": 10002,
          "code": "test1",
          "name": "test1",
          "madeinFactory": "test1",
          "model": "test1",
          "location": "test1",
          "longitude": 48.69145,
          "latitude": 20.6946,
          "installDate": "2027-07-05 15:30:23",
          "remarks": "test1",
          "orgId": "1",
          "parentEquipmentId": "2"
        },
        {
          "createdBy": "测试",
          "createdTime": "2024-07-08 07:02:38",
          "updatedBy": "测试",
          "updatedTime": "2024-07-08 07:02:38",
          "revision": 1,
          "id": "1810207853032570881",
          "objectType": 10002,
          "code": "",
          "name": "12121",
          "madeinFactory": "",
          "model": "",
          "location": "",
          "longitude": 0,
          "latitude": 0,
          "remarks": "",
          "orgId": "1",
          "parentEquipmentId": "2"
        }
      ]
    },
    {
      "id": "1",
      "objectType": 10001,
      "code": "10001",
      "name": "风电场",
      "longitude": 0,
      "latitude": 0,
      "parentEquipmentId": "0",
      "equipChildren": [
        {
          "createdBy": "测试",
          "createdTime": "2024-07-08 06:41:56",
          "updatedBy": "测试",
          "updatedTime": "2024-07-08 06:41:56",
          "revision": 1,
          "id": "1810202642163499009",
          "objectType": 10001,
          "code": "",
          "name": "aaaa",
          "madeinFactory": "",
          "model": "",
          "location": "",
          "longitude": 0,
          "latitude": 0,
          "remarks": "",
          "orgId": "1",
          "parentEquipmentId": "1"
        },
        {
          "createdBy": "测试",
          "createdTime": "2024-07-08 06:45:09",
          "updatedBy": "测试",
          "updatedTime": "2024-07-08 06:45:09",
          "revision": 1,
          "id": "1810203450657538050",
          "objectType": 10001,
          "code": "",
          "name": "yy",
          "madeinFactory": "",
          "model": "",
          "location": "",
          "longitude": 0,
          "latitude": 0,
          "remarks": "",
          "orgId": "1",
          "parentEquipmentId": "1"
        }
      ]
    }
  ],
  "msg": "操作成功"
}

2.3.9 获取所有设备类型

/api/equipment/type

请求参数无请求参数

返回报文

{
	"code": 200,
	"success": true,
	"data": [
		{
			"equipmentTypeId": "10001",
			"equipmentTypeName": "风电场"
		},
		{
			"equipmentTypeId": "10002",
			"equipmentTypeName": "机组"
		}
	],
	"msg": "操作成功"
}

24 KiB Raw Permalink Blame History Unescape Escape

设备相关模块

API接口一览表

2.1 设备类型相关接口

2.1.1 获取所有设备类型信息

2.2 物模型相关接口

2.2.1 获取物模型列表

2.2.2物模型新增

2.2.3物模型修改

2.2.4物模型删除

2.2.5获取物模型属性列表

2.2.6物模型属性新增

2.2.7物模型属性修改

2.2.8物模型属性删除

2.2.9获取物模型方法列表

2.2.10物模型方法新增

2.2.11物模型方法修改

2.2.12物模型方法删除

2.2.13 Excel导出物模型属性和方法

2.2.14 Excel导入物模型属性和方法

2.3 设备台账相关接口

2.3.1 设备不分页查询

2.3.2 设备分页查询

2.3.3 设备新增

2.3.4 设备修改

2.3.5 设备删除

2.3.6 Excel导出设备清单

2.3.7 Excel导入设备清单

2.3.8 获取设备树

2.3.9 获取所有设备类型

24 KiB

Raw Permalink Blame History