Alpha.Community

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

Свойства

Тема оформления (init_Theme)

Ссылка на экземпляр типа Тема оформления, хранящий настройки оформления. Тип предоставляется библиотекой Alpha.HMI.CommonLib.

Разрешения (init_Permissions)

Ссылка на экземпляр типа Разрешения, хранящий настройки доступа пользователей к файловой системе в диалогах открытия и сохранения файлов.

Вызов экранной клавиатуры (init_ScreenKeyboard)

Ссылка на экземпляр типа Параметры вызова экранной клавиатуры, хранящий настройки вызова экранной клавиатуры. Тип предоставляется библиотекой Alpha.HMI.CommonLib.

Имя узла сети (NodeName)

Имя узла Alpha.Net, к которому подключается экземпляр типа.

Тип значения – уведомляющий string.

Имя узла указано в файле конфигурации Alpha.Net. Можно не указывать значение, если узел локальный.

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

Status

Описание текущего статуса чтения или записи конфигурации контроля целостности. Только для чтения в режиме рантайма.

Тип значения – уведомляющий string.

Error

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

Тип значения – уведомляющий string.

Есть несохраненные изменения (HasUnsavedChanges)

Отображает наличие изменений в текущей конфигурации.

Значения:

  • true – текущая конфигурация изменена;
  • false – текущая конфигурация не изменена.

Тип значения – уведомляющий bool.

Пусть требуется сохранять конфигурацию по нажатию кнопки, которая неактивна до тех пор, пока конфигурация не будет изменена. Чтобы сохранять конфигурацию, в обработчике события ButtonPressed этой кнопки можно использовать команду UpdateConfig. Чтобы проверять, была ли изменена конфигурация, в свойстве Включено этой кнопки можно настроить Вычисляемое значение, которое будет использовать формулу. Почитать о формуле можно в документации на Alpha.HMI → Руководство пользователя → Разработка мнемосхем → Действия с объектами и экранными формами → Просмотр характеристик → Свойства объектов → Свойства в рантайме → Вычисляемые значения свойств. В формуле следует указать: MyIntegrityConfiguration.HasUnsavedChanges.

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

OperationInProgress

Отображает статус выполнения какой-либо операции.

Значения:

  • true – выполняется длительная операция, например, асинхронная операция запроса данных и последующая обработка ответа;
  • false – не выполняется никакая операция.

Тип значения – уведомляющий bool.

Пусть требуется сохранять конфигурацию по нажатию кнопки, которая становится неактивной на время операции. Чтобы сохранять конфигурацию, в обработчике события ButtonPressed этой кнопки можно использовать команду UpdateConfig. Выполнение операции следует отслеживать по значению свойства OperationInProgress. Чтобы использовать значение свойства OperationInProgress в вашем проекте:

  1. Добавьте в тип IntegrityConfiguration уведомляющее поле типа bool. О добавлении пользовательских полей можно почитать в документации на Alpha.HMI → Руководство пользователя → Разработка мнемосхем → Действия с объектами и экранными формами → Просмотр характеристик → Свойства объектов → Пользовательские поля объектов. Пусть это поле называется DisableUI. Это поле появится в свойствах типа IntegrityConfiguration.
  2. Теперь в поле DisableUI необходимо подписаться на свойство OperationInProgress. Для этого укажите его Вычисляемое значение как OperationInProgress.

Чтобы блокировать кнопку на время сохранения конфигурации, в ее свойстве Включено можно настроить Вычисляемое значение, которое будет использовать формулу. Почитать о формуле можно в документации на Alpha.HMI → Руководство пользователя → Разработка мнемосхем → Действия с объектами и экранными формами → Просмотр характеристик → Свойства объектов → Свойства в рантайме → Вычисляемые значения свойств. В формуле следует указать: !MyIntegrityConfiguration.OperationInProgress.

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

pSessionChanged

Ссылка на экземпляр типа Обработчик события, который активируется при смене состояния подключения к узлу.

Настройки (init_Settings)

Ссылка на экземпляр типа Настройки, позволяющий указывать папку для экспорта результатов контроля целостности в файл.

Выполнено сохранение конфигурации в файл (pSavedInFile)

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

В экземпляре типа Обработчик события можно получить аргументы возникшего события – JSON-строку вида:

{
 "FilePath":"<путь к файлу>",
 "FileName":"<имя файла>",
 "IsSuccessful":<true/false>,
 "Error":"<текст ошибки>"
}

Здесь:

  • FilePath – путь к файлу, в который сохранена конфигурация.
  • FileName – имя файла.
  • IsSuccessful – информация об успешном сохранении файла. Принимает значение true, если файл сохранен успешно. Если файл не сохранен, то принимает значение false.
  • Error – текст ошибки, возникшей при сохранении файла.

Чтобы получить аргументы события, используйте код на языке JavaScript: var arg = JSON.parse(Args.Get());.

Полученную JSON-строку можно использовать, например, для записи сообщения аудита безопасности. Подробнее о функциях, записывающих сообщения аудита безопасности, можно почитать в документации на Alpha.HMI.Security → Справочное руководство → Контекст безопасности (SecurityContext) → Функции.

Эту строку можно также использовать для записи сообщения в экземпляр типа Журнал сообщений, предоставляемый библиотекой Alpha.HMI.CommonLib.

Выполнена загрузка конфигурации из файла (pLoadedFromFile)

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

В экземпляре типа Обработчик события можно получить аргументы возникшего события – JSON-строку вида:

{
 "FilePath":"<путь к файлу>",
 "FileName":"<имя файла>",
 "IsSuccessful":<true/false>,
 "Error":"<текст ошибки>"
}

Здесь:

  • FilePath – путь к файлу, из которого загружена конфигурация.
  • FileName – имя файла.
  • IsSuccessful – информация об успешной загрузке файла. Принимает значение true, если файл был загружен успешно. Если файл не загружен, то принимает значение false.
  • Error – текст ошибки, возникшей при загрузке файла.

Чтобы получить аргументы события, используйте код на языке JavaScript: var arg = JSON.parse(Args.Get());.

Полученную JSON-строку можно использовать, например, для записи сообщения аудита безопасности. Подробнее о функциях, записывающих сообщения аудита безопасности, можно почитать в документации на Alpha.HMI.Security → Справочное руководство → Контекст безопасности (SecurityContext) → Функции.

Эту строку можно также использовать для записи сообщения в экземпляр типа Журнал сообщений, предоставляемый библиотекой Alpha.HMI.CommonLib.