Alpha.Community

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

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

2.8

Улучшение

Добавлена возможность масштабирования окна приложения, а также типов и форм, поставляемых в составе компонентов расширения. Масштаб приложения можно изменить в файле app_settings.json, а для компонентов – применив к ним тему оформления.

Исправления

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

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

Редакция 1

Описана возможность масштабирования окна приложения:

2.7

Улучшение

Типу IntegrityConfiguration и форме IntegrityConfiguration_Form добавлены свойства-ссылки на обработчики событий, активирующихся при выполнении загрузки конфигурации из файла (init_LoadedFromFile) и сохранения конфигурации в файл (init_SavedInFile).

Исправление

Исправлено исключение, возникавшее при подключении к узлу из окна конфигурирования контроля целостности.

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

Редакция 1

  • В руководстве пользователя актуализирован раздел Запуск в виде самостоятельного приложения: здесь описано назначение файла app_session.json, хранящего настройки сессии приложения.
  • Актуализировано справочное руководство: для каждого элемента расширения обновлено описание и списки свойств, функций и событий.

2.6

Улучшения

  • Добавлены новые компоненты расширения – IntegrityConfiguration и IntegrityConfiguration_Form. Используйте их для создания собственных приложений, позволяющих менять настройки контроля целостности.
  • Формат иконок приложения изменен на SVG. Ранее использовался формат PNG.

Исправления

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

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

Редакция 1

Актуализировано справочное руководство:

Также в руководстве пользователя актуализированы скриншоты.

2.5

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

  • В окне конфигурирования контроля целостности теперь можно сохранить конфигурацию в файл *.json или загрузить конфигурацию из такого файла. Для этого на панель инструментов добавлены соответствующие кнопки.
  • Рядом с кнопкой подключения к узлу добавлена кнопка, открывающая список недавних подключений – для удобства повторного подключения.

Исправления

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

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

Редакция 1

В руководстве пользователя:

Также актуализировано справочное руководство.

2.4

2.4.1

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

Добавлена возможность изменения настроек контроля целостности на локальном и удаленных узлах. Для этого на панель инструментов приложения добавлены кнопки:

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

Улучшение

В таблице просмотра результатов проверок целостности раскрытые строки больше не сворачиваются после ручного запуска проверки целостности.

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

Редакция 1

В руководстве пользователя:

Также актуализировано справочное руководство.

2.3

Улучшения

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

Изменение

Изменены расположение и содержимое конфигурационных файлов приложения и компонентов расширения:

  • Настройки приложения хранятся в файлах app_settings.json и settings.json, расположенных в папке:
    • C:\ProgramData\Automiq\HMI.IntegrityControl для ОС Windows;
    • /home/<user>/Automiq/HMI.IntegrityControl для ОС Linux.
  • Настройки сессии приложения хранятся в файле app_session.json. Настройки компонентов и сессий компонентов хранятся в файлах layout.json, session.json, tests.json и window.json. Все перечисленные файлы расположены в папке:
    • C:\Users\<user>\Automiq\HMI.IntegrityControl для ОС Windows;
    • /home/<user>/Automiq/HMI.IntegrityControl для ОС Linux.

Исправление

Исправлена ошибка фильтрации списка файлов в экземпляре типа IntegrityControl, у которого для свойства Показывать только файлы с нарушением целостности (ShowOnlyChanged) установлено значение true.

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

Редакция 1

Изменена структура руководства пользователя:

Также в руководстве пользователя:

  • Бывший раздел "Установка и удаление" переименован в Подготовка к работе и расширен: в него добавлена информация о требованиях к окружению.
  • Обновлена информация о настройках контроля целостности.
  • Бывший раздел "Экспорт в файл" переименован в Экспорт результатов проверки целостности в файл и расширен: в нем описана возможность изменения папки экспорта, открываемой при сохранении файла по умолчанию.
  • Бывший раздел "Ограничение возможностей пользователей при выполнении контроля целостности файлов" переименован в Настройки безопасности для разграничения возможностей пользователей и расширен: настройка разграничения возможностей пользователей описана как для приложения, разработанного в Alpha.HMI с использованием компонентов, предоставляемых расширением Alpha.HMI.IntegrityControl, так и для самого приложения Alpha.HMI.IntegrityControl.

2.2

Улучшение

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

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

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

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

Редакция 1

Документ разделен на руководство пользователя и справочное руководство.

В справочном руководстве:

  • Описаны все типы и формы, предоставляемые внешним модулем Alpha.HMI.IntegrityControl, приведены их свойства и функции.
  • Приведен пример использования типа IntegrityControl в проекте.

В руководстве пользователя:

2.1

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

  • Папка для экспорта теперь указывается через поле ExportFolder отдельного типа IntegrityControl_Settings. Такой способ задания папки экспорта заменил существующий ранее - через свойство ExportFolder компонента IntegrityControl. Если же для указания папки экспорта не использовать тип IntegrityControl_Settings, данные будут экспортироваться в папку:
    • ОС Windows: C:\ProgramData\Automiq\HMI.IntegrityControl\Export
    • ОС Linux: /home/<user>/Automiq/HMI.IntegrityControl/Export
  • Реализована возможность ограничения доступа пользователя к файловой системе. Для ограничения доступа укажите значение false в свойстве FileSystemAccess у объекта разрешений Permissions. При ограниченном доступе для пользователя:
    • В файловых диалогах будет недоступен просмотр дерева папок и создание новых папок.
    • Экспорт будет возможен только в папку экспорта, указанную в свойстве ExportFolder типа IntegrityControl_Settings.

2.1.1

Улучшение

Панель инструментов теперь оформляется в соответствии с выбранной темой.

2.1.2

Улучшение

Ускорена загрузка результатов контроля целостности файлов.

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

Редакция 1

Актуализировано описание API.

Редакция 2

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

Редакция 3

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

2.0

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

Для ограничения прав пользователей вместо свойств Разрешить выполнять проверку (AllowCheck) и Разрешить создание эталонных значений (AllowCreateEtalon) типа IntegrityControl теперь используйте новый тип Разрешения (IntegrityControl_Permissions). Новый тип содержит свойства Проверка файлов (CheckFiles) и Создание эталонных значений (CreateEtalon).

При переходе на новую версию Alpha.HMI.IntegrityControl для использования нового типа Разрешения вам потребуется доработать проект.

В экземпляре типа IntegrityControl в параметре инициализации Разрешения сошлитесь на нужный экземпляр типа Разрешения. Если вы используете IntegrityControl_Form, можете создать экземпляр разрешений прямо в обработчике открытия формы.

Если вы желаете использовать систему безопасности для ограничения прав пользователя:

  1. Создайте в подсистеме безопасности приложение для Alpha.HMI.IntegrityControl с правами:
    • CheckFiles (Проверка файлов);
    • CreateEtalon (Создание эталонных значений).
  2. Для экземпляра типа Разрешения:
    • Включите использование подсистемы безопасности (в свойстве Использовать сервер безопасности для определения прав (UseSecurity)).
    • Укажите имя приложения, которое вы используете для Alpha.HMI.IntegrityControl в подсистеме безопасности (в свойстве Имя приложения с правами безопасности (SecurityApplication).

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

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

2.0.1

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

2.0.2

  • Добавлена возможность вызова экранной клавиатуры в диалоговых окнах:
    • экспорта в файл;

    • авторизации.

    Для отображения кнопки вызова клавиатуры нужно включить эту функцию в параметре init_ScreenKeyboard (по умолчанию кнопка появляется только в диалоге авторизации).

  • Для Alpha.HMI.IntegrityControl, работающего в виде отдельного приложения, реализована возможность загрузки настроек из файла app_settings.json.

    Загрузить можно:

    • Параметры работы с виртуальной клавиатурой. Чтобы включить клавиатуру, используйте параметр Enabled элемента ScreenKeyboard.

    • Разрешение использования сервера безопасности для ограничения прав пользователя. Чтобы разрешить использовать сервер безопасности, используйте параметр UseSecurity в элементе Permissions.

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

    • ОС Windows: C:\ProgramData\Automiq\HMI.IntegrityControl
    • ОС Linux: /home/<user>/Automiq/HMI.IntegrityControl

Изменение только для формы IntegrityControl_KTN

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

Улучшение

Теперь текстовая подсказка к ошибке всегда принудительно отображается рядом с полем ввода, содержащим ошибку.

2.0.3

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

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

Изменение

В Alpha.Security 1.7.6 добавлена возможность классифицировать серьёзность нарушений каждого типа. На основе этого в Alpha.HMI.IntegrityControl изменились поля в группе Statistic (используемой для вывода информации через ссылку pUpdateOutputViewData).

Что изменилось:

  • Поле valid теперь называется violations и отражает количество нарушений вместо количества файлов без нарушений целостности.
  • Поле warrning теперь называется warnings и отражает количество предупреждений вместо количества файлов с измененной датой, но корректной контрольной суммой.
  • Поле alarm теперь называется errors и отражает количество ошибок вместо количества файлов с нарушением целостности (новые, удаленные и измененные файлы).

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

Редакция 1

Редакция 2

Редакция 3

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

1.3

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

  • Переработано API компонента, используемого для встраивания в проекты пользователя. Ранее этот компонент назывался IC_Tree, теперь называется IntegrityControl. API компонента стало проще и понятней для использования.

    Состав нового API:

    • Свойства:

      • NodeName для задания имени узла сети.

      • AllowCheck, разрешающее выполнять проверку.

      • AllowCreateEtalon, разрешающее создавать эталонные значения.

      • ShowOnlyChanged для включения фильтрации элементов дерева и отображения только файлов с нарушением целостности.

      • Status, содержащее описание текущей операции.

      • Error, содержащее описание ошибки, которая произошла при выполнении последней операции.

    • Команды:

      • Check для проверки контролируемых файлов на узле, указанном в свойстве NodeName.

      • CreateEtalon для создания эталона на узле, указанном в свойстве NodeName.

    • Добавлены объекты Information и Statistic, с помощью свойств которых можно получить дополнительную информацию о целостности системы.

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

    • Свойства формы:

      • AllowCheck, разрешающее выполнять проверку.

      • AllowCreateEtalon, разрешающее создавать эталонные значения.

    • Параметры инициализации:

      • init_NodeName для задания имени узла сети.

      • init_RestoreWindow для разрешения восстановления положения окна.

  • В строке статуса теперь выводится текст ошибок подключения к узлу.

  • Реализовано сохранение ширины столбцов в дереве файлов.

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

Исправлена проблема, из-за которой не работали свойства AllowCheck (Разрешить выполнять проверку) и AllowCreateEtalon (Разрешить создание эталонных значений).

1.3.1

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

Добавлена возможность экспорта данных из дерева в таблицу формата *.csv и *.xlsx.

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

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

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

Редакция 1

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

1.2

1.2.1

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

1.1

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

Реализован запуск Alpha.HMI.IntegrityControl в виде отдельного приложения по ярлыку из Пуск.

1.1.1

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

В окне подключения к узлу теперь можно выбрать тип узла: локальный или удаленный.

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

Редакция 2

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