Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Просмотр веб-приложения в браузере

После настройки веб-сервера и успешного запуска Alpha.HMI.WebViewer можно просматривать мнемосхемы проекта через веб-интерфейс как локально, так и с удаленного компьютера.

Адрес для доступа к веб-приложению зависит от конфигурации веб-сервера и его виртуальных хостов. Общий принцип формирования адреса:

Формат: http://Сетевой_адрес:Порт/Путь

Сетевой_адрес IP-адрес или доменное имя сервера, на котором развернут веб-сервер.

Указывается в настройках веб-сервера для:

Порт Порт, на котором настроен веб-сервер.
Путь Дополнительный путь, если он настроен в конфигурации веб-сервера.

Передача параметров через URL

Alpha.HMI.WebViewer поддерживает передачу параметров через строку запроса в URL для указания открываемой формы и данных для внешней инициализации.

Чтобы включить возможность передачи параметров через строку запроса URL, необходимо определить элемент UrlQuery с атрибутом Allow="true" в конфигурационном файле alpha.hmi.webviewer.xml внутри узла Application.

Вы можете дополнительно указать вложенные элементы Entity и Init, чтобы управлять разрешением параметров entity и init.. Если эти элементы не указаны, используется общее значение из атрибута Allow элемента UrlQuery.

<?xml version="1.0" encoding="utf-8"?>
<Alpha.HMI.WebViewer PythonPath="C:\Users\User_1\AppData\Local\Programs\Python\Python37">
ㅤㅤ<WebSocket Address="192.168.0.1" Port="8080"/>
ㅤㅤ<Application ProjectPath="C:\HMI\WEB\Test.hmi" WwwRoot="D:\WebViewer-WwwRoot\Project">
ㅤㅤ<UrlQuery Allow="true">
ㅤㅤㅤㅤ<Entity Allow="true"/>
ㅤㅤㅤㅤ<Init Allow="true"/>
ㅤㅤ</UrlQuery>
ㅤㅤ</Application>
</Alpha.HMI.WebViewer>

Указание открываемой формы через параметр entity

Для указания конкретной формы, которая должна быть открыта при запуске веб-приложения, используйте параметр entity в строке запроса URL.

Параметр entity будет обработан только в том случае, если его использование разрешено в конфигурационном файле alpha.hmi.webviewer.xml .

Формат: http://сетевой_адрес:порт/путь/?entity=<имя_формы>

где <имя_формы> – точное имя экранной формы из проекта Alpha.HMI.

https://webviewer.example.com/?entity=MonitoringForm

Указание данных для внешней инициализации через параметры URL

Alpha.HMI.WebViewer поддерживает передачу данных для инициализации открываемой формы через параметры строки запроса с префиксом init.. Через параметры init. можно инициализировать только цели примитивных типов.

Поддерживаемые цели инициализации:

  • Свойства;
  • Поля;
  • Параметры инициализации.

Значения, переданные через параметры init., переопределяют значения, заданные в проекте, для соответствующих целей инициализации.

Параметры init. будут обработаны только в том случае, если их использование разрешено в конфигурационном файле alpha.hmi.webviewer.xml .

Формат: http://сетевой_адрес:порт/путь/?init.<target-name>=<значение>

где:

  • init. – специальный префикс для разграничения параметров-инициализаторов от других параметров URL.
  • <target-name> – имя цели инициализации (свойство, поле, параметр инициализации) в точности как в типе формы.
  • <значение> – значение для инициализации.

Инициализация одного параметра:

https://webviewer.example.com/?init.DeviceID=12345

Инициализация нескольких параметров:

https://webviewer.example.com/?init.DeviceID=12345&init.Location=Hall_A

Комбинирование параметров

Параметры entity и инициализации могут использоваться как отдельно, так и совместно:

https://webviewer.example.com/?entity=CustomForm&init.ParamA=ValueA&init.ParamB=ValueB