Модуль «ЖКХ-Контур»¶

Назначение модуля¶

Модуль предназначен для передачи данных (параметров работы источников и потребителей тепла, воды, электричества и т.д.) в формате JSON посредством REST API в ГИС «ЖКХ-Контур» — систему мониторинга инфраструктуры ЖКХ Московской области.

В настоящий момент для теплоснабжающих организаций, котельных и управляющих компаний Московской области передача данных в «ЖКХ-Контур» является обязательным требованием. В систему необходимо регулярно отправлять: температуру и давление в подающем и обратном трубопроводе; сведения об объекте и организации; данные о расходе теплоносителя.

Интерфейс модуля¶

Работа с модулем «ЖКХ-Контур» осуществляется через интерфейс, расположенный на вкладке «ЖКХ-Контур» в левом меню страницы вашей организации. Перейти на страницу организации можно, нажав на её название в правом верхнем углу окна.

Интерфейс содержит пять основных вкладок:

Конфигурации устройств — управление конфигурациями содержащими связки параметров устройств Системы и полей JSON отправляемых в «ЖКХ-Контур».
Поиск — поиск объектов по адресу, ID ФИАС или ИНН.
Просмотр экспорта — просмотр данных, отправляемых в «ЖКХ-Контур», в формате JSON.
Просмотр журнала — история отправки данных.
Настройки — параметры подключения к API «ЖКХ-Контур».

Алгоритм работы с модулем¶

Настройка¶

Во вкладке «Настройки» введите полученный токен (ключ) для передачи данных — «HTTP-X-API-TOKEN ЖКХ-Контур» — и нажмите кнопку «Сохранить». Токен является обязательным параметром для работы модуля. Его необходимо получить в ГИС «ЖКХ-Контур».

Создание конфигурации¶

1. Откройте окно создания¶

Перейдите на вкладку «Конфигурации устройств» и нажмите кнопку «Добавить» — откроется окно создания новой конфигурации.

2. Заполните поля¶

Укажите в соответствующих полях:

Устройство(1) — устройство из системы, данные которого будут передаваться. Поле автозаполняемое: начните вводить название (минимум 2 буквы) и выберите нужное устройство из появившегося списка.
ID объекта в ЖКХ-Контур(2) — идентификатор объекта в ГИС.
ID ФИАС(3) — уникальный номер здания.
Тип объекта в ЖКХ-Контур(4) — тип объекта (МКД, ЦТП, Котельная, ИК).
ИНН организации в ЖКХ-Контур(5) — ИНН ресурсоснабжающей организации.

Как воспользоваться поиском для автозаполнения: нажмите кнопку «Поиск объекта ЖКХ-Контур»(7), выберите критерий (адрес, ID ФИАС или ИНН), введите данные в поле поиска и нажмите на иконку «лупа». В результатах нажмите на иконку со стрелкой рядом с идентификатором нужного объекта — поля заполнятся автоматически.

3. Выберите узел учёта¶

В поле «Узел учёта устройства для привязки параметров»(6) выберите узел учёта из выпадающего списка. После этого станут доступны поля привязки параметров.

4. Привяжите параметры¶

В поле «Параметр в ЖКХ-Контур» выберите параметр из выпадающего списка (чтобы сузить список, начните вводить название).
В поле «Параметр из узла учёта» выберите соответствующий параметр устройства из выпадающего списка (чтобы сузить список, начните вводить название).
Нажмите на иконку зелёного кружка с плюсом справа — связка добавится в список передаваемых.

Повторите эти действия для всех параметров, которые необходимо отправлять в «ЖКХ-Контур».

Для удаления ненужной связки нажмите на иконку красного кружка с крестиком справа от неё.

Примечание: при необходимости номер узла учёта для «ЖКХ-Контур» можно переопределить в соответствующем поле.

5. Сохраните конфигурацию¶

ВАЖНО! После заполнения всех полей нажмите кнопку «Сохранить».

После создания конфигурации устройства модуль формирует общий JSON (со всеми объектами) для оправки данных в "ЖКХ-Контур", который можно посмотреть на вкладке "Просмотр экспорта". Цикл отправки сохранённых конфигураций выполняется с определённой периодичностью в фоновом режиме. Актуальность отправляемых данных зависит от периода опроса устройств и наличия связи с ними.

Редактирование конфигурации устройств¶

В таблице на вкладке «Конфигурации устройств» формируется список устройств, данные которых передаются в «ЖКХ-Контур». Каждая строка таблицы — это одна конфигурация, которую при необходимости можно изменить. Для этого в последнем столбце таблицы доступно меню действий (три точки), содержащее команды «Редактировать» и «Удалить».

Экспортируемые данные¶

Посмотреть сформированные данные для отправки в формате JSON и при необходимости принудительно отправить их можно на вкладке «Просмотр экспорта». Кнопка отправки расположена внизу.

Уже отправленные данные, отсортированные по времени отправки, отображаются на вкладке «Просмотр журнала». Журнал хранит записи за текущие сутки.

Поиск объекта в системе ГИС «ЖКХ-Контур»¶

При необходимости предварительно найти информацию по нужному объекту в системе «ЖКХ-Контур» воспользуйтесь поиском, расположенным на вкладке «Поиск». Интерфейс поиска позволяет найти объекты по одному из трёх критериев:

Адрес — поиск по адресу объекта.
ID ФИАС — поиск по уникальному номеру здания.
ИНН — поиск по ИНН организации.