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

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

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

Ниже разобран полный цикл: от диагностики симптомов до правки макета и кода, проверки результата и типичных ошибок. Инструкция ориентирована на конфигурации с библиотекой стандартных подсистем (УТ, ERP, Бухгалтерия, ЗУП), но общие принципы применимы и к самописным решениям.

Как определить, что именно сломалось в печатной форме

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

Полезно воспроизвести ошибку в копии базы и включить технологический журнал или хотя бы внимательно скопировать полный текст ошибки. Формулировки вида «Поле объекта не обнаружено» или «Метод объекта не обнаружен» почти всегда означают, что после обновления конфигурации реквизит или метод переименовали, а форма обращается к старому имени.

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

Внешняя печатная форма хранится в виде файла .epf. Его можно найти двумя способами. Первый — через справочник дополнительных отчетов и обработок: откройте «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки», найдите нужную форму и посмотрите, откуда она была загружена. В ряде конфигураций доступна команда выгрузки обработки в файл. Второй способ — взять исходный файл из архива, где хранятся доработки, если такой архив ведется.

Открывается файл в конфигураторе: запустите конфигуратор нужной информационной базы, выберите меню «Файл → Открыть» и укажите файл .epf. Откроется редактор внешней обработки с деревом объектов: формы, макеты, модули. Изменение конфигурации при этом не требуется — вы работаете только с внешним файлом.

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

Как исправить ошибки в модуле печатной формы

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

Типичная ошибка после обновления конфигурации — обращение к реквизиту, который переименовали или удалили. Например, код содержит Документ.Организация.ИНН, а структура справочника изменилась. Найдите строку из текста ошибки, откройте в конфигураторе дерево конфигурации и проверьте актуальное имя объекта. Исправьте обращение и, при необходимости, логику получения данных.

Вторая группа ошибок — изменения в API библиотеки стандартных подсистем. Например, устаревшие вызовы общих модулей или изменение состава параметров процедуры Печать. Проверьте, как объявлена процедура в типовой форме аналогичного документа, и приведите сигнатуру к актуальному виду:

Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт
// формирование табличного документа
КонецПроцедуры

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

Обратите внимание на идентификаторы команд: они должны совпадать с теми, что используются в процедуре Печать при проверке КоллекцияПечатныхФорм. Расхождение идентификаторов — частая причина ситуации, когда форма зарегистрирована, но при печати ничего не происходит.

Как исправить макет печатной формы

Макет — это табличный документ внутри обработки, из которого формируется печатная форма. Откройте его через ветку «Макеты» в дереве обработки. Типовые проблемы макета: параметры, на которые ссылается код, отсутствуют или названы иначе; области удалены или переименованы; нарушена структура шаблона (для макетов типа «Текстовый документ» или MXL с шаблонами).

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

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

Как проверить и обновить регистрацию формы в базе

После сохранения исправленного файла форму нужно перезагрузить в базу. Откройте список дополнительных отчетов и обработок, найдите элемент, откройте его карточку и используйте команду замены файла обработки (в разных конфигурациях она называется «Заменить файл» или доступна через «Ещё»). Укажите исправленный .epf. Альтернатива — удалить старую регистрацию и загрузить форму заново, но при этом слетят настроенные назначения и быстрый доступ.

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

1. 1
   Сохраните резервную копию файла .epf
2. 2
   Воспроизведите ошибку и зафиксируйте полный текст сообщения
3. 3
   Откройте файл в конфигураторе через Файл → Открыть
4. 4
   Исправьте модуль объекта или макет по тексту ошибки
5. 5
   Сохраните файл и проверьте синтаксис модуля (Ctrl+F7 в модуле не используется для epf — проверяйте через отладку или загрузку)
6. 6
   Перезагрузите обработку в базе через карточку дополнительной обработки
7. 7
   Сформируйте печатную форму на тестовом документе и сверьте результат

Как проверить результат и что делать при повторных ошибках

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

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

Когда проще создать новую форму, а не чинить старую

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

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