Alpha.Community

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

Подключение к Alpha.Reports

Местонахождение библиотеки

Файл библиотеки Alpha.Reports.HMI.dll расположен в папке установки Alpha.Reports:

  • Windows: C:\Program Files\Automiq\Alpha.Reports\HMI
  • Linux: /opt/Automiq/Alpha.Reports/HMI

Режим работы без визуального сопровождения (без GUI)

В библиотеке реализованы Logon и Logoff без визуального сопровождения. Alpha.HMI вызывает методы Logon/Logoff из библиотеки Alpha.Reports.HMI.dll вместе с вызовами соответствующих методов Alpha.Security после ввода пользователем логина и пароля. Alpha.Reports.HMI.dll запрашивает у OpenLDAP токен IsAdmin. Если IsAdmin=true, то Alpha.Reports предоставляет доступ к своим функциям, иначе Alpha.Reports возвращает текст ответа Доступ запрещён и не предоставляет доступ к своим функциям. После успешного логона Alpha.HMI сам определяет, какие отчёты/шаблоны показывать пользователю через функции.

Режим работы с визуальным сопровождением (GUI)

Требуется для работы с Alpha.Reports.Designer и Alpha.Reports.Configurator в окне проекта Alpha.HMI.

После авторизации в Alpha.HMI должна быть вызвана функция Logon в Alpha.Reports.HMI.dll, которая вернёт строку авторизации для подключения между веб-клиентом и сервером Alpha.Reports. Секретная строка должна подставляться ко всем URL в виде параметра auth: http://127.0.0.1:5000/Report/Configurator/?auth=Секретная строка. Если IsAdmin=true, то Alpha.Reports предоставляет доступ к своим функциям, иначе Alpha.Reports возвращает страницу с надписью Доступ запрещён. Любой другой браузер без уникальной строки авторизации будет получать в ответ страницу с надписью Доступ запрещён.

Подключение библиотеки в проект Alpha.HMI

Чтобы получить строку авторизации в проекте Alpha.HMI, добавьте в него библиотеку Alpha.Reports.HMI.dll.

Перед добавлением библиотеки нужно установить пакеты установки .Net Core.

Инструкция по установке в ОС AstraLinux находится здесь: https://wiki.astralinux.ru/pages/viewpage.action?pageId=41192241.

Добавление библиотеки:

  1. В дизайнере Alpha.HMI откройте проект, в котором нужно реализовать получение командной строки.
  2. В меню выберите Проект → Ссылки на юниты....

    Откроется окно Редактор ссылок на юниты.

    В нём:

    1. В контекстном меню выберите Добавить из файлов.

    2. В окне выбора файла выберите файл Alpha.Reports.HMI.dll.

    3. В окне Редактор ссылок на юниты для добавленного файла должен быть выбран тип .Net Core. Если выбран другой, укажите нужный тип вручную.

Библиотека будет загружена в проект.

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

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

В пустом проекте:

  1. Добавляем экранную форму.

  2. На форму в раздел «Данные» добавляем объект Main_1 и присваиваем ему базовый тип Main из добавленной библиотеки.

    Данный объект будет использоваться в функциях, описанных далее.

  3. На форму добавляем две кнопки: Logon и GetAuthString.

    1. Для кнопки Logon добавляем событие по нажатию кнопки (ButtonPresssed) с кодом:

      Main_1.Logon("manager", "qwerty@123", "http://127.0.0.1:5000");
    2. Для кнопки GetAuthString добавляем событие по нажатию кнопки (ButtonPressed) с кодом:

      DebugTool_1.Log(Main_1.GetAuthString());
  4. Запускаем форму в рантайме.
  5. По очереди, нажимаем на кнопки Logon и GetAuthString.

    В результате в журнал событий будет выведена строка авторизации.