Alpha.Community

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

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

2.5

Улучшение

Формат иконок приложения изменен на SVG. Ранее использовался формат PNG.

Исправления

  • При повторном открытии конфигурационного файла уставок содержимое карты, которая была открыта ранее, не отображалось в области просмотра карт уставок.
  • Значения уставок, введенные в режиме ПЛК и сохраненные в оперативный архив, не отображались при переходе в режим Архив, если для файлов оперативного архива в ОС установлен режим "Только для чтения".

2.5.1

Исправление

Устранена причина, по которой при сохранении значений в ПЛК из архива уставок не все значения записывались корректно.

2.5.2

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

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

Редакция 1

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

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

Редакция 2

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

2.4

Улучшения

  • Для уставок с типом значения bool теперь можно выбирать формат отображения значения. Формат отображения указывается в конфигурационном файле в поле Format в следующем виде: falseText|trueText.
  • В таблице просмотра уставок теперь можно включить фильтрацию значений по столбцам.
  • Экранную клавиатуру теперь можно вызвать в любом месте, где подразумевается ввод значений. Ранее экранную клавиатуру можно было вызвать только в окне подключения к серверу. Чтобы отобразить кнопку вызова экранной клавиатуры в приложении, измените в конфигурационном файле app_settings.json значения параметров раздела ScreenKeyboard.

Исправления

  • Экспорт карт уставок в файл теперь по умолчанию выполняется в папку, расположенную в C:\ProgramData\Automiq\HMI.SetPoints. Ранее папка экспорта располагалась в папке пользователя.
  • Устранена причина, по которой изменение значения свойства Доступность файловой системы (FileSystemAccess) типа Разрешения не приводило к фактическому изменению доступности файловой системы в диалоговом окне экспорта сообщений из журнала в файл.
  • Значения уставок в таблице и значения уставок в окне сравнения с источником теперь форматируются одинаково.
  • Устранена причина ошибочного автоматического подключения к локальному серверу при перезапуске приложения, возникавшего в том случае, если при предыдущем использовании приложения не было выполнено ни одного подключения.
  • Устранена причина возникновения ошибок при подключении экземпляра типа SetPoints к источнику данных, у которого указано значение свойства Путь (Path).

2.4.1

Исправление

Устранена причина, по которой редактор значения выбранной ячейки открывался в случайном месте, если помимо выбранной ячейки были выделены и другие ячейки таблицы.

2.4.2

Изменение

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

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

Исправления

Исправлены ошибки фильтрации в таблице просмотра уставок:

  • Введенные значения уставок не отображались в выпадающем списке фильтра, позволяющем отфильтровать столбец по значениям.
  • При переключении режима с ПЛК на Архив и обратно значения в выпадающем списке фильтра не обновлялись.

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

Редакция 1

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

2.3

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

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

Изменение

Теперь значения уставок вводятся непосредственно в ячейки по двойному щелчку левой кнопки мыши, нажатию клавиши F2 или нажатию клавиши текста/цифр. Такие возможности ввода значений появились благодаря тому, что таблица теперь построена на основе типа Редактируемая таблица (EditableTable) из библиотеки Alpha.HMI.CommonLib.

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

Настройки уставок не подгружались из постоянного архива в оперативный архив.

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

Редакция 1

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

Структура Руководства пользователя обновлена:

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

2.2

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

  • Разработана возможность ограничения доступа пользователей к файловой системе. Доступ к файловой системе регулируется с помощью свойства FileSystemAccess (Доступность файловой системы) экземпляра компонента SetPoints_Permissions. Если у пользователя отсутствует доступ к файловой системе (FileSystemAccess = false), то:
    • в файловых диалогах будет недоступен просмотр дерева папок и создание новых папок.
    • загрузка конфигураций будет возможна только из папки, указанной в свойстве ConfigFolder (Папка с конфигурациями) компонента SetPoints_Settings.
    • экспорт будет возможен только в папку, указанную в свойстве ExportFolder (Папка для экспорта) компонента SetPoints_Settings.
    • По умолчанию в качестве папок для хранения конфигураций и экспорта используются папки Cfg и Export, расположенные в:
      • C:\ProgramData\Automiq\HMI.SetPoints\ - в ОС Windows;
      • /home/<user>/Automiq/HMI.SetPoints/ - в ОС Linux.
    • Теперь при экспорте в файл или при печати данных можно использовать колонтитулы. Верхний и нижний колонтитул редактируются отдельно: для них могут быть указаны разные текст и положение. При формировании текста колонтитула можно использовать текстовые шаблоны. Для этого понадобится экземпляр типа Текстовые шаблоны из библиотеки CommonLib.
    1. Создайте экземпляр типа Текстовые шаблоны. С помощью функции Set(string name, varuant value) компонента создайте сам текстовый шаблон. Пример: Templates.Set("Участок","Участок 1");

    2. Сошлитесь на созданный экземпляр из свойства Шаблоны (init_Templates) типа SetPoints.

      Тогда в окне редактирования колонтитулов станет активной кнопка Вставить шаблон, раскрывающая список доступных текстовых шаблонов.

      Если для определения прав пользователей используется сервер безопасности, возможность изменять настройки колонтитулов можно ограничить. Для этого в конфигурации подсистемы безопасности необходимо добавить пользователям право EditSettings (Редактирование настроек) с нужными значениями.

Улучшения

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

Исправление

Устранена причина, по которой настройки доступа к файловой системе для пользователей не распространялись на кнопку Выбрать папку при экспорте всех карт уставок в файл.

2.2.1

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

Добавлены всплывающие подсказки для ячеек с ошибочным значением уставки.

Изменение

Теперь при отсутствии уставок, которые можно изменять, скрываются кнопки Сохранить в ПЛК, Прочитать из ПЛК и Загрузить из архива. Такое изменение реализовано по причине того, что задачи, выполняемые этими кнопками, не нужны при отсутствии у параметров тегов на запись.

Исправление

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

2.2.2

Изменения

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

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

  • В типе SetPoints у свойства Уставки были изменены (pSetPointsChanged) тип значения Команда сменился на Обработчик события.
  • Для форм SetPoints_Form и SetPoints_Page добавлены ссылки pSetPointsChanged.

Если вы желаете получить массив изменений на своей форме:

  1. В свойстве Уставки были изменены (pSetPointsChanged) экземпляра типа SetPoints сошлитесь на экземпляр компонента Обработчик события (из состава Alpha.HMI.CommonLib).
  2. В обработчике события Invoked экземпляра компонента Обработчик события пропишите вызов функции Args.Get(). Результатом вызова этой функции будет json-строка с массивом изменений.

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

  • Устранены сообщения (при компиляции/запуске проекта в рантайм) об использовании устаревшей функции Files.WriteTextFile из состава Alpha.HMI.CommonLib.
  • Исправлена ошибка, из-за которой на предпросмотр печати и на печать не выводился последний столбец карты уставок.

2.2.3

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

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

Изменения

Некорректно устанавливались размеры форм таблицы при открытии карт уставок. Это происходило из-за доработок в Alpha.HMI: изменения механизма установки геометрии и позиционирования окна на мониторе. Теперь внутренние механизмы Alpha.HMI и Alpha.HMI.SetPoints приведены в соответствие и размеры формы таблицы устанавливаются верно.

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

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

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

Редакция 1

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

Редакция 2

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

2.1

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

  • Добавлена возможность указывать в конфигурационном файле необходимость переноса слов. Чтобы включить/отключить перенос слов, используйте флаг WordWrap (true / false) у элемента Columns.
  • Добавлена возможность вызова экранной клавиатуры в диалоговых окнах:
    • задания имени папки для экспорта таблицы в Excel;
    • авторизации;
    • открытия файлов;
    • ввода значений уставок.

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

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

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

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

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

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

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

Улучшение

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

2.1.1

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

Улучшен экспорт карт уставок в MS Excel:

  • Теперь можно экспортировать не только все карты уставок сразу, но и всего одну - текущую.
  • Добавлено диалоговое окно экспорта, в котором можно:
    • Выбрать папку для экспорта.
    • Выбрать тип файла: *.csv или *.xlsx.
    • Ввести произвольный текст, который будет отображаться в верхнем колонтитуле (например, наименование объекта).
    • Указать имя экспортируемого файла.
  • Прогресс выполнения экспорта отображается в статусной строке.

Изменение

Настройки колонтитулов при экспорте и печати для всех сразу карт уставок указываются теперь в одном месте - поле PrintSettings.

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

Устранена причина, по которой в файле оперативного архива отсутствовала запись о флаге уставки.

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

Редакция 1

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

Редакция 2

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

2.0

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

  • Добавлена возможность подключения к серверу, защищенному паролем.
  • Добавлена фильтрация в дереве карт уставок.
  • Переработан механизм безопасности. Для ограничения прав пользователей добавлен новый тип Разрешения (SetPoints_Permissions). Вместо свойств Доступность файловой системы (FileSystemAccess) и Только для чтения (IsReadOnly) типа SetPoints теперь используйте свойства Доступность файловой системы (FileSystemAccess) и Изменение значений (Modification) типа Разрешения. Также новый тип содержит свойства Выбор принтера (PrinterSelecting), Разрешенные принтеры (AllowedPrinters) и Экспорт в файл (Export).

    В свойстве Разрешенные принтеры (AllowedPrinters) принтеры указывайте в виде JSON массива.

    ["Send To OneNote 2013","Snagit 2019","HP LaserJet Pro MFP M426f-M427f PCL 6"]

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

    В экземпляре типа SetPoints в параметре инициализации Разрешения сошлитесь на нужный экземпляр типа Разрешения.

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

  1. Создайте в подсистеме безопасности приложение для Alpha.HMI.SetPoints с правами Modification (Изменение значений), FileSystemAccess (Доступ к файловой системе), PrinterSelecting (Выбор принтера), Printers (Принтеры) и Export (Экспорт в файл). В праве Printers (Принтеры) список принтеров нужно указывать отдельными значениями.
  2. Для экземпляра типа Разрешения:

    1. Включите использование подсистемы безопасности (в свойстве Использовать сервер безопасности для определения прав (UseSecurity)).
    2. Укажите имя приложения, которое вы используете для Alpha.HMI.SetPoints в подсистеме безопасности (в свойстве Имя приложения с правами безопасности (SecurityApplication)).

2.0.1

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

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

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

Редакция 1

Обновлены скриншоты в разделе с описанием встраивания Alpha.HMI.SetPoints в проект.

1.3

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

  • Добавлен выпадающий список ранее открываемых конфигурационных файлов, из которого можно быстро выбрать и загрузить конфигурацию.
  • Реализована возможность подключения к произвольному серверу. Для этого используйте кнопку "Подключиться к серверу" на панели инструментов.
  • Добавлены готовые формы для использования в пользовательских проектах:
    • Форма SetPoints_Form, которую можно открывать как диалоговое окно. Форма содержит панель инструментов, дерево навигации, таблицу с уставками и строку статуса. Для формы нужно указать инициализирующие параметры: init_ApSource (Ссылка Источник данных), init_ConfigFilePath (Путь к файлу конфигурации), init_IsReadOnly (Только для чтения) и init_RestoreWindow - (Восстанавливать размер и положение окна при запуске).
    • Форма SetPoints_Page, которую можно открывать как содержимое фрейма. Форма содержит панель инструментов, дерево навигации и таблицу с уставками (без строки статуса). Для формы нужно указать инициализирующие параметры: init_ApSource (Ссылка Источник данных), init_ConfigFilePath (Путь к файлу конфигурации) и init_IsReadOnly (Только для чтения).

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

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

1.3.1

Изменение

В диалоге редактирования уставки теперь отображается то же самое значение, что и в таблице.

1.3.2

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

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

Улучшение

Заголовки столбцов теперь автоматически переносятся на новую строку, если не вмещаются в ширину столбца.

1.3.3

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

Не отображалось целое число в редакторе значения уставки, если в региональных настройках ОС использовалась группировка по разрядам.

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

Редакция 1

Редакция 2

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

1.2

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

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

Конфигурационный файл

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

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

Исправлена ошибка, из-за которой при загрузке архива карты уставок столбец типа float отображался как bool.

1.2.1

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

  • Добавлена проверка на соответствие точности, указанной в конфигурационном файле в виде формата, например, %.3f. Проверяются значения, полученные с ПЛК и вводимые в окне редактирования. Значение с большей точностью отображается в таблице красным цветом. Ввод нового значения с большей точностью не допускается.
  • Для сигналов с флагами уставок поддержаны следующие типы: uint1, uint2, uint4, uint8.

Улучшения

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

Изменения

Максимальное число тэгов на запись/чтение настроек уставок увеличено со 150 до 1000. При превышении количества тэгов на запись/чтение уставки в журнал выводится уведомление.

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

  • Исправлена логика записи настроек уставки в ПЛК. Теперь true записывается в указанный бит при включении уставки/сообщения/звука, а не при отключении, как было раньше. Команды в контекстном меню теперь отображают состояние флагов без частицы не: Использовать уставку, Подавать звуковой сигнал, Выдавать сообщение.
  • Устранено дублирование идентификаторов Alpha.HMI.Alarms и Alpha.HMI.SetPoints.

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

Редакция 1

Редакция 2

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

1.1

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

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

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

Устранены проблемы с работой горячей клавишей Esc в ОС Linux. Теперь отмена ввода значений снова возможна.

1.1.1

Изменения

Отключен перенос текста в ячейках таблиц карт уставок.

Исправления

  • Исправлены проблемы некорректного встраивания компонента в проект Alpha.HMI.
  • Исправлено неверное формирование имени папки с архивными данными при отсутствии в файле конфигурации идентификатора конфигурации (параметр Id) и пути сохранения архивных файлов (параметр Path).
  • Исправлена ошибка, из-за которой значения, записанные в контроллер в режиме Архив, не отображались в режиме ПЛК.
  • Устранена причина, по которой в ОС Linux при запуске режима исполнения в файл session.json записывался неверный путь к конфигурации.
  • Исправлена ошибка, при которой значение типов int8 и uint8 ограничивалось диапазоном значений int4.

1.1.2

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

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

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

Редакция 1

  • Раздел "Администрирование" заменен на раздел "Встраивание в проект".
  • Раздел "Установка и удаление" вынесен за пределы бывшего раздела "Администрирование".
  • Добавлено описание:
    • интеграции Alpha.HMI.SetPoints в проект автоматизации.
    • обновления компонентаAlpha.HMI.SetPoints, встроенного в проект автоматизации.
    • добавления экземпляра типа SetPoints в проект.