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

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

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

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

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

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

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

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

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

Типовые сценарии использования: печать договора с фирменным бланком, форма ТОРГ-12 с дополнительными колонками, счёт с реквизитами для зарубежных контрагентов, этикетки и ценники нестандартного размера. Всё это реализуется без доработки конфигурации.

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

Разовое открытие через меню «Файл»

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

Порядок действий
  1. 1
    Откройте 1С в режиме Предприятие под пользователем с полными правами
  2. 2
    Выберите в главном меню Файл → Открыть (или нажмите Ctrl+O)
  3. 3
    Укажите файл с расширением .epf и подтвердите открытие
  4. 4
    Если появится предупреждение о безопасности, подтвердите открытие только для файла из доверенного источника
  5. 5
    В открывшейся форме обработки выберите документ для печати и нажмите кнопку формирования

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

Учтите: при закрытии 1С открытая таким способом форма исчезает. Для регулярного использования регистрируйте её постоянно — об этом следующий раздел.

Постоянное подключение через «Дополнительные отчеты и обработки»

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

Сначала включите сам механизм: установите флажок «Дополнительные отчеты и обработки» и при необходимости флажок разрешения открытия внешних файлов. Затем перейдите по ссылке «Дополнительные отчеты и обработки» и нажмите «Создать» или «Добавить из файла».

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

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

Открытие в конфигураторе: просмотр и отладка

Если форма не работает или её нужно адаптировать, откройте файл в конфигураторе: Файл → Открыть и выбор .epf-файла. Вы увидите структуру обработки: формы, макеты и модуль объекта с кодом.

Для отладки запустите режим предприятия из конфигуратора (клавиша F5 или «Начать отладку»), затем откройте обработку через Файл → Открыть в запущенном сеансе. Точки останова в модуле объекта сработают при формировании печатной формы.

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

bsl
Функция СведенияОВнешнейОбработке() Экспорт
	ПараметрыРегистрации = Новый Структура;
	ПараметрыРегистрации.Вставить("Вид", "ПечатнаяФорма");
	ПараметрыРегистрации.Вставить("Версия", "1.0");
	Возврат ПараметрыРегистрации;
КонецФункции

Настройка доступа и проверка результата

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

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

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

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

Новый пункт с названием формы присутствует

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

Пункта нет — проверьте принадлежность и размещение

Формирование печатной формы
Норма

Макет заполняется данными документа без ошибок

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

Ошибка выполнения или пустой макет

Доступ у обычного пользователя
Норма

Форма видна и работает под учётной записью пользователя

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

Форма видна только администратору — настройте права и размещение

Повторный вход в базу
Норма

Форма остаётся доступной после перезапуска

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

Форма пропала — она была открыта временно, а не зарегистрирована

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

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

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

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

Маршрут решения

Как выбрать действие

Форму нужно открыть один раз для проверкиИспользуйте Файл → Открыть в режиме Предприятие
Форма нужна пользователям постоянноЗарегистрируйте её в «Дополнительные отчеты и обработки» и настройте принадлежность
Форма выдаёт ошибку при формированииОткройте её в конфигураторе и проверьте соответствие версии конфигурации
Форма не появляется в меню «Печать»Проверьте таблицу принадлежности и настройки размещения в карточке обработки

FAQ

Чем внешняя печатная форма отличается от внешнего отчёта?

И тем и другим является файл .epf, но различается назначение: печатная форма формирует документ на печать по данным конкретного объекта (счёт, акт), а отчёт анализирует данные по выборке и периоду. При регистрации у них разный вид: «ПечатнаяФорма» и «Отчет».

Почему после добавления формы её не видно в меню «Печать»?

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

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

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

Форма открывается, но печатает пустой лист. В чём причина?

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

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

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

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

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

Итог

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

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