Отладчик скриптов LUA (rtLUADebug)#
Утилита Отладчик скриптов предназначена для отладки и тестирования скриптов написанных с помощью языка LUA.
При выполнении программ, написанных с использованием языка LUA эти программы выполняются в окружении, которое содержит пред-определенные функции для работы с конфигурацией, глобальные переменные и сервисные функции, описанные в разделе (РТС LUA API).
Основное окно#
Основное окно утилиты rtLUADebug.exe.
Окно утилиты состоит из следующих областей:
Область текста программы - область, в которой пишется программа. После запуска, если в программе есть ошибка, строка с ошибкой выделяется красной строкой.
Окно вывода информации - область, в которой отображается результат тестирования/отладки программы.
Дневник состояния - список сообщений генерируемые утилитой во время выполнения различных операций в виде выпадающего списка.
Информационная строка - указывает положение курсора в области текста программы.
Меню#
Меню основного окна утилиты состоит из четырех закладок: 
.
Файл
Новая программа
Создает новую, пустую программу и очищает все области утилиты.
Открыть текст программы
Открывает стандартный диалог для выбора и загрузки ранее сохраненной программы.
Сохранить текст программы
Сохраняет изменения внесенные в текст программы в файл из которого она была загружена.
Сохранить как
Открывает стандартный диалог для сохранения текста программы в файл с расширением lua.
Настройка
Открывает диалог настройки утилиты.
Сохранить настройки
Сохраняет все текущие настойки программы в файл конфигурации утилиты.
Выход
Завершает работу утилиты.
Конфигурация
Это меню предназначено для работы с конфигурацией РТС.
При выполнении программы отладчик автоматически предоставляет доступ к данным загруженной конфигурации для кода программы.
Для тестирования программ необходимо иметь данные конфигурации, в противном случае провести тестирование программы будет невозможно: пункт главного меню будет не активен.
Загрузить конфигурацию
При выборе пункта открывается стандартный диалог с возможностью выбора файла с конфигурацией для загрузки.
Очистить данные
При выборе пункта осуществляется удаление данных конфигурации.
Просмотр переменных
Открывает стандартное для ПО РТС окно со списком переменных.
Выполнение
Запуск / Остановка
Запускает программу на исполнение или останавливает ее работу, если программа уже запущена.
Очистить окно лога
Очищает окно вывода информации.
Просмотр лог файла
Открывает стандартный диалог для загрузки лог файла создаваемого при работе программы.
Сохранять лог файл
Если 
, то данные выводимые программой при работе будут автоматически сохраняться в лог файл.
Удалить лог файл
Удаляет текущий лог файл исполнения программы.
Сообщения и ошибки
Выводит стандартное окно сообщений, создаваемых при работе программы.
Загруженные библиотеки
Отображает стандартный для ПО диалог загруженных дополнительных библиотек.
При исполнении программы можно использовать дополнительные библиотеки. Каждая внешняя библиотека будет загружена только один раз, при первом вызове. В этом диалоге можно просмотреть список загруженных в программу библиотек.
Окно
Следующее окно
Переключает курсор между областью текста программы и окном вывода информации.
Настройки#
Настройка утилиты осуществляется через панель меню .
Диалог настроек состоит из трех закладок: 
.
Общие
Авто-сохранение настроек
Если , то при завершении программы настройки утилиты будут автоматически сохранены в конфигурационном файле.
Сохранение данных из окна вывода в файл
Если , то все данные выводимые утилитой или программой в окно вывода будут автоматически сохраняться в лог файл.
Количество строк в окне вывода
Указывается предельное число строк в окне вывода.
При превышении количества строк выше числа указанного в настройках, более ранние строки будут удаляться.
Ограничение количества строк влияет только на их отображение в окне вывода и не влияет на содержимое лог файла.
Программа
Загружать последнюю открытую программу
Если , то при запуске утилиты будет загружаться программа, открытая в прошлый сеанс работы утилиты.
Открываемая программа указана в окне ниже настройки. Поле заполняется автоматически на основе данных последнего загруженного или сохраненного файла.
Основной файл программы
Позволяет выбрать основной файл работы программы.
Основной файл - это файл, с которого начнется исполнение программы при запуске.
Основной файл и текущий редактируемый могут быть разными файлами. В случае, если текст программы сложный, то его можно разделить на отдельные файлы, при этом вне зависимости от того какой файл в настоящее время открыт в утилите для редактирования, исполнение программы начнется с указанного файла.
Автосохранение редактируемого файла перед запуском
Если , то перед запуском программа (главное меню или клавиша F9), система автоматически бет сохранять изменения текста программы в файл, из которого она была загружена.
Шрифт текста в редакторе
Определяет шрифт и размер символов, которыми будет выводиться текст программы в редакторе текста.
Данные
Загружать последнюю открытую конфигурацию
Если , то при запуске утилиты будет загружаться конфигурация, открытая в прошлый сеанс работы программы.
Загружаемая конфигурация будет указана в поле Используемый файл.
Открывать список переменных при загрузке данных
Если , то при загрузке конфигурации будет автоматически открыто стандартное для ПО окно со списка переменных.
Отображать изменяемые значения
Если и при работе программа изменяет значения переменных, то эти изменения будут выведены в окно вывода.
Эта настройка позволяет автоматически следить за работой алгоритма, основанного на внесение изменений в значения переменных.
Устанавливать значения команд
Если , то при выполнении функции отправки команды в окне вывода будет выведена информации об устанавливаемом значении.
Эта настройка позволяет автоматически следить за работой алгоритма в котором используется отправка команд.
Устанавливать текущее время при изменении значения
Если , то при установке новых значений или отправке команд штамп времени для нового значения будет автоматически установлен в текущее в момент выполнения функции время.
Ключи командной строки#
Использование командной строки для передачи данных программе описано в разделе «Ключи командной строки».
Утилита rtLUADebug.exe поддерживает следующие ключи командной строки:
rtLUADebug.exe [ПАРАМЕТРЫ] [ФАЙЛ]
|
Устанавливает имя для основного лог файла программы. Если ключ не указан, то для файла лога будет использовано имя по умолчанию, соответствующее имени программы, с указанием даты создания и расширением |
|
Если указан, то лог файл вестись не будет. |
|
Если ключ не указан, то для файла конфигурации будет использовано имя по умолчанию, которое, как правило, совпадает с именем программы. |
|
Загружает указанный файл конфигурации IngortechSCADA. |
|
Если указан, то выполнение скрипта будет начато сразу же после запуска программы. Для использования этого параметра необходимо, чтобы скрипт и конфигурация били загружены в утилиту отладчика. |
ФАЙЛ |
Загружает указанный файл скрипта с расширением |