Документы и Печать · 9 мин
Внешняя печатная форма 1С: назначение, создание и подключение
Что такое внешняя печатная форма в 1С, чем она отличается от встроенной, как создать, подключить и проверить её работу без доработки конфигурации.
Внешняя печатная форма в 1С — это файл с расширением .epf, который содержит макет и программный код для формирования печатного документа, но хранится отдельно от конфигурации. Она подключается к программе через механизм дополнительных отчетов и обработок и позволяет печатать документы по собственному шаблону, не изменяя типовую конфигурацию.
Такой подход решает практическую задачу: организации нужен счет на оплату с логотипом, акт с дополнительными графами или доверенность по внутреннему шаблону, а типовая форма этого не предусматривает. Доработка конфигурации сняла бы её с полной поддержки и усложнила обновления — внешняя печатная форма обходит эту проблему.
Механизм доступен в конфигурациях на базе Библиотеки стандартных подсистем (БСП): «1С:Бухгалтерия», «1С:Управление торговлей», «1С:ERP», «1С:Зарплата и управление персоналом» и других. Если в программе есть раздел «Дополнительные отчеты и обработки», значит, подключение внешних печатных форм поддерживается.
Чем внешняя форма отличается от встроенной
Встроенная печатная форма хранится внутри конфигурации: её макет и код разработчик размещает в модуле менеджера объекта или общем модуле. Чтобы изменить такую форму, нужно снять конфигурацию с поддержки или доработать её через расширение — оба пути требуют квалификации и осложняют обновление.
Внешняя форма живёт отдельным файлом. Программа при подключении регистрирует её в информационной базе и добавляет команду печати в меню «Печать» нужных документов. При обновлении конфигурации внешняя форма не затрагивается и продолжает работать, если разработчики не переименовали реквизиты, к которым она обращается.
Сравнение подходов
Подходит для одной или нескольких форм без изменения конфигурации; ограничение — работает только в конфигурациях с БСП
Подходит при комплексной доработке печати и логики документов; требует навыков разработки и контроля совместимости
Крайний вариант при глубоких изменениях; снимает объекты с поддержки и усложняет обновления
Как устроен файл внешней печатной формы
Файл .epf — это внешняя обработка особого вида. Внутри неё обязательно присутствуют: макет (обычно табличный документ с областями и параметрами), модуль объекта с экспортной функцией Печать() и процедурой СведенияОВнешнейОбработке(), которая сообщает программе тип обработки, назначение и команды.
Функция СведенияОВнешнейОбработке() возвращает структуру с описанием: вид «ПечатнаяФорма», массив объектов назначения (например, «Документ.СчетНаОплатуПокупателю»), таблицу команд с идентификатором и представлением кнопки. Без корректного заполнения этой структуры программа откажется регистрировать обработку.
Макет строится из именованных областей: шапка, строка табличной части, подвал. Код функции Печать() получает массив ссылок на документы, выполняет запрос к данным, заполняет параметры областей и выводит их в итоговый табличный документ, который возвращается пользователю.
Как подключить внешнюю печатную форму
Подключение выполняется в пользовательском режиме и не требует конфигуратора. Предварительно убедитесь, что у вас есть права администратора или право «Добавление дополнительных отчетов и обработок», а сам механизм включен в настройках программы.
- 1Откройте «Администрирование» → «Печатные формы, отчеты и обработки» и включите флажок «Дополнительные отчеты и обработки»
- 2Перейдите по ссылке «Дополнительные отчеты и обработки» и нажмите «Добавить из файла»
- 3Выберите файл .epf; при предупреждении безопасности подтвердите доверие источнику, если файл получен из надежного места
- 4Проверьте настройку «Размещение»: в карточке обработки должны быть указаны нужные виды документов
- 5Нажмите «Записать и закрыть», откройте документ и найдите новую кнопку в меню «Печать»
После записи откройте любой документ из списка назначения и проверьте, что новая команда появилась в подменю «Печать». Если кнопки нет — чаще всего не настроено размещение обработки либо в функции СведенияОВнешнейОбработке() указан другой вид документа.
Как проверить корректность работы
Проверку выполняйте на копии базы или на тестовом документе, особенно если форма получена от стороннего разработчика. Сформируйте печатную форму для документа с разными условиями: с заполненной и пустой табличной частью, с длинными наименованиями, с несколькими документами сразу.
Как проверить результат
Кнопка видна у всех документов назначения
Кнопки нет или она появилась у лишних видов документов
Суммы, номенклатура и реквизиты совпадают с документом
Пустые поля, неверные итоги, ошибка при формировании
Формируется по одной форме на каждый документ
Печатается только первый документ из выделенных
Форма формируется без ошибок
Ошибка обращения к переименованному реквизиту
Типичные ошибки и риски
Самая частая проблема — отказ регистрации с сообщением о несоответствии версии БСП. Форма, написанная под старую версию библиотеки, может использовать устаревшую сигнатуру служебных функций. В этом случае код нужно адаптировать под текущую версию БСП вашей конфигурации.
Вторая группа ошибок — обращение к реквизитам, которых нет в вашей конфигурации или которые называются иначе. Форма, созданная для «Управления торговлей», не заработает в «Бухгалтерии» без доработки, даже если документ называется одинаково.
Когда внешняя форма не подходит
Внешняя печатная форма не может менять логику документа, добавлять реквизиты или влиять на проведение — она только выводит данные на печать. Если нужно, чтобы новое поле заполнялось в документе и попадало в форму, потребуется расширение конфигурации.
Также механизм недоступен в базовых версиях некоторых конфигураций с ограниченной функциональностью и в конфигурациях без БСП — там единственный путь изменить печать это доработка через конфигуратор. Перед заказом разработки уточните версию и редакцию вашей программы.
Откуда взять и как заказать разработку
Простые формы можно найти в готовых библиотеках обработок от сообщества 1С, но каждую нужно проверять на совместимость с вашей конфигурацией и версией БСП. Универсальной формы «для всех 1С» не существует.
При заказе разработки сформулируйте техническое задание: точное название и версия конфигурации, вид документа, образец желаемой формы (скан или файл), перечень полей и особенности (логотип, подписи, нумерация страниц). Это сократит число итераций и снизит риск получить форму, которая не соответствует ожиданиям.
Что важно запомнить
Внешняя печатная форма — файл .epf, подключаемый через «Дополнительные отчеты и обработки» без изменения конфигурации. Проверяйте размещение, тестируйте на копии базы и контролируйте работу после обновлений.
Частые вопросы
Можно ли подключить внешнюю печатную форму в базовой версии 1С:Бухгалтерии?
В базовых версиях часть механизмов ограничена. Проверьте наличие раздела «Дополнительные отчеты и обработки» в настройках: если он доступен и включается, подключение возможно. Если раздела нет, изменить печать можно только через конфигуратор, что в базовой версии также ограничено.
Пропадет ли внешняя форма после обновления конфигурации?
Сама регистрация формы не пропадает — она хранится в базе, а не в конфигурации. Но если при обновлении разработчики переименовали реквизиты или документы, к которым обращается код формы, она начнет выдавать ошибку. После каждого крупного обновления формируйте тестовую печать.
Чем открыть и отредактировать файл .epf?
Файл открывается в конфигураторе 1С через меню «Файл» → «Открыть». Там доступны макет и модуль объекта. Редактирование требует базовых навыков встроенного языка 1С; без них безопаснее ограничиться правкой надписей в макете.
Почему программа пишет «не удалось подключить обработку»?
Типичные причины: форма создана под другую версию БСП, в функции СведенияОВнешнейОбработке указан неверный вид обработки, либо файл поврежден. Также проверьте, что в настройках включен механизм дополнительных отчетов и обработок и у вас есть соответствующие права.
Можно ли использовать одну форму для нескольких видов документов?
Да, если в массиве назначения перечислены все нужные виды документов, а код печати корректно обрабатывает различия в их структуре. На практике для документов с разной табличной частью удобнее делать отдельные формы.
Безопасно ли скачивать готовые формы из интернета?
Код обработки выполняется с правами пользователя и теоретически может обращаться к любым данным базы. Скачивайте файлы только из источников, которым доверяете, и перед подключением просматривайте модуль объекта в конфигураторе на предмет подозрительных операций — отправки данных, записи в неожиданные объекты.