?? API: Разработка для сервера РТС#

Предупреждение

В настоящее время документация в этом разделе отсутствует.

Если Вам необходима документация по этой теме, то просьба сообщить об этом.

Начиная с версии «2025-10-27» в комплект установочного файла ПО IngortechSCADA входят средства разработки для создания пользовательского функционала расширяющего возможности СКАДА.

Установка#

Для установки средств разработки необходимо при установке ПО, на странице выбора дополнительных задач выбрать необходимые компоненты в группе «Средства разработки»:

../_images/setup.png

После установки выбранные компоненты будут установлены в папку API каталога установки.

Состав#

Основной язык использования средств разработки С++. Возможно использование средств разработки в различных языковых средах, которые позволяют исполнять код из внешних библиотек Windows, таких как C#, Python, Go и т.д.

Предупреждение

Библиотека интерфейса представляет из себя 32-битную динамическую библиотеку ОС Windows, поэтому средой использования средств могут быть только ОС, позволяющие выполнять бинарный код в формате ОС Windows.

Средства разработки состоят из следующих частей:

  • Библиотека rtsClient.dll, которая содержит код для доступа к функционалу IngortechSCADA.

  • Заголовочный файл для языка С++ rtsClient_API.h содержащий описание функций библиотеки доступа.

  • Заголовочные файлы описания структур используемых при взаимодействии с сервером РТС.

  • Каталоги с примерами использования расположенные в отдельных каталогах, поименованных по мере усложнения в формате «НОМЕР_ИМЯ».

  • Исходные коды сервисных функций для использования библиотеки расширения и файлы требуемые для ее использования в различных средствах сборки.

В настоящее время поддерживаются следующие средства сборки:

  • Borland CPP Builder 5+

  • Visual CPP Studio 2017+

Каждый пример содержит готовый проект для всех поддерживаемых средств сборки, предназначенный для сборки исполняемого файла примера.

Функционал АПИ#

Весь функционал средств разработки, функции, используемые структуры и правила их использования описан в заголовочном файле rtsClient_API.h и настоящей документации.

Предупреждение

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

В случае обнаружения подобных расхождений, для корректировки документации, просьба обратиться в отдел разработки IngortechSCADA.

С использованием функционала средств разработки можно создавать программы, реализующие следующие функции:

  • Получение данных текущей конфигурации используемой сервером РТС.

  • Получение данных реального времени.

  • Получение управляющих воздействий (команд).

  • Отправка серверу изменяемых данных для переменных (источник данных).

  • Отправка управляющих воздействий (команд).

Предупреждение

Для реализации любого функционала доступа к серверу РТС необходимо использовать учетную запись имеющую права для выполнения необходимых операций.

Разработчики IngortechSCADA не несут ответственность за исполнение или вред вызванный исполнением ПО, созданного с помощью предоставленного АПИ средств разработки.

Вся ответственность за разрешение эксплуатации подобных средств лежит на службе эксплуатации объектов, которые настраивают и поддерживают права для доступа к серверу РТС.

Доступ к серверу РТС#

Для подключения к серверу РТС необходимо использовать учетную запись имеющую необходимые для выполнения созданного функционала права.

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

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

Учетная запись для автоматических утилит

Это специальная учетная запись, которая не может быть использована пользователем и предназначена для исполнения различных утилит ПО IngortechSCADA с заведомо известным функционалом.

Все утилиты ПО выполняющие действия с сервером, кроме Конфигуратора и Оболочки оператора используют автоматические учетные записи.

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

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

  • Использование специальной тестовой учетной записи с именем «APITest».

    Ее использование необходимо специально разрешить в файле настроек ПО.

  • Расширить список автоматически поддерживаемых сервером утилит.

    для этого необходимо связаться с отделом разработки ПО IngortechSCADA и ???

режимы работы#

  • Обычный клиент ??

  • Datasource ??

Интерфейс АПИ#

Структуры и типы данных:

??

Функции:

??

Типы данных#

??

RTS_CODEPAGE#

RTS_CONNECT_FLAGS#

…

Функции#

??

RTS_SetupClient#

RTS_LogMessage#

…