Alpha.Community

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

История изменений

3.3

Новые возможности

  • Теперь после потери и восстановления подключения к источнику срабатывает Refresh и RequestRecentEvents.
  • В приватный тип ConfigConnection добавлено свойство Параметры сведения событий (MergeRulesJson) для задания настроек сведения в формате json.
  • Реализовано событие двойного клика OnMouseDoubleClick.

Улучшения

  • Стандартные диалоговые окна теперь открываются над основным окном компонента Alpha.HMI.Alarms.
  • Исправлено объединение фильтров при одновременном использовании и добавлен вариант объединения по "И".

Исправленные ошибки

  • Устранено появление сообщения об ошибке в журнале при открытии окна печати.
  • Индикатор подготовки данных не исчезал в оперативном режиме, если в историческом режиме еще не завершился запрос данных.
  • Отображалась кнопка квитирования в столбце Квитировать при отсутствии у пользователя прав на квитирование.
  • Не работало редактирование пользовательских столбцов.
  • Устранено появление массы дублирующих ошибок в журнале об отсутствии соединения с базой данных.
  • Устранено зависание с большим объёмом сообщений при изменении настроек вида.
  • Исправлено ошибочное воспроизведение звуков при фильтрации сообщений фильтром подписки по пользовательскому столбцу.
  • Не было возможности выполнять исторический запрос с фильтрацией (SetAdvancedRequestFilterAsJson) по пользовательским атрибутам.
  • Исправлены другие некритичные ошибки.

Изменения документации

Редакция 1

Руководство пользователя

Справочное руководство

3.2

Новые возможности

  • Доработан механизм печати. Теперь в колонтитулах напечатанного документа помещается вся необходимая информация без потерь.
  • Также, добавлены:
    • Настройки макета печати.
    • Перенос строк.
    • Точный расчёт количества листов и распределение строк по листам.
  • Появилась возможность подключения к произвольному серверу. Для этого на панели инструментов добавлена кнопка Подключиться к серверу.
  • Появилась возможность декорирования журнала исторических событий (без редактора). Для этого добавлено сохраняемое свойство HistoryCustomDecorator в тип ConfigEvents.

Улучшения

  • Расширенный фильтр запроса теперь может работать по всем столбцам.
  • В колонитул экспорта добавлены шаблоны Interval и MessageCount.

Исправленные ошибки

  • Команда Сортировка по умолчанию в контекстном меню не устанавливала сортировку по времени генерации и времени срабатывания, а также не перезаписывала конфигурационный файл с параметрами сортировки.
  • При переоткрытии окна печати вместо нужного содержимого шаблонов ViewFilter и Interval в колонтитуле ошибочно отображалась сама конструкция шаблона.
  • Изменялись условия сортировки после их перемещения вверх или вниз внутри диалога сортировки.
  • Кнопка прерывания запроса истории была заблокирована во время запроса.
  • Отсутствовало подключение к серверу при запуске приложения без конфигурационного файла app_session.
  • Исправлены другие некритичные ошибки.

3.1

Новые возможности

  • Реализована возможность просмотра и квитирования событий из внешней системы событий (в частности: событий, полученных при помощи протокола BACnet).
  • Добавлена функция SetAcknowledgeAvailability, позволяющая указывать зоны, для сообщений о событиях которых доступна возможность квитирования и комментирования. Для сообщений остальных зон возможность квитирования и комментирования блокируется.
  • Для вывода детальной статистики на печатный лист теперь можно использовать шаблон колонтитула ${SeverityStatistics}.

Улучшения

  • Теперь во всплывающей подсказке фильтра отображения время выводится в более информативном виде: DD.MM.YYYY HH:MM:SS.FFF, где DD – день, MM – месяц, YYYY – год, HH – часы, MM – минуты, SS – секунды, FFF - миллисекунды.
  • Теперь при обнаружении звука, проиграть который невозможно, единожды выводится сообщение в журнал. Повторная попытка проиграть такой звук не выполняется.

Исправленные ошибки

  • Не блокировалась команда Добавить комментарий при отсутствии сообщений в таблице.
  • Исправлена ошибка, из-за которой при включенном режиме снимка и свойстве LookLatestEvent со значением true вновь сгенерированные события возвращали журнал в начало списка событий.
  • Исправлены другие некритичные ошибки.

3.0

Новые возможности

  • Добавлена возможность отключать подтверждение квитирования для отдельного сообщения, сохраняя возможность оставлять включённым подтверждение квитирования всех сообщений. Для этого используйте флаги Запрашивать комментарий при квитировании выбранного сообщения и Запрашивать комментарий при квитировании всех сообщений на вкладке Квитирование окна параметров.
  • Теперь можно отключить таймер кнопки отмены в окне ввода комментария квитирования. Для этого используйте флаг Таймаут ввода комментария на вкладке Квитирование окна параметров.
  • Реализован словарь значений полей в фильтре отображения. Новые слова можно добавлять на вкладке Фильтр отображения окна параметров.

Изменения и улучшения

Удалены свойства:

  • Доступность кнопок квитирования всех сообщений (AckAllAvailable), позволявшее скрыть кнопки для квитирования всех сообщений в контекстном меню и на панели инструментов. Для скрытия этих кнопок рекомендуем использовать флаги в окне параметров (вкладка Панель инструментов и Контекстное меню).
  • Отображать строку состояния при запуске (DisplayStatePanelAtStartup) и Отображать панель инструментов при запуске (DisplayToolbarAtStartup), позволявшие скрыть строку состояния и панель инструментов. Для скрытия этих областей рекомендуем использовать свойства Показывать панель инструментов (DisplayToolbar) и Показывать строку состояния (DisplayStatePanel).
  • Удалено уведомляющее поле objectId, в которое записывался идентификатор объекта, выделенного в столбце Источник события. Теперь при действии в столбце Источник объекта срабатывает новое событие (ссылка на обработчик события) OnActionInSourceColumn, которое возвращает идентификатор объекта.
  • Поверх всех окон (AlwaysOnTopForm), включающее расположение дочерних окон поверх других запущенных приложений.
  • Не требовать квитирования группы Прочие (NotAckOtherEvents). Рекомендуем отключать требование квитирования при конфигурировании сервера (с помощью параметра AckRequired).
  • Разрешить полный доступ (IsFullAccessAllowed), позволяющее ограничивать доступ к файловой системе Windows.
  • Интервал запроса истории по умолчанию (DefaultHistoricalInterval), в котором устанавливался интервал запроса, действующий при переходе из оперативного режима в исторический. Теперь при открытии исторического режима будет установлен интервал 24 часа от реального времени или значение из сессии. Для загрузки нужного интервала теперь надо использовать команды контекстного меню кнопки Запросить данные.
  • Режим фильтрации источника событий (SourceFilterMode), позволяющее отфильтровать оперативные или исторические события по пути источника. Теперь фильтруются и оперативные и исторические события по пути, указанному в источнике AP.
  • ShowRelativeTag (Отображать относительный тег источника сообщения). Теперь для указания тега родительского узла источника события добавляйте пользовательский столбец с идентификатором area_path или relative_tag.

Изменения в событиях:

  • Типу Alarms добавлена ссылка на команду OnOperativeLoad, которая вызывается при:
    • при запуске приложения в оперативном режиме;
    • после переключения в оперативный из исторического;
    • при изменении параметров в оперативном и нажатии кнопки Применить.
  • У событий OnSoundPlayed, OnExport, OnSave, OnLoad, OnAck, OnOpenTrends и OnOpenForm тип сменился с Команды на Обработчик события.

Изменения в функциях:

  • Удалена функция SetSize, задающая размер экземпляра типа Alarms и позиционирующая экземпляр на форме.

    Определять размер и положение экземпляра можно:

    • В дизайнере Alpha.HMI (свойства X, Y, Ширина (Width) и Высота (Height)).
    • В режиме рантайма, обращаясь к свойствам X, Y, Ширина (Width) и Высота (Height).
  • Удалены функции DisplayCurrentEventsSnapshot и DisplayCurrentEvents, используемые для включения и отключения режима снимка. Вместо них теперь введена новая функция SetSnapshotState.
  • Удалена функция GetEventParam.

Добавлены новые типы:

  • EventStatistics. Не отображается на форме и предназначен для вывода детальной статистики по событиям, которая раньше выводилась в статусной строке. В тип Alarms_Table добавлена ссылка на экземпляр типа EventStatistics, куда записываются данные статистики.
  • Alarms_Sounds. Не отображается на форме и предназначен только для воспроизведения звуков событий.
  • Alarms_Table. Представляет собой таблицу сообщений о событиях без панели инструментов, статусной строки и возможности проигрывания звуков событий.
  • Разрешения пользователя (Permissions). Не отображается на форме и предназначен для ограничения прав пользователей.

Другие изменения:

  • Переработаны настройки в окне Параметры.
    • Вкладка Важность событий переделана на Звуки событий.
    • На вкладке Вид таблицы добавлены возможности:
      • скрывать заголовки столбцов;
      • включать сортировку по заголовкам;
      • включать перенос строк;
      • включать отображение миллисекунд;
      • включать слежение за последними событиями;
      • разрешать выбор нескольких строк в таблице;
      • скрывать полосы прокрутки.
    • Вкладка Механизмы очистки переделана на Подключение.
    • Добавлена вкладка Фильтр отображения для создания словаря для полей фильтров, а также для выбора столбцов, которые будут отображаться в окне Фильтр пользователя.
    • Добавлена вкладка Квитирование.
  • Файл сессии приложения session.json переименован на app_session.json.
  • Ликвидирован тип UnacknowledgedEventsButton, приводящий к зависаниям.
  • Добавлена возможность ограничения прав пользователей на действия в столбце Источник события. Для этого в типе Разрешения пользователя (Permissions) есть свойство Разрешить действия в столбце источник события (ActionInSourceColumn).
  • Все свойства экземпляра типа Alarms (кроме ActiveMode) вынесены на кладки окна параметров.
  • Переработаны правила настроек экземпляра типа Alarms.
  • Теперь экземпляр можно настроить:
    • Через функцию LoadConfiguration.
    • Задать свойства экземпляра в дизайнере. При первой загрузке настроек из файлов значения используются как начальные и далее сохраняются по команде пользователя.
    • Обращаться к свойствам экземпляра в рантайме.

Исправленные ошибки

  • В историческом режиме отображались оперативные сообщения.
  • Устранён ошибочный пробел в имени свойства ClearSoundQueryTag.
  • Не блокировалась кнопка запроса при некорректном интервале запроса.
  • Исправлены причины зависания Alpha.HMI при ведении детальной статистики.
  • Функция SetAdvancedRequestFilterAsJson не возвращала ошибку при неверном выражении фильтра.
  • Фильтр, установленный функцией RequestRecentEvents, применялся и при запросе истории.
  • При фильтрации по столбцу Группа важности таблица предпросмотра экспорта оказывалась ошибочно пуста.
  • Исправлены прочие некритичные ошибки.

3.0.1

Исправленная ошибка

Устранена причина, из-за которой не было возможности менять ширину столбцов при включенном разрешении на изменение (свойство Возможность изменения вида пользовательского интерфейса установлено в true и у пользователя есть право ChangingView).

2.5

Новые возможности

  • Типу Alarms добавлена ссылка на команду OnHistoryLoad, которая вызывается по окончании загрузки истории и после подгрузки истории в оперативный режим.
  • Теперь последняя использованная папка запоминается и загружается при следующем запуске Alpha.HMI.Alarms. Такое возможно только если есть доступ к файловой системе.
  • Добавлены новые права пользователей, используемые при работе с подсистемой безопасности:
    • Выбор принтера (PrinterSelecting) для включения разрешения сменить принтер. Право добавлено вместо существующего права FileSystemAccess.
    • Принтеры (Printers), содержащее списки разрешенных и запрещённых принтеров.
  • Теперь последний используемый принтер сохраняется и предлагается при перезапуске окна печати.
  • Добавлена возможность настройки состава фильтра отображения.
  • Для типа Alarms добавлены новые свойства:
    • Папка для экспорта и импорта (ExportImportFolderPath), позволяющее задавать папку экспорта событий.
    • Режим фильтрации источника событий (SourceFilterMode), позволяющее выбрать какие события (все или только по передаваемому источнику) будут отображаться в оперативном и историческом режиме.

Улучшения

  • Теперь SetAdvancedFilter и фильтр отображения "умеют" работать с операторами OR и AND.
  • Ранее при фильтрации по признаку квитированности отображались только квитированные события. Теперь же отображаются еще и события, не требующие квитирования.
  • Обновлён механизм экспорта для совместимости с Alpha.HMI.Tables 2.0.9.
  • Добавлена возможность произвольной настройки колонтитулов экспорта и печати с помощью редактора колонтитулов.

Исправленные ошибки

  • В веб-версии исправлено смещение списка столбцов в настройках вида таблицы.
  • Ранее при отключенных правах на фильтрацию блокировался также доступ к хронологии и предустановленным интервалам. Теперь такая ошибка исправлена.
  • Исправлена ошибка, из-за которой в строке состояния отсутствовало предупреждение о том, что тег сигнала очистки очереди звуков задан неверно.
  • Исправлена ошибка, из-за которой функции AckAll и AckSelected экземпляра типа Alarms не работали сразу после вызова функции LogOn.
  • Устранена ошибка, возникающая при выводе детальной статистики по важности вместе с установленной фильтрацией по квитированным событиям.
  • Устранена причина, по которой не удавалось получить идентификатор объекта при действии в столбце Источник события.
  • Исправлены прочие некритичные ошибки.

2.5.1

Исправленная ошибка

Исправлено зависание Alpha.HMI.Viewer при большом количестве событий и включенном свойстве Отображать детальную статистику по важности.

2.5.2

Исправленные ошибки

Исправлены ошибки в работе функции SetAdvancedRequestFilterAsJson, из-за которых активные события запрашивались, но не отображались в оперативном режиме.

2.5.3

Исправленная ошибка

Исправлена ошибка, из-за которой при включенном режиме снимка и свойстве LookLatestEvent со значением true вновь сгенерированные события возвращали журнал в начало списка событий.

Изменения документации

Редакция 1

Справочное руководство

Обновлено описание функций SetAdvancedFilterAsJson и SetAdvancedFilter.

Редакция 2

Руководство пользователя

Обновлено описание печати списка сообщений о событиях.

2.4

Новые возможности

  • Добавлена возможность задать цвета панели инструментов при помощи темы оформления.
  • Добавлена возможность задать цвета контекстного меню при помощи темы оформления.

Исправленные ошибки

  • Устранена причина, по которой данные событий OnSoundPlayed и OnExport помещались в одну переменную - EventParams [0], из-за чего данные одного события могли подмениться данными другого события. Теперь данные события OnSoundPlayed перемещены в переменную EventParams [10], и путь до звукового файла относительно папки ресурсов проекта по событию OnSoundPlayed можно теперь получить с помощью функции GetEventParam(10).
  • Исправлены ошибки работы функции SetAdvancedFilter со словами, заканчивающимися на "НЕ".
  • Решена проблема, из-за которой при наличии переноса строк вместо текущей страницы печаталось две страницы.
  • Устранены зацикливания алгоритмов, из-за которых тормозило перемещение скролла мышью.
  • Исправлены прочие ошибки

2.4.1

Новая возможность

Теперь можно отключить требование воспроизведения звука default.wav, который должен звучать по умолчанию, если никакой звук для события не указан. Для этого каждой группе важности добавлен флаг Принудительное воспроизведение.

Исправленные ошибки

  • Исправлена ошибка, из-за которой пользовательский столбец не заполнялся данными в историческом режиме.
  • Исправлена ошибка, из-за которой не удавалось выполнить запрос истории и применить фильтр отображения в одном скрипте.
  • Исправлены прочие ошибки.

Изменения документации

Редакция 1

Внутренние изменения. Содержимое документа не изменилось.

2.3

Новые возможности

  • Информацию о применённом фильтре запроса теперь можно добавить в файл экспорта и печати. Для этого в окне предпросмотра экспорта и в окне предпросмотра печати добавлен флаг Фильтр запроса.
  • Добавлена возможность получения и вывода в журнал текста ошибки при неуспешном экспорте.

    Для этого нужно экземпляру типа Alarms добавить команду Action_OnExport с кодом обработчика в событии Invoked:

    DebugTool_1.Log("OnExport: path: " +GetEventParam(0));
    DebugTool_1.Log("OnExport: Error: " +GetEventParam(4));
    

    А в свойстве OnExport экземпляра типа Alarms сослаться на добавленную команду Action_OnExport.

Улучшения

  • Теперь при запуске приложения по ярлыку всегда выполняется принудительная компиляция проекта и автоматическое обновление выходной папки с результатом компиляции. Таким образом, теперь не нужно вручную очищать выходную папку для применения изменений, сделанных в проекте.
  • Ранее состояние флага Текст из окна экспорта не сохранялось ни в какой в конфигурационный файл, а введенный текст сохранялся в файл с настройками печати (print.json). Теперь же состояние флага Текст и сам текст сохраняются отдельно от настроек печати - в конфигурационный файл export.json.

Исправленные ошибки

Исправлены некритичные ошибки.

Изменения документации

Редакция 1

Руководство пользователя

2.2

Новые возможности

  • Реализован ввод даты и времени в фильтре отображения.
  • Добавлена возможность задавать допустимое количество листов для печати.
  • Реализована возможность блокировки и подавления событий.

Улучшения

Теперь при включении принудительного слежения за последним событием или слежения за последним поступившим событием слежение выполняется и за верхней и за нижней строкой.

Исправленные ошибки

  • Решена проблема с потерей выделения строк в настройках вида таблицы.
  • Исправлена ошибка, из-за которой было невозможно задать фильтр отображения по столбцу Тип события.
  • Исправлены другие некритичные ошибки.

2.1

Новые возможности

  • Стало удобнее добавлять стандартные столбцы. Теперь при добавлении нового столбца можно выбрать идентификатор из готового списка. Тип и описание стандартного столбца подгружаются автоматически.
  • Реализована возможность загрузки настроек приложения из файла app_settings.json. Пока из файла можно загрузить только параметры работы с экранной клавиатурой.

    Файл хранится по пути:

    • ОС Windows: C:\ProgramData\Automiq\HMI.Alarms
    • ОС Linux: /home/<user>/Automiq/HMI.Alarms
  • Добавлена возможность вызова экранной клавиатуры.

    Вызвать клавиатуру возможно:

    • При встраивании типа Alarms в проект.
    • В Alpha.HMI.Alarms как отдельном приложении при использовании настроечного файла app_settings.json.
  • Появилась возможность настройки форматов времени/даты для столбцов таблицы.

Улучшения

  • На панели запроса исторических данных добавлены кнопки Предыдущий интервал и Следующий интервал.
  • Изменено расположение элементов в окне настройки стиля события. Теперь слева находятся поля, управляющие условием применения декорирования, а справа - поля значений.
  • Теперь текстовая подсказка к ошибке всегда принудительно отображается рядом с полем ввода, содержащим ошибку.

Исправленные ошибки

  • Исправлена ошибка, из-за которой при печати страница разбивалась на два листа. Теперь при печати нет автоматического подбора высоты строк для переноса слов, и высота строк не увеличивается.
  • Устранены причины, по которым при использовании разрешения 1024*768 диалоговые окна выходили за пределы экрана.
  • Использование некорректных типов в столбцах приводило к возникновению исключения. Теперь типы столбцов float4/float8 заменены на float/double.
  • Устранены причины, приводившие к тому, что темы оформления не применялись к некоторым диалоговым окнам.
  • Исправлены другие некритичные ошибки.

2.1.1

Новые возможности

В окне предпросмотра экспорта добавлены возможности:

  • Вводить произвольный текст, который будет отображаться в начале файла экспорта (все форматы: *.csv, *.xlsx/*.xls, *.pdf). Теперь можно указывать, например, имя объекта, к которому относятся данные в файле.
  • Включать отображение информации о примененном фильтре в начале файла экспорта (все форматы: *.csv, *.xlsx/*.xls, *.pdf).

Исправленные ошибки

  • Исправлена ошибка, из-за которой при отключенном праве просмотра истории кнопка Исторический режим все равно была доступна.
  • Исправлены другие некритичные ошибки.

2.1.2

Изменение

Теперь на листе печати вместе с количеством отображаемых сообщений выводится также общее количество сообщений.

Исправленная ошибка

При многократном нажатии на кнопку печати аварийно завершалась работа Alpha.HMI. Во избежание повторения ситуации все кнопки и элементы окна предпросмотра теперь блокируются на время печати.

2.1.3

Изменение

Условия фильтрации, заданные с помощью функции SetAdvancedFilter, теперь автоматически подставляются в окно Фильтр отображения. Ранее при наличии расширенного фильтра (заданного с помощью функции SetAdvancedFilter) поля условий пользовательского фильтра (окно Фильтр отображения) оставались пустыми.

Изменения документации

Редакция 1

Руководство пользователя

Актуализированы некоторые скриншоты.

Справочное руководство

  • Заменен пример использования (теперь пример компилируется) для функции SetHistoricalInterval.

  • Обновлено описание свойства AcknowledgmentAvailable.

2.0

Новые возможности

  • Добавлена возможность отображать описание корневого объекта из пользовательского атрибута в пользовательском столбце.
  • Реализован запрос исторических данных по времени срабатывания. Для этого используйте выпадающий список кнопки Запросить данные.
  • Добавлена возможность установки критериев запроса исторических данных (новое свойство Расширяющий интервал (HistoryExpandInterval)) для экземпляра типа Alarms.
  • Добавлена панель с отображением прогресса печати и блокировка кнопок на время печати.
  • Добавлена возможность отключения сведения событий. При отключенном сведении события деактивации помещаются в отдельные строки и не объединяются с событиями активации. Для отключения сведения экземпляру типа Alarms добавлено свойство Режим сведения событий (MergeEvents) со значениями:
    • 0 - полное сведение;
    • 1 - частичное сведение;
    • 2 - отключенное сведение.

    Для отображения типа события (активация, квитанция квитирования, псевдоактивация, деактивация) и времени предшествующей активации в Alpha.HMI.Alarms теперь можно добавлять пользовательские столбцы с идентификаторами kind и prev_activation_time.

  • Реализовано мгновенное отключение звука после квитирования события.
  • Добавлена возможность отображения детальной статистики в строке состояния исторического режима (новое свойство Отображать детальную статистику по важности (DisplaySeverityStatistics) для экземпляра типа Alarms).
  • Добавлена возможность ограничения срока отображения оперативных событий. Для этого используйте узел Механизмы очистки в окне Параметры.
  • Добавлена возможность подгрузки исторических алармов в оперативном режиме с ограничением по количеству сообщений.
  • Добавлена возможность ограничения максимального количества событий (новое свойство Максимальное количество событий (MaxVisibleEvents) со значением по умолчанию - 4294967295).
  • Добавлена возможность просматривать графики сигналов-источников событий. Для просмотра графика используйте команду Открыть график в контекстном меню. Команда становится доступной при выделении одной и более строк в таблице.
  • В окне печати теперь можно указывать произвольный текст, который будет отображаться в верхнем колонтитуле на листе печати. Поле ввода можно использовать, например, для указания наименования объекта.
  • Добавлена возможность скрывать команды выпадающего меню кнопки Запросить данные. Для этого используйте флаги Предустановленные интервалы, Фильтр запроса, Выбор хронологии на узле Панель инструментов окна Параметры:
    • Флаг Предустановленные интервалы отвечает за видимость команд Последние 10 минут, Последние 30 минут, Последний час, Последние 6 часов, Последние 12 часов, Последние сутки.
    • Флаг Фильтр запроса отвечает за видимость команд Без фильтра и Запрос с фильтрацией.
    • Флаг Выбор хронологии отвечает за видимость команд По времени генерации и По времени срабатывания.

Изменения

  • Теперь при переходе между режимами исторический интервал не сбрасывается, а сохраняется.
  • При выключенном сведении в строке, соответствующей событию квитирования, значение не выводится.

Исправленные ошибки

  • Решены проблемы с применением темы оформления.
  • Исправлена ошибка, из-за которой неверно отображались данные в окне Сортировка.
  • Исправлена ошибка, из-за которой некорректно применялась фильтрация по дате и времени.
  • Устранена причина, по которой не отображалось контекстное меню для пустой таблицы.
  • Теперь функция SetAdvancedFilter корректно работает с оператором NOT.
  • Исправлены ошибки в работе фильтра отображения и функции SetAdvancedFilter, из-за которых отрицательные значения становились положительными.
  • Теперь при работе с большим числом сообщений (более 40 тыс.) квитирование выполняется значительно быстрее.
  • Исправлены другие некритичные ошибки.

2.0.1

Изменение

Принудительное слежение за последним событием и слежение за последним поступившим событием теперь означают слежение за верхней строкой при любой сортировке.

2.0.2

Исправленные ошибки

  • Устранена причина, по которой для свойства Имя приложения с правами безопасности не применялось значение, отличное от Alarms.
  • Исправлена ошибка, из-за которой при печати одна страница разбивалась на две.

Изменения документации

Редакция 1

Редакция 2

Внутренние изменения. Содержимое документа не изменилось.

1.3

Новые возможности

  • Автоматическое масштабирование листа для печати с учетом размеров столбцов.
  • Ручное добавление пользовательских столбцов таблицы сообщений о событиях. С пользовательскими столбцами можно выполнять все те же действия, что и со стандартными столбцами.

Изменения

  • Для приложения Alpha.HMI.Alarms добавлена иконка.
  • Теперь фильтрация в таблице сообщений регистронезависима.
  • Свойство HideAckedEvents (Не отображать неактивные квитированные события) объявлено устаревшим и будет удалено в следующих версиях. Вместо указанного свойства используйте настройку AckRequired в Alpha.Server.
  • Свойство ShowRelativeTag (Отображать относительный тег источника сообщения) объявлено устаревшим и будет удалено в следующих версиях. Теперь для указания тега родительского узла источника события добавляйте пользовательский столбец с идентификатором area_path.

Исправленные ошибки

  • Исправлена ошибка, из-за которой выделялись не те сообщения, по которым кликали мышкой.
  • Решены проблемы, приводящие к квитированию не тех сообщений, которые были выделены.
  • Исправлена ошибка, из-за которой не применялось значение свойства Не отображать неактивные квитированные события, заданное скриптом.
  • Устранена причина, по которой для пользователя без доступа к оперативному режиму (запрещено право ViewCurrentEvents) при запуске ошибочно устанавливался оперативный режим.
  • Решены проблемы с отображением комментария и времени генерации для событий, не требующих квитирования.
  • Исправлена ошибка при работе с двумя клиентскими экземплярами, из-за которой при выходе из одного клиента пользователь (не имеющий прав на квитирование) мог квитировать событие во втором клиенте.
  • Исправлено зависание при выделении слишком большого числа сообщений в таблице.

1.3.1

Внутренние изменения. Функциональность компонента не менялась.

1.3.2

Исправленные ошибки

  • Исправлена ошибка, из-за которой при печати большого числа страниц зависал проект Alpha.HMI.
  • Свойство Принудительное слежение за последним событием (FollowLatestEvent) больше не отключает возможность выделения строк в историческом режиме.
  • Решена проблема, из-за которой при неверно указанном пути экспорта не выводилось сообщение об ошибке. Теперь при неверно указанном пути экспорта и невозможности автоматически создать указанную папку появляется сообщение об ошибке. Если же указан несуществующий путь с существующим разделом диска, то папка будет автоматически создана при экспорте.

Изменения документации

Редакция 1

Внутренние изменения. Содержимое документа не изменилось.

Редакция 2

Руководство пользователя

Переработан раздел Экспорт сообщений в файл:

  • Описано сохранение сообщений в архив формата *.avz и загрузка такого архива.
  • Описана возможность предпросмотра таблицы и настройки ширины столбцов при экспорте.

  • Указаны пути сохранения экспортируемых файлов для ОС Winows и ОС Linux.

Редакция 3

Руководство пользователя

Справочное руководство

1.2

Важно. Текущая версия предназначена для использования в Alpha.HMI 1.9.0.

Новые возможности

  • Теперь в окне выбора цвета группы событий можно задавать десятичный или шестнадцатеричный код цвета в модели RGB.
  • Условия фильтра отображения теперь проверяются во время ввода.
  • Добавлена возможность комбинировать стили шрифта на вкладке Вид таблицы окна настроек.
  • Максимальное количество сообщений в таблице увеличено до 2147483647.
  • Добавлена возможность настройки ориентации страницы перед печатью и экспортом в .pdf.
  • Появилась возможность установки темной или светлой темы оформления (новое свойство Тема оформления для экземпляра типа Alarms).

Изменения

  • Обновлены окна авторизации пользователя, смены пароля, настройки печати и окно предварительного просмотра.
  • В окне авторизации и смены пароля кнопка изменения раскладки клавиатуры заменена на индикатор текущей раскладки.
  • Оптимизировано число столбцов на вкладке Настройка событий окна настроек:
    • Столбцы Фон, Текст и Пример заменены на столбец Сообщение.
    • Удалены столбцы Фон мигания и Текст мигания.
    • Столбцы Фон квитирования и Текст квитирования заменены на столбец Квитирование.

Исправления

  • Исправлено неверное выделение строк в настройках вида таблицы.
  • Устранён сбой в работе метода LoadConfiguration.
  • Верные условия фильтра запроса считались некорректными при отсутствии соединения с сервером.
  • Некорректно выполнялась сортировка в столбце Квитировано.
  • Исправлены некритичные ошибки, возникавшие при работе в OC Linux.

1.2.1

Новые возможности

Появилась возможность одновременного выбора нескольких предустановленных фильтров (выпадающий список Одновременное использование в узле Фильтры окна Параметры).

Изменения

  • Теперь для события по подусловию с атрибутами Sound=' ' и SoundEnabled='1' звук default.wav не проигрывается.
  • Звуковые файлы теперь хранятся отдельно от папки с конфигурационными файлами. Полный путь к звукам относительно папки проекта: ...\resources\Sounds\*.wav.
  • Конфигурационные файлы теперь хранятся по пути C:\ProgramData\Automiq\HMI.Alarms.
  • При экспорте файлы теперь сохраняются по пути C:\ProgramData\Automiq\HMI.Alarms\Export.

Исправления

  • Исправлены ошибки порядка воспроизведения звуков по приоритетам.
  • Исправлена ошибка, приводящая к зависанию дизайнера Alpha.HMI сразу после перехода в режим исполнения.
  • Исправлены другие некритичные ошибки.

1.2.2

Новые возможности

  • Реализована возможность отправки команд квитирования на ПЛК. Для экземпляра типа Alarms добавлено новое свойство OnAck. Из свойства OnAck можно сослаться на заранее созданную пользователем команду, скрипт которой будет выполняться при квитировании.

  • Появилась возможность запуска Alpha.HMI.Alarms в виде отдельного приложения по ярлыку из Пуск. Теперь Alpha.HMI.Alarms можно встраивать в проект автоматизации или использовать как отдельное приложение.

  • Добавлена возможность разрешения/запрета выделения нескольких строк в таблице сообщений (новое свойство Доступность выбора нескольких строк в таблице (MultiSelectAvailable) для экземпляра типа Alarms).

  • Добавлена возможность скрытия/отображения кнопок квитирования всех сообщений (новое свойство Доступность кнопок квитирования всех сообщений (AckAllAvailable) для экземпляра типа Alarms).

  • Количество предустановленных фильтров увеличено с 10 до 20 шт.

  • Появилась возможность выбора папки экспорта с помощью диалога.

Изменения

  • Свойство Доступность кнопок квитирования (AcknowledgmentAvailable) теперь называется Доступность функций квитирования (AcknowledgmentAvailable).

Исправления

  • Исправлена ошибка, из-за которой в некоторых случаях уже проигранные звуки проигрывались повторно.
  • Исправлены другие некритичные ошибки.

1.2.3

Новые возможности

Размер и положение главного окна приложения сохраняются в папке текущего пользователя:

  • Windows: C:\Users\<user>\Automiq]\HMI.Alarms\session.json
  • Linux: /home/<user>/Automiq/HMI.Alarms/session.json

Исправления

  • Решены разного рода проблемы с отображением комментария при квитировании для сообщений, не требующих квитирования.

  • Исправлена ошибка, из-за которой цвета темы не применялись для шрифта полей ввода даты и времени в интервале запроса.

  • Решена проблема с сохранением файлов с настройками в папку для другого внешнего модуля, используемого в проекте (Trends).

  • Исправлены другие некритичные ошибки.

Изменения документации

Редакция 2

Руководство пользователя

  • Обновлено описание интеграции Alpha.HMI.Alarms в проект автоматизации.
  • Добавлено описание обновления компонента Alpha.HMI.Alarms, встроенного в проект автоматизации.
  • Актуализированы скриншоты.

Справочное руководство

Редакция 3

Руководство пользователя

  • Переработано описание интеграции Alpha.HMI.Alarms в проект Alpha.HMI:
    • Раздел "Администрирование" заменен на раздел "Встраивание в проект".
    • Описание подключения внешнего модуля Alpha.HMI.Alarms и обновления встроенного модуля объединено в единый раздел.
    • Раздел "Установка и удаление" вынесен за пределы бывшего раздела "Администрирование".
    • Описано добавление экземпляра типа Alarms в проект.
    • Описание подключения к источнику данных включено в раздел с описанием добавления экземпляра типа Alarms в проект.
  • Добавлено описание запуска Alpha.HMI.Alarms в виде самостоятельного приложения.

1.0

1.0.1

Улучшения

  • добавлены столбцы Группа важности и Активность
  • в окне Экспорт данных теперь отображается статус экспорта
  • в окне Печать добавлены стрелки для перехода по страницам

Исправленные ошибки

  • при запуске с Alpha.HMI.WebViewer:
    • в окне Печать названия некоторых кнопок отображались не полностью
    • в окне Экспорт данных при успешном экспорте данных генерировалась ошибка
    • в окне Параметры в узле Настройка событий некорректно отображались названия столбцов
    • после применения любого фильтра пользователя сообщения переставали отображаться
    • не проигрывались звуки из-за некорректного построения пути к звуковым файлам
  • в ОС Linux:

    • исправлено ошибочное накопление очереди звуковых алармов при длительной работе приложения

    • уменьшена длительность подготовки таблицы событий к печати

    • в оперативном режиме при задании фильтра отображения по столбцу Важность возникала ошибка

    • при использовании функции SetHistoricalInterval в строке запроса не отображался запрашиваемый временной интервал

1.0.2

Новые возможности

  • кроме текущих форматов теперь список отображаемых сообщений о событиях можно сохранять в формате .pdf
  • появилась возможность настройки начертания шрифта текста в строках сообщений и заголовках столбцов
  • появилась возможность выбора столбцов, которые будут мигать
  • появилась возможность настройки отображения сообщений для отдельных подусловий генерации события
  • теперь цвет фона и текста строки можно настраивать не только для всех квитированных событий, но и для квитированных событий с определенной важностью

Исправленные ошибки

  • альтернативная конфигурация не загружалась и подменялась файлами по умолчанию при указании абсолютного пути
  • файлы альтернативной конфигурации создавались по неверному пути
  • файл экспорта сохранялся без настроек фильтрации, сортировки и декорирования с подусловием
  • событие по сигналу типа float или double отображалось со значением сигнала 0 вместо реального значения сигнала
  • при печати вместо значений сигналов отображались некорректные символы
  • декорирование событий с определенным подусловием не применялось при печати
  • при запуске с Alpha.HMI.WebViewer:
    • после перезагрузки страницы путь сохранения файлов менялся на путь по умолчанию

    • отсутствовала возможность исправления значений в полях настроек и полях окна Регистрация пользователя

1.0.3

Новые возможности

Добавлена функция GetSoundActivity, позволяющая следить за переходом очереди звуков из пустого состояния в непустое.

Исправленные ошибки

Функция ClearAcknowledgedEvents не удаляла из таблицы сообщения о событиях, не требующих квитирования.

1.0.4

Новые возможности

  • добавлена возможность предпросмотра вида таблицы и изменения ширины столбцов перед экспортом
  • теперь за очередью звуков можно следить с помощью ссылок на команды (OnPlayingSounds и OnFinishedPlayingSounds), которые вызываются при событиях начала и окончания проигрывания очереди звуков

Изменения

  • удалена функция GetSoundActivity, позволявшая следить за очередью звуков

Улучшения

  • теперь сообщения об отсутствии звуков в папке выводятся в Журнал времени исполнения (desktop) и в Журнал приложений (web-версия)
  • функция ClearOperativeEventList теперь возвращает значение типа int4 с результатом своей работы
  • функция ClearAcknowledgedEvents теперь возвращает значение типа int4 с результатом своей работы

Исправленные ошибки

  • фильтрация с помощью функции SetAdvancedFilter не выполнялась по столбцам важности, группы важности и времени
  • настроенные условия фильтра отображения/фильтра запроса сбрасывались после выбора команды Без фильтра
  • не блокировалась кнопка Вернуться к значениям по умолчанию при настройках вида таблицы по умолчанию
  • в печать попадали не только сообщения, существующие в таблице на момент открытия окна предварительного просмотра, но и остальные поступившие сообщения
  • функция ClearOperativeEventList и ClearAcknowledgedEvents работали в режиме снимка

Изменения документации

Редакция 2

Руководство пользователя

Справочное руководство

Редакция 3

Справочное руководство

  • удалено описание свойства Не квитировать события, не требующие квитирования (DontAcknowEventsIfNotRequiring)

  • добавлено описание свойства Отображать миллисекунды (ShowMilliseconds)

  • обновлено описание функции RequestRecentEvents:

    • изменено описание возможных значений параметра onlyNotAcked

    • исправлены ошибки в синтаксисе примера

    • добавлено примечание об отсутствии звуков подгружаемых сообщений

    • расширено описание функции

    • расширено описание параметра intervalDuration

  • обновлено описание функции SetAdvancedFilter:
    • в таблицу с перечислением идентификаторов добавлен столбец Тип данных в столбце

    • в таблицу с перечислением операторов добавлен столбец с указанием разрешенных типов

    • обновлены примеры
    • удалено описание неиспользуемых операторов
    • добавлено описание операторов И, ИЛИ, НЕ
    • обновлены правила составления условий фильтрации
    • расширено описание функции