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

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

Подключение выполняется через стандартный механизм «Дополнительные отчеты и обработки», который присутствует в типовых конфигурациях на платформе 1С:Предприятие 8.3 (Управление торговлей, Бухгалтерия предприятия, ERP и другие). Пользователю достаточно загрузить файл, указать, к каким документам он относится, и проверить результат в форме печати.

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

Что такое внешняя печатная форма и когда она нужна

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

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

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

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

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

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

Включение механизма дополнительных обработок

Откройте раздел «Администрирование» и перейдите в «Печатные формы, отчеты и обработки». Установите флажок «Дополнительные отчеты и обработки» — после этого в том же разделе появится ссылка на одноимённый справочник.

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

Пошаговое подключение файла печатной формы

Основная работа выполняется в справочнике «Дополнительные отчеты и обработки». Последовательность одинакова для большинства типовых конфигураций.

1. 1
   Откройте «Администрирование» → «Печатные формы, отчеты и обработки» → «Дополнительные отчеты и обработки».
2. 2
   Нажмите «Создать» и через «Загрузить из файла» выберите файл .epf.
3. 3
   Подтвердите предупреждение безопасности, если доверяете источнику файла.
4. 4
   Проверьте автоматически заполненные наименование и вид («Печатная форма»).
5. 5
   В таблице «Принадлежность» укажите вид документа, например «Реализация товаров и услуг».
6. 6
   Нажмите «Записать и закрыть» и откройте документ для проверки кнопки «Печать».

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

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

Настройка принадлежности и размещения

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

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

Проверка результата в документе

Откройте проведённый документ того вида, к которому подключена форма, и нажмите кнопку «Печать». В выпадающем списке должна появиться новая строка с наименованием внешней формы. Выберите её — должен сформироваться табличный документ с данными документа.

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

Контрольные точки

Как проверить результат

Пункт в меню «Печать»

Норма

Новая форма видна в списке печати документа

Тревожный признак

Пункт отсутствует — проверьте принадлежность и публикацию

Формирование

Норма

Табличный документ открывается без сообщений об ошибке

Тревожный признак

Ошибка выполнения — несовместимость обработки с релизом

Данные на форме

Норма

Номер, дата, суммы и контрагент заполнены корректно

Тревожный признак

Пустые поля или неверные суммы — проблема макета

Типичные ошибки и ограничения

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

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

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

Нужен ли конфигуратор для подключения внешней печатной формы?

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

Почему форма загрузилась, но не видна в документе?

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

Можно ли подключить одну форму к нескольким видам документов?

Да, добавьте несколько строк в таблицу принадлежности. Но код обработки должен корректно работать с каждым типом документа, иначе при печати возникнет ошибка.

Что делать, если при печати возникает ошибка выполнения?

Скорее всего, обработка несовместима с текущим релизом конфигурации или рассчитана на другой вид документа. Запишите текст ошибки и передайте форму автору обработки или программисту на доработку.

Пропадёт ли внешняя форма после обновления конфигурации?

Нет, дополнительные обработки хранятся в данных базы, а не в конфигурации, поэтому обновление их не удаляет. Однако после крупного обновления стоит проверить, что форма по-прежнему корректно формирует документ.

Безопасно ли подключать файлы из интернета?

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