eksis - документация. Акционерное общество Экологические сенсоры и системы (эксис)
 Скачать 4.28 Mb.
|
|
Внимание! Некоторые браузеры могут по-разному отображать элементы ввода периода. В некоторых это будет простые текстовые поля, в которые вы должно будете вручную ввести даты/время в формате ГГГГ-ММ-ДД ЧЧ:ММ (например, 2013-04-23 12:30). Рекомендуется использовать браузеры с поддержкой всплывающих окон выбора даты (например, Google Chrome). Если для прибора задана реакция на событие, и в данный момент это событие наступило (например, нарушение порогового значения), то объект помечается значком . Нажатием на этот значок него можно приостановать оповещения, если такая возможность предусмотрена настройкой прибора (см. соответствующий раздел). Элементы, для которых была произведена приостановка оповещений, помечаются значком . 119 Если для пользователя, под которым был произведѐн вход в систему, выставлены ограничения на просмотр статистики или приостановку оповещений, то при попытке выполнить запрещѐнное действие будет выведено сообщение о невозможности данного действия (рис. 21.6). Рис. 21.6. Сообщение о недостаточных правах пользователя Объекты (приборы и списки устройств), к которым у пользователя отсутствует доступ, не отображаются в веб-интерфейсе. Внешний вид web-интерфейса Eksis Visual Lab можно изменить настолько, насколько это пользволяет сделать CSS. При запуске EVL проверяет наличие файла style.css в папке resources в папке с программой, и если файл существует, то именно он используется в качестве каскадной таблицы стилей для загружаемых через web-интерфейс html-страниц. Eksis Visual Lab может использовать SSL для веб-интерфейса, делая возможным работу по протоколу HTTPS. Для этого программе необходим сертификат в формате PEM, содержащий закрытый и открытый ключи шифрования. Сертификат должен быть указан в параметре запуска программы как «WebInterfaceSSL “<путь к файлу>”» (например – WebInterfaceSSL “C:\EksisVisualLab\cert.pem”). Обратите внимание, что если сервер расположен в локальной сети, то для него не может быть получен сертификат от удостоверяющих центров сертификации (например, Lets Encrypt). С иным сертификатом современные браузеры будут выдавать сообщение о ненадѐжности защищѐнного HTTPS-подключения (сообщение может быть проигнорировано путѐм добавление веб-сервера EVL в исключения браузера). В версии 4.7.0 произошли существенные изменения web-интерфейса. Если вам необходимо пользоваться прежней версией web-интерфейса (например, для совместимости с другими программами, получающими данные в автоматическом режиме), запустите программу с ключом OldWebInterface. 120 22. Работа в режиме OPC-сервера Eksis Visual Lab поддерживает технологию OPC Data Access 2.05a и может предоставлять данные измерений сторонним программам как OPC-сервер. Эта функция не требует наличия лицензионного ключа, однако без приобретѐнной лицензии другие функции программы (например, рассылка оповещений или автоматических отчѐтов) будут недоступны. Для использования технологии OPC на компьютере должен быть установлен распространяемый набор компонент OPC (OPC Core Components Redistributable), а сам EVL должен быть зарегистрирован в системе как OPC-сервер. Набор библиотек можно найти на поставляемом носителе с Eksis Visual Lab или скачать с официального сайта OPC Foundation. После установки этого набора регистрация EVL производится еѐ запуском с ключом «regserver» или запуском файла «Зарегстрировать OPC-сервер Eksis Visual Lab.bat» из папки с программой или меню «Пуск». В случае успешной регистрации программа выдаст соответствующее сообщение (рис. 22.1). Рис. 22.1. Регистрация OPC-сервера Eksis Visual Lab Для отзыва регистрации используйте ключ запуска «unregserver» или файл «Отозвать регистрацию OPC-сервера Eksis Visual Lab.bat» из папки с программой или меню «Пуск». Внимание! Регистрацию или еѐ отзыв необходимо проводить с правами администратора (меню правой кнопки мыши по ярлыку или bat-файлу -> «Запуск от имени администратора»)! В случае успешной регистрации Eksis Visual Lab появится среди OPC-серверов системы (рис. 22.2). Данные OPC-сервера Eksis Visual Lab: ProgID: Eksis.EVLOPCServerDA2.1 CLSID: {CC90CC25-F9F0-465A-82E5-E5F91577F620} Эти данные можно использовать для непосредственного подключения к OPC-серверу (в том числе находящемуся на удалѐнном компьютере), если по какой-то причине получить список не удалось. 121 Рис. 22.2. Список зарегистрированных в системе OPC-серверов OPC-сервер Eksis Visul Lab реализует следующие интерфейсы стандарта Data Access 2.05a: IOPCServer IOPCCommon IOPCItemProperties IOPCBrowseServerAddressSpace IConnectionPointContainer IOPCItemMgt IOPCGroupStateMgt IOPCSyncIO IOPCASyncIO2 IOPCDataCallback С помощью методов интерфейса IOPCBrowseServerAddressSpace можно получить список тегов сервера, совпадающий со структурой приборов, каналов и параметров в окнах списка устройств (рис. 22.3). Обратите внимание, что неактивные элементы не будут отображены посредством этого интерфейса. Формат тега <восьмизначный технологический номер прибор>.<номер канала>.<номер параметра> (например, 10052354.1.1). Вы можете обращаться к тегам без использования интерфейса просмотра адресного пространства. 122 Рис. 22.3. Пространство тегов OPC-серверов Eksis Visual Lab OPC-сервер Eksis Visual Lab поддерживает асинхронную передачу данных при их изменении (метод OnDataChange интерфейса IOPCDataCallback посредством технологии COM ConnectionPoint). Время обновления OPC-группы и вызова метода OnDataChange не может быть меньше минимального времени опроса приборов в Eksis Visual Lab, параметры которых добавленны в группу. Опрос соответствующих тегам приборов в Eksis Visual Lab запускается автоматически при добавлении в OPC-группу клиента тега (при условии активности группы или тега) или при становлении группы или тега активными. Метод OnDataChange будет вызван при обновлении прибора в EVL, но не чаще заданного в OPC-клиенте периода обновления. Если данные измерений больше никому не нужны (например, группа или параметры переведены в состояние неактивности или OPC-клиенты вовсе отключились от OPC-сервера Eksis Visual Lab), а опрос приборов был инициирован OPC-сервером, то опрос приборов прекращается. Если опрос приборов был инициирован пользователем (или самой программой, если в настройках прибора установлен флаг запуска опроса при старте программы), то опрос приборов не прекращается. Кто запустил опрос прибора (пользователь или OPC-сервер), тот и может его остановить. Пользователь может остановить опрос прибора, начатый OPC-сервером. В этом случае OPC-клиенты перестанут получать данные (если это единственный прибор в группе) или будут получать их с качеством OPC_QUALITY_OUT_OF_SERVICE (если в группе есть теги, принадлежащие другим опрашиваемым приборам). Кроме того, пользователь может закрыть Eksis Visual Lab несмотря на наличие подключенных к нему OPC-клиентов. В этом случае программа выдаст предупреждение при закрытии (рис. 22.4), и если программа всѐ-таки будет закрыта, она вызовет для подключенных клиентов метод ShutdownRequest интерфейса IOPCShutdown (посредством технологии COM ConnectionPoint). 123 Рис. 22.4. Предупреждение о наличии OPC-клиентов Возможные значения слова качества (wQuality в структуре OPCITEMSTATE): OPC_QUALITY_GOOD – попытка связи с прибором успешна, значение валидно; OPC_QUALITY_COMM_FAILURE – попытка связи с прибором завершилась ошибкой; OPC_QUALITY_BAD – попытка связи с прибором успешна, но значение параметра по какой-то причине невалидно; OPC_QUALITY_CONFIG_ERROR – прибор, канал или параметр в Eksis Visual Lab неактивны (если параметр вычисляемый, то это также может означать ошибку в пересчѐте); OPC_QUALITY_OUT_OF_SERVICE – опрос прибора остановлен; OPC_QUALITY_DEVICE_FAILURE – для приборов, опрашиваемых по протоколам Modbus, означает код ошибки 0x04 (SLAVE DEVICE FAILURE) OPC_QUALITY_WAITING_FOR_INITIAL_DATA – прибор находится в процессе опроса; иное значение возможно в случае, если параметр принадлежит прибору из другого OPC- сервера. Если для параметра в Eksis Visual Lab заданы пороговые значения, то в слове качества могут быть выставлены биты OPC_LIMIT_LOW или OPC_LIMIT_HIGH, сигнализирующие о нарушении порогов. Данные измерений также могут быть прочитаны по инициативе OPC-клиента посредством интерфейсов IOPCSyncIO и IOPCASyncIO2. Чтение возможно как из кэша EksisVisual Lab (OPC_DS_CACHE), так и непосредственно из приборов (OPC_DS_DEVICE). При чтение из приборов будет произведѐн последовательный опрос всех приборов, теги которых находятся в читаемой OPC-группе, что может занять некоторое время. По этой причине при чтении из приборов рекомендуется использовать асинхронное чтение, когда по завершению чтения вызывается метод OnReadComplete интерфейса IOPCDataCallback (посредством технологии COM ConnectionPoint). 124 Рис. 22.5. Пример получения данных измерений от OPC-сервера Eksis Visual Lab 125 23. Работа программы как службы Windows Большинство функций Eksis Visual Lab доступны в режиме еѐ работы как службы Windows. Служба EVL может производить сбор и обработку данных с приборов в реажиме реального времени, генерацию автоматичесих отчѐтов и оповещений (кроме аудиооповещений и всплывающих окон), предоставление данных через HTTP, TCP и UDP, а так же OPC. Визуальные возможности программы в режиме службы недоступны, так как службы Windows не могут напрямую взаимодействовать с пользователем и рабочим столом. Для запуска службы необходимо проинсталлировать еѐ в системе. Для этого запустите файл EVLService.exe с ключом «/install» (запустите bat-файл «Установить службу Eksis Visual Lab» из папки с программой). В случае успеха программа выдаст соответственное сообщение, а в диспетчере служб появится пункт «Служба Eksis Visual Lab» (рис. 23.1 и 23.2). Рис. 23.1. Сообщение об успешной установке службы Рис. 23.2. Служба Eksis Visual Lab в диспетчере служб Windows По умолчанию служба автоматически запускается во время загрузки операционной системы из-под системной учѐтной записи (вы можете изменить эти настройки вручную). Вход какого-либо пользователя в систему для запуска службы не требуется. 126 Внимание! После запуска служба запускает опрос только тех приборов, в общих настройках которых установлен флаг «Запускать опрос прибора при старте программы/службы» (рис. 23.3). Рис. 23.3. Окно общих настроек прибора Работа программы при установленной и запущенной службе При установленной в системе службе главное окно программы Eksis Visual Lab немного меняется: в верхней части окна появляется панель состояния и управления службой (рис. 23.4 и 23.5) с тремя кнопками: запуска, остановки и перезапуска службы. Рис. 23.4. Панель состояния и управления службой EVL при остановленной службе Рис. 23.5. Панель состояния и управления службой EVL при запущенной службе Внимание! Если служба запущена, то при запуске программы не производится автостарт опроса приборов в реальном времени (задаваемый соответственным флагом в окне общих настроек), так как их уже опрашивает служба. Запускать их опрос вручную не запрещено, к каким- либо ошибкам это не приведѐт. Кроме того, пользователь может параллельно загружать из 127 приборов статистику, производить их настройку (изменять внутренний период записи, синхронизировать время и т.д.). TCP-, UDP- и web-сервер Eksis Visual Lab (а также функция резервного копирования) в приоритете будут всегда работать в службе. Если на момент запуска программы работает служба, то все эти модули не будут активированы. При запуске/остановке службы из программы (не из диспетчера служб) перечисленные модули в программе будут соответственно деактивированы/активированы. При запущенной службе можно «на ходу» менять любые настройки программы, однако для их приминения в службе еѐ необходимо перезапустить. Обратите внимание, что для управление состоянием служб у пользователя Windows должны быть соответствующие права (помимо права в EVL). Для разрешения управлением отдельными службами без предоставления пользователю прав администратора необходимо воспользоваться специальными утилитами (например, subinacl.exe), описание которых выходит за рамки данного руководства. События, произошедшие в службе фиксируются в журнале событий EVL под специальным пользователем «служба» (рис. 23.6), а также в журнале событий Windows в разделе «Журналы Windows» -> «Приложение» (рис. 23.7). Рис. 23.6. Записи службы в журнале событий Eksis Visual Lab 128 Рис. 23.7. События службы в окне просмотра событий Windows Для удаления службы Eksis Visual Lab запустите файл EVLService.exe с ключом «/uninstall» (запустите bat-файл «Удалить службу Eksis Visual Lab» из папки с программой). После этого может потребоваться перезагрузка компьютера. OPC- сервер службы Eksis Visual Lab OPC-сервер EVL (см. соответствующий раздел), может работать в службе Eksis Visual Lab. Для этого требуется зарегистрировать его в системе, запустив файл EVLService.exe с ключом «/regserver» (bat-файл «Зарегистрировать OPC-сервер службы Eksis Visual Lab» в папке с программой). Обратите внимание, что OPC-сервер EVL может быть реализован либо оконным приложением EksisVisualLab.exe, либо службой Windows EVLService.exe, но не ими одновременно. В зависимости регистрационных записей в системном реестре, работающие с OPC- сервером EVL программы будут обращаться либо к приложению, либо к службе. Если на момент обращения к OPC-серверу службы она находится в остановленном состоянии, то система автоматически запустит службу Eksis Visual Lab. В отличии от OPC- серверов, реализуемых оконным приложением, при завершении работы с OPC-сервером службы она не останавливается и продолжает свою работу. 129 24. Журнал событий Eksis Visual Lab производит логгирование критичных событий и действий пользователя. Журнал событий можно открыть через главное меню «EVL» -> «Журнал событий» (рис. 24.1). Рис. 24.1. Окно просмотра журнала событий Журнал имеет 3 колонки: дата и время наступления события, его описание, а также имя пользователя, под которым случилось событие. Для просмотра событий выберите интересующий период в верхней части окна и нажмите кнопку «Обновить» ( ). Для экспорта журнала нажмите кнопку , выберите «Формат Excel» и укажите расположение и имя файла. Вы также можете скопировать выделенные строки журнала в буффер обмена нажатием CTRL+C. Для печати журнала нажмите кнопку . Логгированию подлежат следующие события: Запуск и закрытие программы; Запуск и остановка опроса приборов; Добавление и удаление приборов, а также изменение их настроек; Добавление изменение и удаление пользователей, а также их вход в систему; Изменение настроек каналов; Изменение настроек измеряемых параметров; Нарушение установленных пороговых значение и их возврат в норму; Потеря и восстановление связи с приборами и каналами; Отправка оповещений; Отправка автоматических отчѐтов. 130 25. Список пользователей Eksis Visual Lab позволяет ограничить использование программы с помощью системы учѐтных записей. Управление списком пользователей осуществляется из окна, вызываемого в главном меню «EVL» -> «Пользователи» (рис. 25.1). Рис. 25.1. Окно управления списком пользователей программы Для добавления нового пользователя нажмите кнопку в верхней панели окна. Откроется форма, в которой необходимо указать имя пользователя и его пароль (рис. 25.2). Рис. 25.2. Окно добавления первого пользователя (администратора программы) Первый создаваемый пользователь является администратором и имеет полный доступ к программе (поэтому его права невозможно изменить). После создания первого пользователя будет произведѐн автоматический вход в систему под его именем. Кнопка вызывает форму, показанную на рисунке 25.2, в которой можно изменить имя пользователя, его права или задать другой пароль. 131 Кнопка удаляет выбранного в списке пользователя после подтверждения. Внимание! Удаление пользователя необратимо. Удалить администратора возможно только в том случае, если кроме него не осталось других пользователей. Кнопка позволяет зайти под другим пользователем без необходимости закрывать программу. Кнопка выводит подсказку о быстром копировании пользователей (комбинацией клавиш CTRL+C / CTRL+V). При создании второго и последующих пользователей можно ограничить им работу с программой (например, изменение настроек связи с приборами). В окне настроек пользователя кнопка «Права» будет содержать количество доступных из возможных прав по работе с программой (рис. 25.3). Рис. 25.3. Окно добавления второго и последующих пользователей При нажатии на кнопку «Права» открывается окно редактирования прав пользователя (рис. 25.4). 132 Рис. 25.4. Окно редактирования прав пользователя Этот список определяет возможности пользователя по работе с программой. Если пользователь попытается выполнить действие, на которое у него не будет разрешения, программа выдаст соответствующее сообщение (рис. 25.5). Если в новых версиях программы появятся новые права (например, для новых функций), то по умолчанию они будут отключены для всех пользователей, кроме администратора. Рис. 25.5. Пример сообщения о недостаточных правах пользователя При нажатии на кнопку «Объекты» открывается список всех присутствующих в программе объектов (окон мониторинга: списка приборов, мониторинга, единого графика и геолокации), среди которых можно выбрать те, к которым пользователь имеет доступ (рис. 25.6). 133 Рис. 25.6. Окно выбора объектов пользователя При создании новых объектов они будут отсутствовать в списке доступных для пользователя, если только не проставлен флаг «Все объекты», который делает для пользователя доступными все существующие и будущее объекты. Если пользователь попытается выполнить действие над объектом, к которому у него нет доступа, программа выдаст соответствующее сообщение (рис. 25.7). Рис. 25.7. Пример сообщения об отсутствии у пользователя доступа к объекту В веб-интерфейсе программы пользователь будет видеть лишь те приборы и списки устройств, к которым у него есть доступ. Только администратор может управлять списком пользователей. Невозможно наделить других пользователей правом создавать, редактировать или удалять пользователей. Если существует хотя бы одна учѐтная запись пользователя, то при старте программы будет показано окно входа в систему (рис. 25.8). 134 Рис. 25.8. Окно входа в систему Если вход в систему не был произведѐн (была нажата кнопка «Cancel»), то взаимодействие с программой осуществляется в режиме «Только чтение», с отсутствием каких-либо прав. Вход в систему можно осуществить в любой момент через меню EVL – «Пользователи» (кнопка в окне управления списком пользователей) или перезапустив программу. Eksis Visual Lab отображает текущего пользователя в заголовке главного окна через два двоеточия («::») от названия программы (рис. 25.8), а также во всех сгенерированных отчѐтах (рис. 25.10). Рис. 25.8. Текущий пользователь в заголовке главного окна Рис. 25.10. Текущий пользователь на графике статистики |