Загрузка EPF в справочник дополнительных обработок 1С

Внешние печатные формы в 1С 8.3 подключают не через меню Файл → Открыть, а в справочнике Дополнительные отчёты и обработки. Путь: Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки. Если пункта нет — подсистема просто выключена, её нужно включить флажком в том же разделе.

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

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

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

Что такое EPF и чем она отличается от обработки

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

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

Та же функция задаёт вид обработки. От него зависит, куда форма встроится в интерфейсе:

• 🖨 ПечатнаяФорма — добавляется в меню Печать документа;
• 📝 ЗаполнениеОбъекта — в меню Заполнить документа;
• 📊 ДополнительныйОтчёт — в список отчётов раздела;
• 🔧 ДополнительнаяОбработка — запускается как сервисное действие из рабочего места.

Для задачи «нужна своя накладная, акт или УПД» вид всегда ПечатнаяФорма.

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

По умолчанию возможность подключать внешние формы выключена — это защита от запуска чужого кода. Включается один раз:

1. Откройте Администрирование → Печатные формы, отчёты и обработки.
2. Поставьте флажок Дополнительные отчёты и обработки.
3. Там же появится ссылка на сам справочник.

Флажок доступен только пользователю с правами администратора. В типовых БП 3.0, ЗУП 3.1, УТ 11, КА и ERP раздел называется одинаково; отличается лишь набор объектов, к которым потом можно привязать форму.

Добавление файла EPF в справочник

Когда подсистема включена, откройте справочник Дополнительные отчёты и обработки и действуйте по шагам:

1. Нажмите Создать — откроется форма новой обработки.
2. В появившемся окне выбора файла укажите ваш .epf на диске.
3. 1С прочитает файл и подставит наименование и версию из его регистрационных данных.
4. Проверьте поле Вид — для печатной формы должно стоять Печатная форма.
5. Запишите элемент кнопкой Записать и закрыть.

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

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

• Используется — форма работает и видна в меню печати;
• Отключено — форма в базе осталась, но из интерфейса убрана (удобно, когда нужно временно её спрятать без удаления);
• Отладка — для разработчика во время настройки.

Если форму загрузили, а в документе её нет, первым делом проверьте, что Публикация стоит в значении Используется, а не осталась в Отладке.

Настройка размещения: к каким документам привязать

Пока форма ни к чему не привязана, она нигде не появится. Привязка настраивается в поле Размещение (в некоторых релизах — Назначение) прямо в карточке обработки.

1. В строке Размещение нажмите на ссылку с перечнем объектов.
2. Откроется список документов и справочников конфигурации.
3. Отметьте флажками те объекты, из которых форма должна печататься. Например, для формы по реализации — Реализация (акты, накладные, УПД).
4. Нажмите ОК.

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

Права доступа и видимость формы у пользователей

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

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

Быстрый доступ. В карточке обработки есть таблица Быстрый доступ к командам. Здесь указывают, каким пользователям команда доступна напрямую. Если список пуст, команда видна всем, у кого есть права; если заполнен — только перечисленным. Проверьте, что нужные сотрудники в списке либо что он пуст.

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

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

Как напечатать форму в режиме предприятия

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

• в списке команд печати рядом с типовыми формами появится ваша;
• выбираете её — 1С формирует табличный документ;
• дальше обычная печать: Ctrl+P или кнопка принтера, предпросмотр, сохранение в PDF или Excel.

Если форма поддерживает пакетную печать, её можно вызвать сразу для нескольких выделенных документов из списка: выделяете строки с Ctrl или Shift, затем Печать → ваша форма. Это зависит от кода конкретной обработки — не каждая EPF умеет работать с набором документов.

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

Альтернатива: своя печатная форма через расширение

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

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

1. В конфигураторе создаёте расширение (Конфигурация → Расширения конфигурации).
2. Заимствуете нужный документ и добавляете свою команду печати и макет.
3. Сохраняете расширение в файл .cfe.
4. В режиме предприятия загружаете его через Администрирование → Печатные формы, отчёты и обработки → Расширения (или в конфигураторе).

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

Типичные ошибки при подключении и печати

Большинство проблем сводится к нескольким сценариям. Ниже — симптом и что проверять.

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