Изменения

Перейти к: навигация, поиск

Отладчик встроенных скриптов

1080 байт добавлено, 08:53, 8 декабря 2025
→‎Подключение отладчика к работающим скриптам
= Отладчик скриптов = == Обзор =Интерфейс =
[[Файл:ScriptDebugger.png]]
'''Отладчик скриптов''' — рабочий инструмент для разработки и диагностики [[Руководство_программиста|скриптов встроенного языка]].
Он позволяет запускать скрипты в режиме отладки, останавливать выполнение на нужных строках, анализировать переменные и подключаться к уже запущенным скриптам.
Вы можете запустить отладчик при наличии прав Администратораиз:* Через меню '''Отчеты > SQL > Выполнить > Запустить отладчик''' . * Через меню '''Отчеты > Дополнительные возможности > Редактировать'''.* Горячей клавишей '''Ctrl+Alt+D''' в главном окне приложения.
== Основные возможности ==
* '''Запуск в режиме отладки''' — выполнение скрипта с остановкой на заданных строках
* '''Наблюдение за выражениями''' — вычисление произвольных выражений при каждой остановке
* '''Точки останова''' — остановка выполнения на выбранных строках кода
* '''AttachDebuggerПодключение к скриптам''' — подключение к уже выполняющемуся скриптузапущенному без отладчика
* '''Работа с файлами''' — открытие, сохранение и отслеживание изменений файлов скриптов
* '''Сохранение в базу данныхРасширенный редактор''' — запись отредактированных скриптов в БД- подсветка парных скобок, отображение скрытых симолов, закладки.
== Интерфейс отладчика ==
=== Редактор кода ===
Основная область для написания и редактирования скрипта. Редактор поддерживает:
* Визуальное отображение точек останова (красные кружки в левом поле)
* Подсветку текущей строки выполнения (желтый фон)
* Подсветку парных скобок при установке курсора* Отображение скрытых символов* Закладки для быстрой навигации === Лог ===
Отображает:
* Вывод команд сообщений напрямую из скрипта и команды Printкомандой '''print'''
* Сообщения отладчика (остановка на breakpoint, ошибки)
* Временные метки для каждого сообщения в формате [hh:nn:ss]
 
=== Список переменных ===
 
Показывает все переменные и объекты текущего контекста с их текущими значениями.
Обновляется автоматически при каждой остановке на точке останова.
 
=== Список наблюдения ===
 
Позволяет отслеживать произвольные выражения во время выполнения.
Значения выражений пересчитываются и отображаются при каждой остановке.
 
=== Кнопки управления ===
 
* '''Запустить''' — запуск скрипта в режиме отладки (F9)
* '''Остановить''' — аварийная остановка выполняющегося скрипта
* '''Продолжить''' — возобновление выполнения после остановки на точке останова (F9)
== Работа с отладчиком Кнопки управления ==
=== * '''Запустить''' — Запуск скрипта ===в режиме отладки (F9). При необходимости установите точки останова, cкрипт выполнится до первой точки останова или до ошибки.* '''Остановить''' — Прерывание дальнейшего исполнения скрипта. Во время выполнения скрипта можно нажать и удерживать клавишу '''ESC''' для аварийной остановки.* '''Продолжить''' — Возобновление выполнения после остановки скрипта (F9)
# Введите или откройте скрипт в редакторе# При необходимости установите точки останова# Нажмите кнопку «Запустить» или клавишу F9# Скрипт выполнится до первой точки останова или до ошибки= Работа с отладчиком =
=== Установка точек останова ===Точки останова можно настроить перед запуском скрипта или когда выполнение скрипта приостановлено. Добавление точки останова:
'''Способ 1.''' Щёлкните левой кнопкой мыши в левой части нужной строки (область номеров строк). На строке появится красный кружок — точка останова установлена. Повторный щелчок удалит её.
'''Способ 2.''' Установите курсор на строку и используйте пункт меню '''Скрипт''' > '''Добавить точку останова (F5)'''.
'''Важно.''' Точки останова всегда останавливают выполнение на указанной строке, дополнительные условия не поддерживаются. === Просмотр переменных === При остановке на точке останова все переменные автоматически отображаются в списке. Значения обновляются при каждой остановке.
=== Наблюдение за выражениями ===Список '''Переменные''' содержит все переменные и объекты доступные в текущем инстансе интерпретатора. Список автоматически отображаются в момент остановки выполнения скрипта.
== Наблюдение за выражениями ==
Список '''Наблюдения''' показывает все добавленные пользователям выражения и их рассчитанные значения. Значения обновляются автоматически в момент остановки выполнения скрипта или после редактирования выражения. Для добавления наблюдения:
# Выделите текст в редакторе (например, имя переменной или выражение)
# Выберите в контекстном меню > редактора пункт '''Добавить в наблюдение'''
# Либо используйте меню '''Скрипт''' > '''Добавить наблюдение (Сtrl+F5)''' и введите выражение вручную.
 
Выражение будет добавлено в список и пересчитываться при каждой остановке.
'''Примеры выражений:'''
* $i > 0 — логическое условие
=== Продолжение выполнения === После остановки на точке останова:# Просмотрите значения переменных и выражений наблюдения# При необходимости скорректируйте точки останова или выражения# Нажмите кнопку '''Продолжить (F9)''' — выполнение продолжится до следующей точки останова или завершения скрипта === Остановка выполнения === Во время выполнения скрипта можно:* Нажать кнопку '''Остановить (ESC)''' для аварийной остановки* Нажать и удерживать клавишу ESC для прерывания выполнения == Работа с файлами ==
=== Открытие файла с отслеживанием ===
Меню '''Файл''' > '''Открыть и отслеживать'''.
При изменении файла во внешнем редакторе текст автоматически обновляется в отладчике.
=== Сохранение в файл === Меню '''Файл''' > '''Сохранить в файл'''.
Всегда есть возможность сохранить скрипт в файл.* Меню '''Файл''' > '''Сохранить в файл''' — Сохраняет текущий текст скрипта в файл. Если файл был открыт сохранен ранее, по умолчанию предлагается исходный предыдуший путь.
== Сохранение скриптов * Меню '''Файл''' > '''Сохранить (Ctrl+S)''' — Когда отладчик открыт без привязки к конкретному скрипту, то сохраняет изменения в файл. '''Важно!''' Если отладчик открыли например из '''Отчеты''' > '''Дополнительные возможности''' > '''Редактировать''' то сохранения через пункт '''Сохранить (Ctrl+S)''' сохранения '''всегда''' будет происходить в базу данных ==, в файл изменения сохранены не будут.
Если настроено сохранение в базу данных, отладчик может записать изменённый скрипт обратно в БД.= Сохранение =
Если отладчик открыт как редактор скрипта, доступны функции по сохранению напрямую в базу данных:* Меню '''Файл''' > '''Сохранить(Ctrl+S)''' — сохранить скрипт в базу данных
* Кнопка '''Сохранить и закрыть''' — сохранить скрипт и закрыть окно отладчика
== Подключение отладчика к выполняемому скрипту (AttachDebugger) =работающим скриптам = Механизм AttachDebugger Данная возможность позволяет подключить отладчик к скриптускриптам изначально запущеным без него. Для начала работ, который уже выполняется отладчик нужно перевести в другом месте приложениярежим '''ожидания запросов отладки'''. Далее необходимо запустить скрипт стандартным способом. Если в скрипте будет команда AttachDebugger - отладчик это увидит и начнется процесс отладки этого скрипта. Это удобно для отладкискриптов, которые работают в своем контексте:* [[Печатные формы|Скриптов из печатных форм]]* [[Дополнительные_возможности|Скриптов из системных событий (которые происходят в интерфейсе)]] * [[Пользовательские_отчеты|Скриптов дополнительных возможностей]]* [[Дополнительные услуги|Скриптов из дополнительных услуг]]
'''ВниманиеКак использовать'''. Если скрипт исполняется в шедулере или в другом вспомогательном потоке, то подключится к нему не получится. Отладка работает только в текущем потоке приложения.
=== Как использовать === #'''В отладчике:'''## Откройте отладчик скриптов, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)'''.## Включите режим отслеживания: меню '''СкриптФайл''' > '''Ожидать команды AttachDebugger'''.## В строке состояния отладчика появится сообщение '''Ожидание команды AttachDebugger...'''.## Свернуть отладчик, если его закрыть то наблюдение остановится.#'''В скрипте:'''## Скрипт нужно подготовить. В скрипте нужно прописать команду '''Важно.AttachDebugger''' Команда `AttachDebugger` она должна быть '''первой командой''' или идти следующей строкой после тега начала скрипта '''<?>'''## Запустить скрипт стандартным образом: Сформировать печатную форму, рассчитать стоимость доставки, выполнить действие для вызова события.#'''Что происходит:'''## При выполнении команды AttachDebugger - скрипт останавливается.## Отладчик автоматически подключается к перехваченному скрипту.## Текст скрипта загружается в скриптередактор отладчика.## Можно ставить точки останова, просматривать переменные и продолжать отладку. Добавьте её в самое начало:
Пример скрипта с запросом подключения к отладчику:
<source lang="json">
<?>
AttachDebugger;
set($a, 10);
showmessage($sum);
</source>
 
'''Что происходит:'''
# При выполнении команды `AttachDebugger` скрипт останавливается.
# Отладчик автоматически подключается к выполняющемуся скрипту.
# Текст скрипта загружается в редактор отладчика.
# Можно ставить точки останова, просматривать переменные и продолжать отладку.
'''Важно:'''
* Отладчик должен быть в режиме отслеживания до того, как скрипт дойдёт до команды AttachDebugger.* Команда `AttachDebugger`должна быть первой командой в скрипте.* Если режим отслеживания не включён, команда `AttachDebugger` в скрипте игнорируетсяи ничего не делает.
* В режиме отслеживания может работать только один отладчик.
* Команда `AttachDebugger` должна быть первой командой Если скрипт исполняется в скриптешедулере или в другом вспомогательном потоке, то подключится к нему не получится. Отладка работает только в текущем потоке приложения.
== Горячие клавиши ==
{| class="wikitable"
|-
| '''Ctrl+S''' || Сохранение изменений в базу данных, если скрипт был открыт для редактирования в отладчике
|-
| '''Ctrl+1..9''' || Перейти в закладку 1 .. 9 в редакторе кода
|-
| '''Ctrl+Shift+1..9''' || Добавить закладку 1 .. 9 в редакторе кода
|-
| '''Ctrl+Shift+U''' || Двигать выбранный блок влево
|-
| '''Ctrl+Shift+I''' || Двигать выбранный блок вправо
|}
== Настройки редактора ==
=== Перенос строк ===
Контекстное меню редактора > '''Перенос строк'''.
Настройка сохраняется и восстанавливается при следующем запуске отладчика.
=== Отображение специальных символов ===
Контекстное меню редактора > '''Показать специальные символы'''.
Удобно для поиска лишних пробелов и контроля форматирования кода.
== Примеры использования == === Пример 1: Отладка скрипта с точками останова ===
'''Задача.''' Проверить корректность простого цикла суммирования.== Пример 1: Отладка скрипта с точками останова ==
# Откройте отладчик, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)Задача.'''Проверить корректность простого цикла суммирования.# Введите скриптПример скрипта:
<source lang="json">
<?>
showmessage($sum);
</source>
 
План действий:
# Откройте отладчик, главное меню '''Отчеты''' > '''SQL''' > '''Выполнить''' > '''Запустить отладчик (F9)'''.
# Введите скрипт
# Установите точку останова на строке set($sum, $sum + $i);.
# '''Запустите скрипт (F9)'''.
* Можно быстро обнаружить ошибки в логике цикла.
=== Пример 2: Отладка скрипта с условиями ===
'''Задача.''' Проверить, корректно ли выбирается максимум из двух значений. # Откройте отладчик.# Введите скриптПример скрипта:
<source lang="json">
<?>
showmessage($result);
</source>
 
План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке if($a > $b.
# Запустите скрипт (F9).
* Удобно тестировать разные комбинации входных данных.
=== Пример 3: Отладка скрипта с работой с базой данных === '''Задача.''' Проверить правильность выборки и обработки данных из базы.
# Откройте отладчик'''Задача.# Введите скрипт''' Проверить правильность выборки и обработки данных из базы. Пример скрипта:
<source lang="json">
<?>
showmessage($code);
</source>
 
План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке if(db.RecordCount > 0.
# Запустите скрипт (F9).
* Можно проверить конкретные значения полей перед дальнейшей обработкой.
=== Пример 4: Отладка скрипта из печатной формы через AttachDebugger ===
'''Задача.''' Подключиться к скрипту печатной формы, который выполняется из основного приложениязапущенному без отладчика. # Откройте отладчик скриптов.# Включите режим отслеживания меню '''Файл''' > '''Ожидать команды AttachDebugger'''.# В скрипт печатной формы, первой строкой добавьте команду `AttachDebugger`. # Запустите печатную форму## Для примера, если нет печатной формы, откройте '''Отчеты''' > '''SQL''' укажите скрипт;## Запустите скрипт в '''SQL отчетах''' меню '''Выполнить''' > '''Выполнить как скрипт (F7)'''Пример скрипта:
<source lang="json">
<?>
);
</source>
 
План действий:
# Откройте отладчик скриптов.
# Включите режим отслеживания меню '''Файл''' > '''Ожидать команды AttachDebugger'''.
# Откройте '''Отчеты''' > '''SQL''' введите скрипт из примера.
# Запустите скрипт через меню '''Выполнить''' > '''Выполнить как скрипт (F7)'''.
# Когда выполнение дойдёт до AttachDebugger, отладчик автоматически подключится.
# Установите точку останова на строке if($count > 100.
* Скрипт становится доступен для анализа так же, как и обычный скрипт, запущенный из отладчика.
=== Пример 5: Отладка скрипта с циклом FOR ===
'''Задача.''' Проверить корректность вычислений в цикле FOR. # Откройте отладчик.# Введите скриптПример скрипта:
<source lang="json">
<?>
showmessage($sum);
</source>
 
План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке set($sum, $sum + $i);.
# Запустите скрипт (F9) и просматривайте значения $i и $sum при остановках.
* Удобно находить ошибки в граничных условиях цикла.
=== Пример 6: Использование выражений наблюдения === '''Задача.''' Одновременно контролировать несколько взаимосвязанных значений.
# Откройте отладчик'''Задача.# Введите скрипт''' Одновременно контролировать несколько взаимосвязанных значений. Пример скрипта:
<source lang="json">
<?>
showmessage($result);
</source>
 
План действий:
# Откройте отладчик.
# Введите скрипт.
# Установите точку останова на строке set($result, $a + $b + $c);.
# Запустите скрипт (F9).
* Одновременно видно несколько ключевых показателей.
* Легче находить расхождения между промежуточными и итоговыми значениями.
 
== Заключение ==
 
Отладчик скриптов — компактный и практичный инструмент для работы со скриптами встроенного языка.
Он позволяет быстро находить ошибки в логике, контролировать переменные и подключаться к выполняющимся скриптам без изменения бизнес-процессов в приложении.
Sammy
538
правок
Источник — «https://wiki.courierexe.ru/index.php/Служебная:Сравнение_версий/15631...15711»

Навигация