Alpha.Community

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

Подключение к серверу для просмотра дерева сигналов

В разделе продемонстрировано применение компонентов Диалог подключения к серверу, Диалог ввода учетных данных, Дерево сигналов.

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

Приложение реализовано в виде проекта-примера. Скачайте проект-пример и откройте в Дизайнер Alpha.HMI для наглядности.

На главной форме проекта размещены кнопки подключения к серверу и ввода учетных данных сервера, поле вывода дерева сигналов. В качестве вспомогательных компонентов используются экземпляры компонентов Результат выбора меню, Обработчик события, Команда,int4, Результат выбора параметров подключения, Источник AP, Учетные данные AP, Окружение: файлы.

Запустите проект-пример в рантайм. Откроется окно приложения, в котором доступны:

  • кнопка подключения к серверу;
  • кнопка ввода учетных данных сервера;
  • поле вывода дерева сигналов.

Подключение к серверу

Для подключения к серверу нажмите . Активируется событие ButtonPressed объекта ConnectBtn, открывающее Диалог подключения к серверу в новом окне.

В диалоговом окне укажите адрес, порт сервера, учетные данные сервера и нажмите Подключение.

  • Адрес, порт сервера и учетные данные сохраняются в экземпляр Результат выбора параметров подключения ConnectDialogResult, указанный в свойстве pResult компонента Диалог подключения к серверу.
  • Адрес и порт сервера из экземпляра Результат выбора параметров подключения передаются в Источник AP ServerSource по команде Complete. Ссылка на Complete указана в свойстве OkAction компонента Диалог подключения к серверу.

  • Учетные данные из экземпляра Результат выбора параметров подключения сохраняются в файл, откуда передаются в экземпляр ApCredentials типа Учетные данные AP. В свойстве Источник учетных данных экземпляра Источник AP указана ссылка на ApCredentials. После этого происходит попытка подключения к серверу.

    Ознакомьтесь с кодом обработчика события Invoked команды Complete, написанным на языке Alpha.Om.

    // сохранение адреса и порта сервера
    ServerSource.Location=ConnectDialogResult.Location;
    ServerSource.Port=ConnectDialogResult.Port;
    // сохранение в файл учетных данных
    passwordFile: string = FileSystem.CombinePath(FileSystem.ProjectFolder, "password.txt");
    FileSystem.WriteTextFile(passwordFile, ConnectDialogResult.Credentials);
    // подгрузка сохраненных значений в ApCredentials
    ApCredentials.FilePath = passwordFile;
    ApCredentials.Load();
    // запуск подключения или сервера (если до этого он был выключен)
    ServerSource.Active = true;

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

  • адрес и порт сервера уже указаны в свойствах экземпляра компонента Источник AP, и для подключения к серверу требуется ввести пароль;
  • требуется изменить пароль, введенный в Диалоге подключения к серверу.

Для того чтобы ввести только учетные данные для подключения к серверу, нажмите . Активируется событие ButtonPressed объекта SetPasswordBtn, открывающее Диалог ввода учетных данных в новом окне.

В диалоговом окне укажите пароль и нажмите ОК.

  • Введенный пароль передается в экземпляр ApCredentials типа Учетные данные AP.
  • Активируется команда SetPassword, ссылка на которую указана в свойстве OkAction компонента Диалог ввода учетных данных. Происходит попытка подключения к серверу.

    Ознакомьтесь с кодом обработчика события Invoked команды SetPassword, написанным на языке Alpha.Om.

    ServerSource.Active = true;

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

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

В свойстве pMouseRightClicked указывается ссылка на обработчик события MouseRightClicked. Для того чтобы контекстное меню открывалось рядом с выбранным узлом, координаты курсора передаются в экземпляры mouseX и mouseY типа int4. Выполняется команда MenuOpen, открывающая контекстное меню. Ознакомьтесь с кодом обработчика события MouseRightClicked, написанным на языке JavaScript.

var arg = JSON.parse(Args.Get());
mouseX = arg.ScreenX;
mouseY = arg.ScreenY;
MenuOpen.Invoke();

Для задания пунктов контекстного меню необходимо создать функцию и сослаться на нее в свойстве Элементы меню обработчика события Invoked команды MenuOpen. В данном примере создана функция MenuItemsFunction. Ознакомьтесь с кодом этой функции, написанным на языке JavaScript.

var items = [
{
'id': "txt",
'title': "Сохранить в файл"
}
];
return JSON.stringify(items);

При выборе пункта из списка контекстного меню:

  • Результат выбора меню сохраняется в MenuResult.
  • Активируется команда SaveToFile, сохраняющая описание выбранного узла в файл. Ознакомьтесь с кодом обработчика события Invoked этой команды, написанным на языке Alpha.Om.

    // сохранение в файл описания выбранного узла
    itemFile: string = FileSystem.CombinePath(FileSystem.ProjectFolder, "item.txt");
    FileSystem.WriteTextFile(itemFile, SignalTree.GetCurrentItemInfo());

В результате происходит сохранение описания выбранного узла в файл. Файл сохраняется в папке output, расположенной в папке проекта.