К статье
Практический материал

Документы и Печать · 11 мин

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

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

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

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

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

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

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

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

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

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

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

Форма, написанная для «Бухгалтерии 3.0», почти наверняка не заработает в «Управлении торговлей 11»: у них разные составы реквизитов документов и разные процедуры получения данных. Если вы скачали форму из открытого источника, откройте ее в конфигураторе и проверьте, к каким объектам метаданных она обращается.

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

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

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

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

Шаг 2. Загрузка файла и настройка карточки обработки

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

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

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

Шаг 3. Проверка печати в документе

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

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

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

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

Кнопка «Печать» в документе
Норма

В списке есть новая команда с заданным названием

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

Команды нет — проверьте размещение и запись карточки

Формирование формы
Норма

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

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

Ошибка выполнения — форма несовместима с версией конфигурации

Данные в макете
Норма

Реквизиты, суммы и табличная часть заполнены

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

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

Типичные ошибки и как их исправить

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

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

Типичные ошибки
01
Загрузка формы без указания размещения — команда нигде не появляется, и кажется, что подключение не сработало
02
Использование формы от другой конфигурации — ошибки при формировании или пустые поля в макете
03
Отключение безопасного режима ради «чтобы заработало» — риск выполнения вредоносного кода из файла
04
Редактирование конфигурации вместо внешней формы — потеря поддержки и сложности при обновлениях
05
Отсутствие теста на копии базы — ошибки в форме обнаруживаются уже на реальных документах

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

Если изменения минимальны — например, поправить формулировку или добавить строку в подвал, — в ряде конфигураций проще отредактировать макет через встроенный редактор печатных форм (где он предусмотрен поставщиком) или скопировать типовой макет в пользовательские. В механизме «Пользовательские макеты» БСП макет редактируется прямо в режиме предприятия без конфигуратора.

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

Сравнение способов изменить печатную форму

Внешняя печатная форма (.epf)

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

Пользовательский макет в БСП

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

Расширение конфигурации

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

Доработка конфигурации

Крайний вариант при глубоких изменениях. Ограничение: снятие с полной поддержки и усложнение обновлений

Обновление и сопровождение подключенной формы

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

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

Перед массовой выдачей формы пользователям сформируйте ее на двух-трех реальных документах разных периодов и сверьте итоговые суммы с типовой печатью. Расхождения чаще всего всплывают на документах со скидками, возвратами и частичной оплатой.
ПЗ
Практическое замечание
Итог

Что важно запомнить

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

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

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

Да, если файл .epf уже готов и реализует интерфейс БСП — вся работа выполняется в режиме «Предприятие» через «Администрирование → Дополнительные отчеты и обработки». Конфигуратор нужен только для создания или доработки самого файла.

Почему форма не появляется в меню «Печать» после загрузки?

Чаще всего не заполнена таблица размещения в карточке обработки, карточка не записана или документ был открыт до подключения. Переоткройте документ и проверьте, что в размещении указан именно его вид.

Подойдет ли форма от другой конфигурации 1С?

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

Безопасно ли загружать .epf из интернета?

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

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

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

Как убрать подключенную внешнюю печатную форму?

Откройте список «Дополнительные отчеты и обработки», найдите форму и пометьте ее на удаление либо снимите публикацию в карточке. Команда исчезнет из меню «Печать», а типовые формы останутся нетронутыми.