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

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

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

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

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

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

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

Проверьте, подходит ли файл для подключения

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

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

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

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

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

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

Зарегистрируйте внешнюю печатную форму в программе

Откройте список «Дополнительные отчеты и обработки» и нажмите «Создать». Программа предложит выбрать файл — укажите ваш .epf. Если файл корректный, карточка заполнится автоматически: наименование, вид «Печатная форма», версия, безопасный режим. Проверьте эти поля и исправьте наименование на понятное пользователям, например «Счет на оплату (с логотипом)» вместо технического имени.

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

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

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

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

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

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

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

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

Карточка заполнилась автоматически, команды и назначение на местеПросто запишите обработку и проверьте кнопку печати в документе
Карточка пустая или ошибка при загрузкеФайл не совместим с БСП — передайте его разработчику на доработку функции СведенияОВнешнейОбработке
Форма записалась, но кнопки нет у конкретного пользователяПроверьте роли пользователя и размещение обработки в разделах
Кнопка есть, но при печати ошибкаПроверьте совместимость обработки с версией конфигурации — вероятно, изменились имена реквизитов документа

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

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

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

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

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

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

В списке есть новая форма с понятным наименованием

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

Пункт отсутствует или дублируется дважды

Сформированная форма
Норма

Все поля заполнены данными документа, суммы совпадают

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

Пустые поля, «Объект не найден», неверные итоги

Доступ у пользователей
Норма

Форма видна всем, кому назначена

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

У части пользователей пункт печати не отображается

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

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

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

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

Типичные ошибки
01
Подключение файла, написанного под другую конфигурацию — кнопка не появляется или печать падает с ошибкой.
02
Забыто назначение команд в карточке — форма зарегистрирована, но нигде не отображается.
03
Проверка только на одном документе — ошибки всплывают позже на других организациях или пустых реквизитах.
04
Не проверена работа после обновления конфигурации — форма ломается из-за переименованных реквизитов.
05
Снятие безопасного режима у файла из непроверенного источника — риск выполнения вредоносного кода в базе.

Альтернативные способы и ограничения

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

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

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

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

Подходит для новых форм и изменённой логики; не затрагивает конфигурацию, легко отключить. Ограничение: зависит от интерфейса БСП.

Редактирование типового макета

Подходит для косметических правок: текст, логотип, расположение полей. Нельзя менять алгоритм заполнения.

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

Полная свобода, но объект снимается с поддержки и усложняет обновления. Только как крайняя мера.

FAQ

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

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

Чем внешняя печатная форма отличается от внешней обработки?

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

Почему после обновления 1С внешняя форма перестала работать?

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

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

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

Одна форма нужна для нескольких видов документов — как настроить?

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

Безопасно ли подключать файл, присланный контрагентом?

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

Итог

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

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