Alpha.Community

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

Получение информации об операционной системе, среде исполнения и текущей сессии Alpha.HMI

Для получения информации о системе, на которой запущено приложение Alpha.HMI, а также для определения среды исполнения и получения данных о текущей сессии, используйте компоненты: Окружение: система, Среда исполнения и Сессия.

Окружение: система

Компонент Окружение: система предоставляет информацию о текущей операционной системе, на которой работает приложение Alpha.HMI. Компонент позволяет получить различные характеристики системы, такие как название операционной системы, версия, семейство, ядро, версия ядра и порядок байтов.

Компонент Окружение: система расположен в юните Окружение библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

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

Подробнее о свойствах компонента Окружение: система.

Среда исполнения

Компонент Среда исполнения позволяет определить среду исполнения проекта Alpha.HMI: desktop или web.

Компонент Среда исполнения расположен в юните Встроенные библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах компонента Среда исполнения.

Сессия

Компонент Сессия предоставляет информацию о текущей пользовательской сессии проекта Alpha.HMI. Набор доступных данных зависит от среды запуска проекта Alpha.HMI:

  • При запуске с помощью Alpha.HMI.WebViewer компонент предоставляет полную информацию о сессии: параметры сетевого подключения (IP-адреса, порты), уникальный идентификатор сессии, cookie, User-Agent браузера пользователя, а также тип и режим открытия сессии.
  • При обычном запуске компонент предоставляет информацию о типе сессии и версионную информацию приложения Alpha.HMI.

При обычном запуске проекта Alpha.HMI компонент Сессия всегда возвращает новую сессию, пустой Cookie, нулевой идентификатор сессии, нулевые порты и IP-адрес 127.0.0.1.

Компонент Сессия расположен в юните Встроенныебиблиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах компонента Сессия.

Пример использования компонентов

Далее кратко описан пример (скачать его можно здесь) использования компонентов Окружение: система, Среда исполнения и Сессия в проекте Alpha.HMI с использованием языка Alpha.Om.

В примере показано, как:

  • Получить информацию о текущей операционной системе, на которой работает приложение Alpha.HMI, с помощью компонента Окружение: система.
  • Определить среду исполнения проекта Alpha.HMI (desktop или web) с использованием компонента Среда исполнения.
  • Получить информацию о текущей сессии с помощью компонента Сессия.

Получение информации о текущей операционной системе

  1. Для получения информации о текущей операционной системе добавьте на экранную форму компонент Окружение: система.

  2. Подготовьте текстовое поле, в котором будет отображаться информация о системе.

  3. Воспользуйтесь обработчиком события Opened для просмотра информации о системе сразу после открытия экранной формы. В этом обработчике пропишите следующий код:

    // Получаем информацию о системе и выводим её в текстовое поле
    Text_1.Text = "Name: " + System_1.Name + "\n" +
    ⠀⠀ "Family: " + System_1.Family + "\n" +
    ⠀⠀ "Version: " + System_1.Version + "\n" +
    ⠀⠀"Kernel: " + System_1.Kernel + "\n" +
    ⠀⠀ "KernelVersion: " + System_1.KernelVersion + "\n" +
    ⠀⠀ "Endianness: " + (System_1.Endianness == 0 ? "BigEndian" : "LittleEndian");
  4. Запустите форму в режиме рантайм, и информация о системе будет отображена в текстовом поле.

Определение среды исполнения проекта

  1. Для получения информации о текущей среде исполнения проекта Alpha.HMI добавьте на экранную форму компонент Среда исполнения.

  2. Подготовьте дополнительное текстовое поле, в котором будет отображаться информация о среде исполнения проекта Alpha.HMI.

  3. Воспользуйтесь обработчиком события Opened для получения информации о среде исполнения проекта Alpha.HMI сразу после открытия экранной формы. В этом обработчике пропишите следующий код:

    // Объявление переменной для хранения информации о среде исполнения проекта
    currentMode: uint1 = Runtime_1.WorkMode;
    modeInfo: string;
    if ( currentMode == 0)
    ⠀⠀⠀modeInfo = "Проект запущен в режиме desktop.";
    else if (currentMode == 1)
    ⠀⠀⠀⠀modeInfo = "Проект запущен в режиме web.";
    Text_2.Text = modeInfo; // Выводим информацию о среде исполнения в текстовое поле

  4. Запустите форму в режиме рантайм, и информация о среде исполнения проекта Alpha.HMI будет отображена в текстовом поле.

Получение информации о текущей сессии

  1. Для получения информации о текущей сессии добавьте на экранную форму компонент Сессия.
  2. Подготовьте текстовое поле, в котором будет отображаться информация о сессии.
  3. Воспользуйтесь обработчиком события Opened для получения информации о сессии сразу после открытия экранной формы. В этом обработчике пропишите следующий код:

    // Получаем информацию о сессии и выводим её в текстовое поле
    sessionKind: string;
    sessionOpenMode: string;

    // Определяем тип сессии
    if (Session_1.Kind == 0)
    ㅤㅤsessionKind = "Desktop";
    else
    ㅤㅤsessionKind = "Web";

    // Определяем режим открытия сессии
    if (Session_1.OpenMode == 0)
    ㅤㅤsessionOpenMode = "Новая сессия";
    else
    ㅤㅤsessionOpenMode = "Восстановление сессии";

    // Формируем и выводим строку с информацией о сессии
    Text_3.Text = "Тип сессии: " + sessionKind + "\n" +
    ㅤㅤ"Режим открытия: " + sessionOpenMode + "\n" +
    ㅤㅤ"ID сессии: " +String.ToString(Session_1.Id) + "\n" +
    ㅤㅤ"Cookie: " + Session_1.Cookie + "\n" +
    ㅤㅤ"Клиент: " + Session_1.ClientAddress + ":" + String.ToString(Session_1.ClientPort) + "\n" +
    ㅤㅤ"Сервер: " + Session_1.ServerAddress + ":" + String.ToString(Session_1.ServerPort) + "\n" +
    ㅤㅤ"User-Agent: " + Session_1.ClientUserAgent;
  4. Запустите форму в режиме рантайм, и информация о текущей сессии будет отображена в текстовом поле.