Запрос списка объектов и точек учета с настройками аскуэ
запрос: entek/api/docs/objects/ascue_set
Запрос списка объектов и их точек учета. Ответ содержит в себе информацию о названии объекта, серийный номер точки учета, идентификаторы в базе данных объекта и каждой точки учета, настройки аскуэ.
Есть возможность запроса с применением фильтров, которые описываются в теле запроса в формате JSON. Значение переменной field является кодом столбца, который можно посмотреть в настройках таблицы в модуле Справочники (Если поле не является ссылкой, то перед кодом добавляется заглавная F, иначе - S). Все фильтры объединяются через логическое И. Если field или value отсутствуют или переданы с пустым значением, то фильтр не применяется. Если объекты не найдены, ответ будет содержать пустой массив objects.
При необходимости можно добавить дополнительную информацию об объекте из других колонок или из других журналов. Для этого в запрос добавляется переменная add_info, в которой содержится массив, описывающий путь до дополнительной информации. В структуре можно указать информацию о полях журнала объекты или передать информацию о связи с другим журналом. При добавлении информации из журнала объекты в структуре достаточно указать переменную fields, которая является массивом состоящем из кода параметра в базе данных и названием поля для ответа в JSON. Для добавления информации из другого связанного журнала в структуре надо указать код журнала в переменной doc, в переменной link указать связанные поля в виде <поле из журнала справочники>-<связанное поле из дополнительного журнала>, а также в переменной fields указать необходимы столбцы из дополнительного журнала.
Пример части запроса с указанием дополнительной информации:
|
"add_info": [
{
"doc": "51",
"fields": [
"F464-res",
"F465-hierarchy",
"F466-mrid"
],
"link": "F467-ID"
}
]
|
-
Настройки АСКУЭ объекта могут содержать следующие переменные: uspd_type, psw, ip1, port1, ip2, port2, link_type, timeout. Если Каких-то настроек нет, то значение переменной - пустая строка.
-
Настройки АСКУЭ точки учета могут содержать следующие переменные: tu_type, use_sn, res_type, addr, psw1, psw2, dev_id. Переменные tu_type, use_sn являются обязательными и всегда содержатся в ответе, остальные могут отсутствовать, если не заданы в базе данных.
Пример фильтра, передаваемого в теле запроса:
|
{
"filters": [
{
"field": "F406",
"value": "ТП"
},
{
"field": "F412",
"value": "Ивановский"
}
]
}
|
Пример ответа:
|
{
"objects": [
{
"id": 27722,
"name": "Меркурий 204",
"ascue": {
"uspd_type": "7",
"psw": "",
"ip1": "10.30.30.34",
"port1": "4002",
"ip2": "",
"port2": "30292",
"link_type": "2",
"timeout": "3000"
},
"tus": [
{
"id": 27723,
"serial": "",
"tu_id": "",
"ascue": {
"tu_type": "94",
"use_sn": "True",
"res_type": "1",
"addr": "80",
"psw1": "111111",
"psw2": "2222222222222222"
}
}
]
}
]
}
|