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