Веб-страницы и плагины¶
Помимо штатных мнемосхем, SCADA/BMS-платформа ГАУС позволяет встраивать в рабочее место оператора собственные веб-страницы — произвольный HTML-контент: дашборды, отраслевые панели, кастомные экраны, журналы, просмотрщики данных. Такая страница открывается как вид страницы «Веб-страница» и работает внутри клиента как часть интерфейса, получая от него оформление и — при явном разрешении — данные платформы.
Это расширяет платформу без доработки ядра: там, где штатных объектов мнемосхемы не хватает (нестандартная визуализация, сложная таблица, отраслевой виджет, интеграция со сторонним представлением), задачу решает веб-страница. Порог входа минимальный — это обычная HTML-страница, для простого случая ей не нужны ни сборка, ни серверная часть.
Раздел рассчитан на инженера, который настраивает экраны, и на разработчика, который делает встраиваемую страницу (плагин).
Что такое веб-страница как объект проекта¶
Веб-страница — это узел дерева проекта вида «Веб-страница»: вместо графической мнемосхемы он указывает на адрес HTML-страницы (URL или локальный файл). Клиент открывает эту страницу во встроенном браузере и снабжает её контекстом текущей сессии. Как и мнемосхему, веб-страницу можно положить в нужную папку, переименовать, сослаться на неё переходом.
Саму страницу можно разместить где угодно: отдать со статического веб-сервера, из каталога поставки или из локального файла. Для простого плагина достаточно одного HTML-файла.

Что клиент передаёт странице¶
При открытии (и повторно при изменениях) клиент передаёт странице контекст сессии:
- Тема оформления — цвета текущей темы клиента и признак тёмной/светлой темы; обновляется на лету при переключении темы, чтобы встроенная страница не выбивалась из общего вида.
- Язык интерфейса — чтобы страница показывала подписи на языке клиента.
- Контекст проекта — текущий проект, имя пользователя, адрес сервера платформы.
Тема, язык и контекст передаются всегда. Доступ к данным и к программному интерфейсу платформы — только при явном включении соответствующего режима (см. ниже). По умолчанию встроенная страница ничего о данных платформы не знает — она получает лишь оформление и контекст.
Режим «Передавать данные»: живые данные привязанных объектов¶
Чтобы страница показывала реальные значения (по сути — стала HTML-мнемосхемой), для неё включают режим «Передавать данные» и задают список привязанных объектов — перетаскиванием нужных параметров, аварий или трендов из дерева проекта в настройки страницы.
Как это работает и почему это удобно и безопасно:
- Страница получает живой поток значений привязанных параметров и состояний аварий, а также может запросить историю привязанного тренда. Значения приходят по изменению (как на обычной мнемосхеме).
- Данные приходят из живого потока самого клиента — страница не опрашивает сервер напрямую и не получает ключ авторизации в свой код. Меньше поверхность риска.
- Страница видит только привязанные объекты — ничего сверх выданного ей белого списка. Запрос истории по непривязанному объекту отклоняется.
- При уходе со страницы или её перезагрузке подписки на данные снимаются автоматически.
Режим живых данных рассчитан на десктоп-клиент (данные берутся из его потока).
Режим «Передавать токен»: доступ к API платформы¶
Если странице нужно не просто показывать привязанные значения, а обращаться к платформе шире (например, вычитывать журнал целиком, работать с произвольными объектами, выполнять запросы к серверу), для неё включают режим «Передавать токен авторизации». Тогда клиент передаёт странице ключ текущей сессии, и страница может вызывать программный интерфейс платформы.
Важные свойства этого режима:
- Запросы идут через клиент-посредник, поэтому странице не мешает CORS — не нужно настраивать разрешения на стороне сервера.
- Страница действует строго в пределах прав текущего пользователя — она не может сделать через API больше, чем разрешено учётной записи, под которой открыта.
- Передача токена — опциональна и включается отдельно для каждой страницы (в её настройках, раздел доступа). Без этого тумблера страница ключа не получает.
Выбирайте минимально достаточный режим: если странице нужно только показывать несколько значений — достаточно режима «Передавать данные» (без выдачи токена); полный доступ к API через «Передавать токен» включайте, только когда он действительно нужен.
Оформление под тему клиента¶
Чтобы встроенная страница выглядела частью интерфейса, платформа предоставляет странице цвета текущей темы (фон, поверхности, текст, акцент, границы, статусные цвета — норма/предупреждение/ ошибка). Встраиваемый в страницу SDK (см. ниже) выставляет их как CSS-переменные, поэтому если писать стили страницы через эти переменные, страница автоматически попадает в тему клиента и перекрашивается на лету при её переключении. Отдельно сообщается признак тёмной/светлой темы — для точной подстройки.
Перезагрузка и жизненный цикл¶
- Перезагрузка страницы (
F5) перезапускает встроенную страницу — удобно при разработке плагина: поправили файл →F5→ видите результат, не переоткрывая экран. - При повторном открытии страницы клиент заново передаёт ей актуальный контекст (тему, язык, проект), а активные подписки на данные пересоздаются.
- При уходе со страницы её подписки на живые данные снимаются автоматически — «повисших» подписок не остаётся.
Безопасность¶
Встраивание собственного HTML-контента спроектировано так, чтобы по умолчанию не расширять доступ:
- Без включённых режимов страница получает только оформление и контекст, но не данные и не доступ к API.
- Режим «Передавать данные» открывает странице только привязанные объекты (белый список), причём без выдачи ключа авторизации в код страницы.
- Режим «Передавать токен» даёт доступ к API, но в пределах прав пользователя сессии и только если тумблер включён для этой страницы.
- Оба режима включаются осознанно и по-страничнно. Встраивайте только доверенный контент: как и любую стороннюю веб-страницу, непроверенный плагин размещать не следует.
SDK для разработки страниц¶
Чтобы разработчику страницы не разбираться в деталях обмена с клиентом, в поставку входит JavaScript-SDK моста страницы. Он подключается к странице обычным тегом скрипта (без сборщика и без зависимостей — подойдёт и «голый» HTML/JS, и любой фреймворк, подключённый через CDN) и даёт:
- готовый доступ к контексту (тема, язык, проект, пользователь) и подписку на его изменения;
- выставление CSS-переменных темы (для автоматической подстройки под тему клиента);
- в режиме «Передавать данные» — методы получения снимка и живого потока значений/аварий и запроса истории привязанного тренда;
- в режиме «Передавать токен» — удобные вызовы программного интерфейса платформы (с автоматической подстановкой адреса сервера и авторизации, в обход CORS).
Точный состав SDK, имена методов и типы поставляются вместе с ним (машиночитаемая спецификация SDK пригодна и для генерации страниц ИИ-ассистентом).
Как добавить веб-страницу¶
Предусловие. Готова HTML-страница (хотя бы простейшая) и известен её адрес: URL на веб-сервере или путь к локальному файлу. Если страница должна показывать реальные значения — заранее определите, какие теги/алармы/ тренды ей понадобятся (они должны существовать в дереве).
-
В дереве проекта вызовите контекстное меню на папке, где будет жить экран, и выберите «Создать» → «Страницу» → «Веб-страница».

-
В окне «Создать страницу» в поле «Наименование» введите имя страницы (как она будет называться в дереве и переходах) и нажмите «Создать».

-
Откройте созданную страницу на редактирование и в поле «URL» введите адрес HTML-страницы (адрес на веб-сервере или путь к локальному файлу). Справа от поля показывается предварительный просмотр. Нажмите «Сохранить».

-
Включите минимально достаточный режим — по тому, что странице нужно:
- только показать несколько живых значений → режим «Передавать данные» (см. Как отдать странице живые данные);
- полноценно работать с API платформы → режим «Передавать токен авторизации»;
- ничего из данных платформы (страница самодостаточна) → не включайте ни один режим.
- Нажмите «Сохранить» и откройте страницу из дерева проекта.
- При доработке HTML нажмите
F5в открытой странице — правки подхватятся без переоткрытия экрана.
Проверка: страница открывается в рабочем месте как обычный экран, оформлена в тему клиента и (если включали режимы) получает данные либо доступ к API, как задумано.
Как отдать странице живые данные¶
Предусловие. Веб-страница создана (см. выше). Объекты, значения которых она должна показывать, уже существуют в дереве проекта.
- Откройте настройки веб-страницы и включите режим «Передавать данные».
- Перетащите из дерева проекта нужные параметры (для значений), алармы (для состояний) и тренды (для истории) в список привязанных объектов страницы. Страница увидит только эти объекты.
- Нажмите «Сохранить» и откройте страницу.
Проверка: страница получает живые значения (они меняются при изменении привязанных тегов) и, при необходимости, историю привязанных трендов.
Если значений нет — проверьте: включён ли режим «Передавать данные», привязаны ли нужные объекты, приходят ли их значения в самом клиенте (см. значение и его статус качества).
Частые ошибки при настройке веб-страницы
- Страница не получает данные — не включён режим «Передавать данные» или не привязаны объекты. Страница видит только то, что ей явно привязали.
- Нужен полный доступ к API, а включён только режим данных — для произвольных запросов к платформе нужен режим «Передавать токен авторизации» (в пределах прав пользователя).
- Страница выглядит чужеродно — стили заданы фиксированными цветами вместо переменных темы; используйте переменные темы, и страница подстроится под клиент автоматически.
Типовые применения¶
- Журнал событий / аварий — страница с расширенной фильтрацией и поиском по всей истории через API платформы (режим «Передавать токен»).
- Просмотрщик и анализ трендов — страница со своей графикой поверх истории привязанных трендов.
- Кастомная HMI-мнемосхема — нестандартный экран с живыми значениями привязанных тегов (режим «Передавать данные»), когда штатных объектов мнемосхемы не хватает.
- Отраслевой дашборд / панель — сводный экран под конкретную задачу, собранный как обычная веб-страница и встроенный в рабочее место.
Типовые вопросы¶
- Чем веб-страница отличается от мнемосхемы? Мнемосхема собирается из штатных объектов платформы; веб-страница — это ваш собственный HTML, встроенный в клиент. Веб-страницу берут, когда штатных объектов не хватает.
- Нужен ли сервер/сборка для плагина? Нет. Для простого плагина достаточно одного HTML-файла; сборка и серверная часть — опциональны.
- Как страница получает реальные значения? Через режим «Передавать данные» и список привязанных объектов — значения приходят из потока клиента, без опроса сервера и без ключа в коде страницы.
- Когда нужен режим «Передавать токен»? Когда странице нужен доступ к API платформы шире, чем показ привязанных значений (например, работа с журналом или произвольными объектами). Доступ — в пределах прав пользователя.
- Опасно ли встраивать веб-страницу? По умолчанию страница получает только оформление и контекст. Доступ к данным/API включается осознанно и по-страничнно; встраивайте доверенный контент.
См. также¶
- Компоненты платформы — место веб-страниц среди других частей платформы.
- Построение мнемосхем — штатный способ собрать экран оператора; веб-страница — когда его не хватает.
- Проекты и теги — объекты, которые привязываются к странице.
- Пользователи, роли и права — чьими правами ограничен доступ страницы к API.
- Безопасность — общие принципы безопасного доступа.