Alpha.Community

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

Подключение сторонней библиотеки

В Alpha.DevStudio можно подключить стороннюю библиотеку. Это может быть удобно, когда требуется функциональность, которая не предоставляется Alpha.DevStudio.

Из сторонней библиотеки можно вызвать функцию. Для этого:

  1. В Панели элементов перейдите в Вычисления.
  2. В раскрывшемся списке выберите элемент Внешняя функция.
  3. Добавьте этот элемент в проект.
  4. Заполните обязательные Свойства элемента Внешняя функция, подсвеченные красным цветом – Имя файла и Имя функции. Описание свойств элемента Внешняя функция приведено в таблице Свойства элемента Внешняя функция.
  5. При необходимости настройте остальные свойства элемента Внешняя функция.
  6. Добавьте входные и выходные параметры функции, нажав на символе элемента Внешняя функция на Диаграмме.
  7. Настройте Свойства добавленных параметров.
Свойства элемента Внешняя функция
Свойство Описание
Имя файла Имя сторонней библиотеки.
Имя функции Имя функции, вызываемой из сторонней библиотеки.
Тип возвращаемого значения Тип значения, возвращаемого вызываемой функцией.
Соглашение о вызове

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

Возможные значения:

  • SDecl – соглашение cdecl;
  • StdCall – соглашение stdcall;
  • WinApi – соглашение stdcall;
  • Default – соглашение cdecl.

Значение по умолчанию – Default.

Кодировка символов

Кодировка символов.

Возможные значения:

  • Utf8 – кодировка UTF-8;
  • Utf16 – кодировка UTF-16;
  • Ansi – кодировка ANSI.
  • Значение по умолчанию – Utf8.
Имя Имя добавленного элемента Внешняя функция.

Маршалинг

При использовании сторонней библиотеки может возникнуть необходимость маршалинга. Чтобы выполнить маршалинг в Alpha.DevStudio:

  1. На символе элемента Внешняя функция на Диаграмме выберите параметр, для которого требуется выполнить маршалинг.
  2. Добавьте этому параметру атрибут Способ маршалинга строки, расположенный в Om.Server→Attributes→Sprint. Подробнее о добавлении атрибутов написано в разделе Добавление атрибутов.
  3. Укажите необходимое значение для добавленного атрибута Способ маршалинга строки:

    • None – маршалинг не выполняется;
    • Buffer – маршалинг выполняется с применением буфера. В этом случае данные будут преобразованы в формат, подходящий для хранения или передачи в буфере. Использование буфера позволяет хранить значение параметра в оперативной памяти, а также сослаться на это значение в коде обработчика события.

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

Такой проект в Alpha.DevStudio можно реализовать, добавив элементы:

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

Использование этих элементов в проекте может выглядеть так:

При изменении значения сигнала Server будет активирован обработчик события. Этот обработчик:

  • будет использовать значение сигнала Server для определения состояния сервера;
  • получит имя локального компьютера, используя функцию сторонней библиотеки ExternalFunction.

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