3.13.1.1.1. Настройка параметров Astra.HMI.WebViewer
Перед запуском построения веб-приложения укажите путь к проекту Astra.HMI, который вы хотите преобразовать в веб-приложение и папку расположения файлов веб-приложения. Вы также можете выбрать тему оформления интерфейса веб-приложения.
|
Для настройки конфигурации Astra.HMI.WebViewer:
1. Откройте файл настроек "astra.hmi.webviewer.xml", выполнив команду:
sudo nano /opt/AstraRegul/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="/usr/bin/python3.7">
|
Параметры подключения клиентов к веб-приложению
При локальном или удаленном подключении к веб-приложению клиент-браузеры используют протокол связи "WebSocket (веб-сокет)".
При настройке Astra.HMI.WebViewer необходимо указать какие соединения будут использоваться: безопасные или незащищенные.
Чтобы указать имя хоста или IP-адрес для подключения к Astra.HMI.WebViewer, перейдите к элементу "WebSocket" и пропишите значение атрибута "Address".
Если вы хотите просматривать мнемосхемы локально, укажите адрес "localhost" или "127.0.0.1". Если же вы будете подключаться к веб-приложению с удаленного компьютера, укажите внешний IP-адрес веб-сокета.
Внимание! Этот адрес не обязательно должен совпадать с адресом веб-сервера, который вводится в адресной строке браузера. Веб-сервер не входит в состав Astra.HMI.WebViewer, настраивается отдельно и при необходимости может быть развёрнут на другой машине.
|
Порт для незащищенных подключений
Чтобы указать порт для подключений по веб-сокету, перейдите к элементу "WebSocket" и пропишите значение атрибута "Port". Eсли вы будете использовать незащищенные соединения, укажите порт "8080".
<?xml version="1.0" encoding="utf-8"?>
<Astra.HMI.WebViewer PythonPath="/usr/bin/python3.7">
<WebSocket Address="192.168.56.104" Port="8080"/>
|
Параметры для безопасных подключений
Дополнительно к порту для незащищенных соединений вы можете указать порт для безопасных соединений по веб-сокету. Перейдите к элементу "WebSocket" и пропишите значение атрибута "SslPort". Для использования безопасных соединений укажите порт "4430".
Следом за портом для безопасных соединений укажите пути расположения файла приватного ключа в формате *.pem и файла SSL-сертификата в формате *.pem. Перейдите к элементу "WebSocket" и пропишите значение атрибута "PrivateKeyPath" и "CertificatePath".
Если для защиты данных вы будете использовать не SSL протокол, а протокол Диффи-Хеллмана, укажите путь к файлу с параметрами для обмена ключами в формате *.pem. Перейдите к элементу "WebSocket" и пропишите значение атрибута "DhParametersPath".
Информация про форматы сертификатов доступна в разделе Формат сертификатов безопасности.
|
Указание пути к проекту и запускаемой экранной формы
Чтобы указать путь к проекту, перейдите к элементу "Application" и пропишите значение атрибута "ProjectPath". Укажите также имя стартовой формы в атрибуте "Entity". Вы можете не указывать имя формы, тогда в браузере первой будет открыта главная форма проекта.
<?xml version="1.0" encoding="utf-8"?>
<Astra.HMI.WebViewer PythonPath="/usr/bin/python3.7">
<WebSocket Address="192.168.56.104" Port="8080"/>
<Application ProjectPath="/home/astraregul/Документы/demo/HMI/demo.hmi" Entity="SW_Popup" WwwRoot="/var/www/html" 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="/usr/bin/python3.7">
<WebSocket Address="192.168.56.104" Port="8080"/>
<Application ProjectPath="/home/astraregul/Документы/demo/HMI/demo.hmi" Entity="SW_Popup" WwwRoot="/var/www/html" 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="/usr/bin/python3.7">
<WebSocket Address="192.168.56.104" Port="8080"/>
<Application ProjectPath="/home/astraregul/Документы/demo/HMI/demo.hmi" Entity="SW_Popup" WwwRoot="/var/www/html" Theme="indigo"/>
</Astra.HMI.WebViewer>
|