查询所有项目的告警详细信息
| 参数 | 描述 | 必选 |
|---|---|---|
| action | webQueryPlantsWarning | 是 |
| i18n | 国际化语言, 见多语言支持 | 是 |
| id | 告警编码唯一标识 | 否 |
| pn | 数采器编码, 模糊搜索 | 否 |
| sn | 设备序列号, 模糊搜索 | 否 |
| level | 告警级别, 如果不传递此参数, 表示不关心 | 否 |
| handle | 是否已处理, true ? 已处理 : 未处理, 如果不传递此参数, 表示不关心 | 否 |
| devtype | 设备类型 | 否 |
| uname | 所属项目业主， 如果不传递此参数，表示不关心 | 否 |
| pname | 所属项目， 如果不传递此参数，表示不关心 | 否 |
| plantid | 项目id, 查询项目（单一查询） | 否 |
| province | 省，查询省下面的所有告警详细信息（单一查询） | 否 |
| city | 市，查询市下面的所有告警信息（单一查询） | 否 |
| county | 区县，查询区县下面的所有告警信息（单一查询） | 否 |
| town | 乡镇，查询乡镇下面的所有告警信息（单一查询） | 否 |
| sdate | 起始时间(零时区, 由于各个项目的时区可能不尽相同, 这里统一以零时区为标准), 格式: yyyy-mm-dd hh:mi:ss, 如果不传递此参数, 表示不关心 | 否 |
| edate | 截止时间(零时区), 格式:yyyy-mm-dd hh:mi:ss, 如果不传递此参数, 表示不关心,sdate与edate必需同时存在,查询时使用半开区间, 即 sdate <= date < edate | 否 |
| mode | strict模式为严格按照时间区间筛选模式，否则遵循默认返回规则，返回规则说明文档底部 | 否 |
| page | 分页处理, 第几页, 从0开始, 如果不传递此参数, 则被默认为0 | 否 |
| pagesize | 分页处理, 每页的告警数, 1 ~ 50, 如果不传递此参数, 则被默认为1 | 否 |
响应:
| 参数 | 描述 | 必选 |
|---|---|---|
| total | 告警总数 | 是 |
| page | 分页处理, 第几页 | 是 |
| pagesize | 分页处理, 每页的告警数 | 是 |
| warning[x].id | 告警唯一标识 | 是 |
| warning[x].uid | 项目业主id, 可能为0, 设备发生告警时还不属于任何项目业主 | 是 |
| warning[x].pid | 设备发生告警时可能还没有被添加到任何项目 | 否 |
| warning[x].usr | 项目业主名称, 设备发生告警时还不属于任何项目业主 | 否 |
| warning[x].plant | 项目名称, 设备发生告警时可能还没有被添加到任何项目 | 否 |
| warning[x].pn | 数采器编号 | 是 |
| warning[x].devcode | 设备协议编码 | 是 |
| warning[x].devaddr | 设备地址(485总线) | 是 |
| warning[x].sn | 设备序列号 | 是 |
| warning[x].ratingPower | 设备额定功率 | 是 |
| warning[x].alias | 设备别名 | 是 |
| warning[x].calias | 采集器别名 | 是 |
| warning[x].status | 是否为基于设备运行状态的告警 ? true : false | 是 |
| warning[x].level | 告警级别 | 是 |
| warning[x].code | 告警编码 | 否 |
| warning[x].desc | 告警描述 | 是 |
| warning[x].handle | 告警已处理 ? true : false | 是 |
| warning[x].gts | 告警产生时间, 格式为: yyyy-mm-dd hh:mi:ss, 设备时区 | 是 |
| warning[x].cts | 告警消失时间, 格式为: yyyy-mm-dd hh:mi:ss, 设备时区 | 否 |
{
"err":0,
"desc":"ERR_NONE",
"dat":{
"total":39,
"page":0,
"pagesize":1,
"warning":[
{
"id":"597191a57044a472daff1eb8",
"uid":7638,
"pid":12463,
"plant":"卢兴海10kw",
"pn":"G0617263366500",
"devcode":608,
"devaddr":1,
"sn":"3804172500004",
"ratingPower":"60.0000",
"status":true,
"level":2,
"desc":"设备状态:故障",
"handle":true,
"gts":"2017-07-21 13:26:15",
"cts":"2017-08-13 07:30:53"
}
]
}
}
可能出现的错误:
| 返回错误码 | 描述 | 详细描述 |
|---|---|---|
| 0x0006 | ERR_FORMAT_ERROR | 参数错误 |
| 0x0007 | ERR_MISSING_PARAMETER | 缺少必要的参数 |
| 0x0104 | ERR_NOT_FOUND_PLANT | 找不到项目 |
| 0x0105 | ERR_NOT_FOUND_USR | 找不到用户 |
| 0x0108 | ERR_NOT_FOUND_DEVICE_WARNING | 找不到设备告警 |
该接口默认返回的规则是：
- 对于处理状态有约束的情况： a.如果查询已处理的告警那么就按照正常的查询条件去查 b.如果查询未处理的告警并且有起始时间约束那么就把之前所有的未处理告警查询出来
- 对于处理状态无约束的情况： a.如果有起始时间约束，那么就将时间约束内的所有告警查询出来，同时也将时间约束外的所有未处理告警查询出来