3.11.1.1.1. Настройка параметров Astra.HMI.WebViewer
Перед запуском построения веб-приложения укажите путь к проекту Astra.HMI, который вы хотите преобразовать в веб-приложение и папку расположения файлов веб-приложения. Вы также можете выбрать тему оформления интерфейса веб-приложения.
|
1. Перейдите в директорию установки Astra.HMI.WebViewer и откройте файл настроек "astra.hmi.webviewer.xml".
Указание версии Python
Если на компьютере установлено несколько версий Python, необходимо указать какую версию должен использовать Astra.HMI.WebViewer
|
Чтобы указать определенную версию Python для использования компонентом, перейдите к элементу Astra.HMI.WebViewer и пропишите значение атрибута "PythonPath". Вы можете не указывать значение данного атрибута, тогда по умолчанию будет использован системный Python, найденный через переменную среды $PATH.
<?xml version="1.0" encoding="utf-8"?>
<Astra.HMI.WebViewer PythonPath="C:\Users\User_1\AppData\Local\Programs\Python\Python312">
|
Параметры подключения клиентов к веб-приложению
При локальном или удаленном подключении к веб-приложению клиент-браузеры используют протокол связи "WebSocket (веб-сокет)".
При настройке Astra.HMI.WebViewer необходимо указать какие соединения будут использоваться: безопасные или незащищенные.
Чтобы указать имя хоста или IP-адрес для подключения к Astra.HMI.WebViewer, перейдите к элементу "WebSocket" и пропишите значение атрибута "Address".
Eсли вы хотите просматривать мнемосхемы локально, укажите адрес "localhost" или "127.0.0.1". Eсли же вы будете подключаться к веб-приложению с удаленного компьютера, укажите внешний IP-адрес веб-сокета.
Внимание! Этот адрес не обязательно должен совпадать с адресом веб-сервера, который вводится в адресной строке браузера. Веб-сервер не входит в состав Astra.HMI.WebViewer, настраивается отдельно и при необходимости может быть развёрнут на другой машине.
|
Укажите также порт в атрибуте "Port". Если будут использоваться незащищенные соединения, укажите порт "8080".
<?xml version="1.0" encoding="utf-8"?>
<Astra.HMI.WebViewer PythonPath="C:\Users\User_1\AppData\Local\Programs\Python\Python312">
<WebSocket Address="192.168.0.1" Port="8080"/>
|
Дополнительно к порту для незащищенных соединений вы можете указать порт для безопасных соединений по веб-сокету. Для этого у элемента "WebSocket" пропишите значение атрибута "SslPort". Для использования безопасных соединений можно использовать порт "4430".
Следом за портом для безопасных соединений можно указать путь расположения файла приватного ключа в формате *.pem и файла SSL-сертификата в формате *.pem. Для этого необходимо у элемента "WebSocket" и прописать значение атрибутов "PrivateKeyPath" и "CertificatePath".
Eсли для защиты данных вы будете использовать не SSL протокол, а протокол Диффи-Хеллмана, укажите путь к файлу с параметрами для обмена ключами в формате *.pem. Тогда у элемента "WebSocket" необходимо прописать значение атрибута "DhParametersPath".
Указание пути к проекту и запускаемой экранной формы
Чтобы указать путь к проекту, перейдите к элементу "Application" и пропишите значение атрибута "ProjectPath". Укажите также имя стартовой формы в атрибуте "Entity". Вы можете не указывать имя формы, тогда в браузере первой будет открыта главная форма проекта.
<?xml version="1.0" encoding="utf-8"?>
<Astra.HMI.WebViewer PythonPath="C:\Users\User_1\AppData\Local\Programs\Python\Python312">
<WebSocket Address="192.168.0.1" Port="8080"/>
<Application ProjectPath="C:\HMI\WEB\Test.hmi" Entity="SW_Popup" WwwRoot="D:\WebViewer-WwwRoot\Project" Theme="indigo"/>
</Astra.HMI.WebViewer>
|
При первом запуске проекта необходимо указать путь к файлу проекта Astra.HMI с расширением *.hmi.
|
После первой компиляции проекта в Astra.HMI.WebViewer можно использовать файл типа *.ni.binom, который автоматически создается в папке "output" в директории проекта Astra.HMI.
|
Указание папки хранения файлов веб-приложения
Чтобы указать папку, в которую Astra.HMI.WebViewer положит файлы построенного веб-приложения, перейдите к элементу "Application" и пропишите значение атрибута "WwwRoot".
<?xml version="1.0" encoding="utf-8"?>
<Astra.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" Entity="SW_Popup" WwwRoot="D:\WebViewer-WwwRoot\Project" Theme="indigo"/>
</Astra.HMI.WebViewer>
|
Не рекомендуем хранить в папке важную информацию, т.к. содержимое папки полностью перезаписывается при каждом построении веб-приложения.
|
Указание темы оформления интерфейса веб-приложения
Чтобы указать тему оформления пользовательского интерфейса веб-приложения, перейдите к элементу Application и пропишите название темы в атрибуте "Theme".
Темы оформления:
modern
classic
indigo
simple
Вы можете не указывать тему, тогда автоматически будет установлена тема "modern".
|
Таким образом после задания всех настроечных полей должен получиться следующий код в настроечном файле astra.hmi.webviewer.xml:
<?xml version="1.0" encoding="utf-8"?>
<Astra.HMI.WebViewer PythonPath="C:\Users\User_1\AppData\Local\Programs\Python\Python312">
<WebSocket Address="192.168.0.1" Port="8080"/>
<Application ProjectPath="C:\HMI\WEB\Test.hmi" WwwRoot="D:\WebViewer-WwwRoot\Project" Theme="indigo"/>
</Astra.HMI.WebViewer>
|