Как отладить внешнюю печатную форму в 1С

Внешняя печатная форма в 1С — это файл с расширением .epf, который подключается к конфигурации без её изменения и формирует печатный документ по данным объекта. Когда форма работает неправильно — выводит пустые поля, падает с ошибкой или формирует не тот макет — её нужно отладить. Главная сложность в том, что внешняя обработка выполняется в контексте основной конфигурации, и стандартный запуск отладки из конфигуратора её не «видит» без дополнительных настроек.

Отладка внешней печатной формы возможна тремя способами: через подключение отладчика к сеансу пользователя, через временное открытие обработки из конфигуратора и через вставку отладочных сообщений. Выбор зависит от того, есть ли у вас исходный файл .epf, работаете ли вы в файловой или клиент-серверной базе и на каком уровне возникает ошибка — в модуле формы, в модуле объекта или в запросе.

Ниже разобраны все три подхода с конкретными шагами, условиями их применения и способами проверки результата. Материал ориентирован на конфигурации с БСП (УТ 11, ERP, КА, БП 3.0), где печатные формы регистрируются через справочник «Дополнительные отчеты и обработки», но приёмы работают и для самописных механизмов печати.

Почему внешнюю печатную форму нельзя отладить «как обычно»

При обычной разработке вы открываете конфигуратор, ставите точку останова в модуле и запускаете отладку — платформа останавливается на нужной строке. С внешней обработкой это не срабатывает, потому что код, который выполняется при печати, загружается в базу как двоичные данные и хранится внутри справочника дополнительных отчетов и обработок. Конфигуратор при запуске отладки открывает предмет отладки из конфигурации, а не из файла .epf.

Кроме того, печатная форма часто выполняется в фоновом задании — например, при печати «на сервере» в клиент-серверном режиме или при групповой печати. В этом случае код исполняется в отдельном сеансе, к которому отладчик не подключён по умолчанию. Это нужно учитывать при выборе способа отладки.

Ещё одна особенность — макет и данные. Ошибка может быть не в коде, а в самом макете (удалили параметр, переименовали область) или в данных (запрос вернул пустую выборку). Поэтому отладку стоит начинать с локализации: падает ли код с исключением, выполняется ли он до конца, но с пустым результатом, или проблема в выводе макета.

Подготовка: что проверить перед отладкой

Прежде чем запускать отладчик, убедитесь, что у вас есть актуальный исходный файл обработки. Частая ситуация: разработчик правит файл .epf на диске, а в базе зарегистрирована старая версия. Откройте справочник «Дополнительные отчеты и обработки», найдите вашу печатную форму и сохраните её из базы на диск (команда «Сохранить в файл» или аналогичная в вашей конфигурации). Сравните с рабочим файлом — если они различаются, отлаживайте именно версию из базы или обновите регистрацию.

Второе условие — права. У пользователя, под которым выполняется отладка, должны быть права на открытие внешних обработок и на чтение отлаживаемых данных. В файловой базе достаточно запустить конфигуратор с тем же файлом базы. В клиент-серверном варианте нужно, чтобы на сервере 1С была разрешена отладка — она включается параметром запуска сервера (ключ -debug в командной строке службы агента).

Третий момент — режим отладки. Современные платформы по умолчанию используют отладку по HTTP. Если отладчик не подключается к сеансу, проверьте настройку в конфигураторе: Сервис → Параметры → вкладка, отвечающая за протокол отладки. При несоответствии протокола на клиенте и сервере точки останова просто не сработают, без каких-либо сообщений об ошибке.

Способ 1: отладка через подключение к пользовательскому сеансу

Это основной и самый надёжный способ. Порядок действий такой: откройте конфигуратор той же базы, в которой работает пользователь. Запустите отладку (Отладка → Начать отладку) — откроется тонкий клиент в режиме отладки. Затем в конфигураторе откройте файл внешней обработки: Файл → Открыть → выберите ваш .epf. Конфигуратор загрузит модули обработки в редактор.

Теперь поставьте точку останова в нужном месте — например, в функции Печать() или в процедуре формирования табличного документа. Важно: точку нужно ставить в модуле, открытом из файла, а конфигуратор сопоставит его с выполняемым кодом по имени файла. Вернитесь в пользовательский сеанс и нажмите кнопку печати в документе — выполнение остановится на вашей точке.

Если остановки не происходит, проверьте список подключённых предметов отладки: Отладка → Подключение. В окне должны быть видны активные сеансы — отметьте нужный флажком. Для фоновых заданий (серверная печать) в том же окне включите автоматическое подключение фоновых заданий: есть отдельная настройка «Фоновые задания» в параметрах подключения.

1. 1
   Включите отладку на сервере (для клиент-серверного режима) или просто откройте конфигуратор файловой базы
2. 2
   Запустите отладку: Отладка → Начать отладку
3. 3
   Откройте файл .epf через Файл → Открыть
4. 4
   Установите точку останова в модуле объекта или формы
5. 5
   В пользовательском режиме откройте документ и нажмите кнопку печати
6. 6
   При остановке пошагово пройдите код (F11 — шаг с заходом, F10 — шаг через), просматривая значения переменных
7. 7
   Проверьте итоговый табличный документ в пользовательском режиме

Способ 2: запуск обработки напрямую из конфигуратора

Если печатная форма формируется по ссылке на документ и не требует сложного контекста, её можно запустить напрямую: в конфигураторе откройте файл .epf и нажмите «Начать отладку» — обработка откроется в режиме предприятия как самостоятельный объект. Точки останова в этом случае работают без дополнительных настроек, потому что предмет отладки совпадает с запущенным объектом.

Ограничение способа: многие печатные формы ожидают, что их вызовут из документа с передачей параметров (массив ссылок, идентификатор макета). При самостоятельном запуске этих параметров нет, и код может завершиться сразу или упасть на проверке входных данных. В этом случае временно добавьте в модуль формы обработчик ПриОткрытии, который программно вызывает функцию печати с тестовой ссылкой на документ, либо создайте на форме кнопку «Тест» с тем же вызовом.

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

Способ 3: отладка без отладчика — сообщения и журнал

Иногда подключить отладчик нельзя: нет доступа к конфигуратору на сервере заказчика, отладка запрещена политиками или проблема воспроизводится только у конкретного пользователя. Тогда используйте отладочные сообщения. Вставьте в ключевых точках кода вызовы Сообщить() с выводом значений переменных: количество строк в выборке, значения параметров запроса, признаки выполнения веток условий.

Для серверного кода сообщения не всегда доходят до клиента — надёжнее писать в журнал регистрации через ЗаписьЖурналаРегистрации(). Записи потом просматриваются в разделе «Журнал регистрации» с отбором по событию. Это особенно полезно при отладке фоновой печати и групповых операций.

ЗаписьЖурналаРегистрации("ОтладкаПечатнойФормы", УровеньЖурналаРегистрации.Информация, , , "Выборка: " + Выборка.Количество() + " строк, документ: " + Строка(СсылкаНаДокумент));

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

Отладка запроса и макета отдельно

Большинство проблем печатных форм — это пустая или неправильная выборка данных. Запрос из модуля обработки удобно проверить в консоли запросов (внешняя обработка, широко распространённая среди разработчиков) или встроенной консоли, если она есть в конфигурации. Скопируйте текст запроса, подставьте реальные параметры (ссылку на проблемный документ) и выполните. Если результат пустой — проверяйте соединения таблиц, отборы по датам и условия по проведённости документа.

Для макета проверьте соответствие имён: каждый Параметры.ИмяПараметра в коде должен точно совпадать с именем параметра в макете, включая регистр букв в некоторых случаях обращения. Классическая ошибка — в макете параметр называется «НомерДокумента», а в коде заполняется «Номер». Платформа в этом случае не выдаёт ошибку, а просто выводит пустое значение.

Если форма построена на СКД (схема компоновки данных), отлаживайте её через настройки варианта: откройте схему в конфигураторе, на закладке «Настройки» сформируйте отчёт с тестовыми параметрами и смотрите результат. Ошибки СКД (например, недоступное поле) обычно выдают внятное сообщение, которое указывает на проблемный ресурс или вычисляемое поле.

Типичные ошибки и как их избежать

Самая частая ошибка — отладка «не того» файла. В базе лежит одна версия обработки, разработчик правит другую, и точки останова не срабатывают или останавливаются на неожиданных строках. Лечение: всегда перед отладкой выгружайте обработку из базы или обновляйте регистрацию после каждого изменения.

Вторая группа ошибок связана с директивами компиляции. Код печатной формы, вызываемый с клиента, но выполняемый на сервере, должен быть в области с директивой &НаСервере, а обращения к данным документа — через серверные функции. Если процедура формирования печати объявлена &НаКлиенте и обращается к запросу напрямую, в тонком клиенте код упадёт с ошибкой о недоступности контекста.

Третья типичная проблема — кэширование. После замены обработки в справочнике дополнительных отчетов пользователь может продолжать видеть старый вариант до перезапуска сеанса, потому что платформа кэширует внешние обработки. Если после обновления «ничего не изменилось» — сначала перезапустите сеанс, а уже потом ищите ошибку в коде.

Когда отладку лучше доверить специалисту

Самостоятельная отладка оправдана, если у вас есть доступ к конфигуратору, исходному файлу обработки и копии базы. Если же печатная форма является частью сложного механизма (например, вызывается из бизнес-процесса, формируется регламентным заданием или использует COM-соединения), локализация ошибки требует опыта работы с платформой и знания конкретной конфигурации.

Также не стоит экспериментировать в рабочей базе, если ошибка затрагивает регламентированные формы — счета-фактуры, УПД, ТОРГ-12. Неправильно сформированный документ, ушедший контрагенту или в отчётность, создаёт юридические риски. В таких случаях безопаснее воспроизвести проблему на копии базы и передать её разработчику с описанием шагов.

Частые вопросы