Как эффективно отладить внешнюю печатную форму или обработку в 1С:Предприятие 8?

← На главную

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

Метод 1: Создание вспомогательной формы отладки

Рассмотрим наиболее надежный и популярный способ — добавление в саму внешнюю обработку временной формы для отладки. Это позволяет запускать код обработки напрямую из файла, открытого через меню «Файл — Открыть», что гарантирует работу всех точек останова.

Шаг 1. Подготовка модуля объекта. Проанализируем структуру модуля объекта нашей обработки. Для того чтобы форма могла вызвать процедуру печати, основная экспортная функция должна быть доступна извне. Убедимся, что наша основная функция (например, СформироватьПечатнуюФорму) имеет ключевое слово Экспорт.


// В модуле объекта
Функция СформироватьПечатнуюФорму(МассивОбъектов) Экспорт
    // Здесь ваш код формирования ТабличногоДокумента
    ТабДок = Новый ТабличныйДокумент;
    // ... логика заполнения ...
    Возврат ТабДок;
КонецФункции

Шаг 2. Создание формы. Добавим новую форму в обработку. На форме разместим реквизит СсылкаНаОбъект с типом документа, для которого предназначена печатная форма. Также добавим команду «Сформировать».

Шаг 3. Написание кода вызова. Разберем код, который свяжет форму и логику печати. Нам необходимо преобразовать данные формы обратно в объект обработки, чтобы получить доступ к его методам.


&НаСервере
Процедура СформироватьНаСервере()
    // Преобразуем данные текущей формы в объект внешней обработки
    ОбработкаОбъект = РеквизитФормыВЗначение("Объект");
    
    // Подготавливаем параметры (обычно это массив ссылок)
    МассивСсылок = Новый Массив;
    МассивСсылок.Добавить(Объект.СсылкаНаОбъект);
    
    // Вызываем экспортную функцию печати
    ТабличныйДокумент = ОбработкаОбъект.СформироватьПечатнуюФорму(МассивСсылок);
    
    // Если нужно вывести результат на экран сразу из отладочной формы
    // можно передать ТабДок обратно на клиент
КонецПроцедуры

&НаКлиенте
Процедура Сформировать(Команда)
    СформироватьНаСервере();
КонецПроцедуры

Метод 2: Имитация механизмов БСП

Если ваша печатная форма использует сложные механизмы Библиотеки стандартных подсистем (БСП), например, через УправлениеПечатью.ПодготовитьКоллекциюПечатныхФорм, то простая кнопка может не подойти. Выясним, как имитировать среду выполнения БСП. Для этого на форме отладки можно использовать более сложный вызов, максимально приближенный к реальному поведению системы.


&НаСервере
Функция ПечатьНаСервере(МассивОбъектов)
    // Эмулируем коллекцию печатных форм, как это делает БСП
    ИменаМакетов = Новый Массив;
    ИменаМакетов.Добавить("ВашМакет"); 
    Коллекция = УправлениеПечатью.ПодготовитьКоллекциюПечатныхФорм(ИменаМакетов);
    
    ПараметрыВывода = Новый Структура;
    ОбъектыПечати = МассивОбъектов;
    
    // Получаем объект обработки
    Об = РеквизитФормыВЗначение("Объект");
    
    // Вызываем стандартный метод Печать
    Об.Печать(МассивОбъектов, Коллекция, ОбъектыПечати, ПараметрыВывода);
    
    Если Коллекция.Количество() > 0 Тогда
        Возврат Коллекция[0].ТабличныйДокумент;
    Иначе
        Возврат Новый ТабличныйДокумент;
    КонецЕсли;
КонецФункции

Почему точки останова «не цепляются»? Проблема временных файлов

Проанализируем ситуацию, когда вы все сделали правильно, но программа не останавливается на нужной строке. Начиная с платформы 8.3.5, механизмы безопасности и работы с временными файлами стали жестче. Когда вы запускаете внешнюю форму через механизм «Дополнительные отчеты и обработки», 1С создает копию файла в папке временных файлов профиля пользователя.

Решение проблемы:

Всегда открывайте файл обработки через Файл -> Открыть для целей отладки.
Если отладка необходима именно «внутри» бизнес-процесса, используйте метод программного прерывания. Пропишите в коде Остановка = 1/0;. Система выдаст ошибку деления на ноль и предложит войти в конфигуратор именно в той точке, где произошел сбой.
Проверьте режим запуска сервера. Если код выполняется на сервере, в строке запуска службы сервера должен присутствовать флаг -debug.

Отладка фоновых заданий

В современных конфигурациях, таких как ERP, КА или БП 3.0, печать часто выполняется в фоновом режиме. Это означает, что даже если вы открыли обработку через «Файл — Открыть», серверный вызов может уйти в отдельный поток, который отладчик «не видит».

Разберем по шагам, как настроить подключение к фоновым заданиям:

В конфигураторе перейдем в меню Сервис — Параметры.
На вкладке Отладка выберем пункт Подключение.
В окне «Доступные предметы отладки» нажмем кнопку Настройка и установим флажок Автоматическое подключение фоновых заданий.
Убедимся, что протокол отладки совпадает (в современных версиях рекомендуется использовать HTTP вместо TCP для более стабильного соединения).

Альтернативный метод: Расширения конфигурации

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