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