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

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

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

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

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

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

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

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

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

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

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

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

Предполагается, что файл .epf уже получен — от разработчика, с диска поставки 1С или из другого источника. Перед загрузкой убедитесь, что форма предназначена именно для вашей конфигурации и её версии: обработка для «Управления торговлей 11» не заработает в «Бухгалтерии 3.0», потому что имена объектов и реквизитов различаются.

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

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

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

Назначение формы конкретным документам и пользователям

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

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

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

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

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

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

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

Норма

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

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

Пункта нет — проверьте размещение и публикацию обработки

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

Норма

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

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

Ошибка «Метод объекта не обнаружен» — форма не совместима с версией конфигурации

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

Норма

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

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

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

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

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

Большинство проблем при подключении внешних печатных форм сводится к нескольким повторяющимся ситуациям. Разберём их с причинами и способами исправления.

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

Альтернативы внешней печатной форме

Внешняя форма — не единственный способ изменить печать. В зависимости от задачи могут подойти другие варианты.

Сравнение вариантов

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

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

Редактирование макета в пользовательском режиме

В ряде конфигураций макеты печатных форм доступны для правки прямо в режиме 1С:Предприятие («Администрирование» → «Печатные формы, отчеты и обработки» → «Макеты печатных форм»). Подходит для мелких правок: логотип, текст, подписи.

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

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

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

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

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

Храните файлы .epf в отдельной папке с понятными именами и указанием конфигурации и версии, например «Счет_с_логотипом_УТ11.epf». После обновления конфигурации так вы быстро поймёте, какие формы нужно перепроверить, и найдёте исходник для передачи разработчику.

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

Кнопка «Печать» есть, но новой формы в списке нет. Что делать?

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

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

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

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

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

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

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

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

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

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

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