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

Другое · 5 мин

Внешняя печатная форма документа в 1С: создание и подключение

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

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

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

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

Когда внешняя форма подходит, а когда лучше типовой

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

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

Порядок действий
  1. 1
    Создайте внешнюю обработку с модулем и макетом
  2. 2
    Зарегистрируйте обработку в разделе дополнительных отчётов и обработок
  3. 3
    Добавьте команду печати на форму документа
  4. 4
    Напишите процедуру формирования печатной формы
  5. 5
    Проверьте результат на копии информационной базы

Подготовка и регистрация внешней обработки

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

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

Создание макета и процедуры печати

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

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

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

Подключение команды к форме документа

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

Управляемые формы

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

Обычные формы

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

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

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

Команда печати доступна в форме документа
Норма

Кнопка видна и открывает обработку

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

Команда отсутствует или вызывает ошибку

Печатная форма открывается
Норма

Макет заполняется данными документа

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

Пустой макет или ошибка в модуле

Права пользователей
Норма

Печать работает для нужных ролей

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

Доступ запрещён или обработка не зарегистрирована

Ограничения и риски

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

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

Итог

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

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

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

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

Может ли внешняя форма изменить данные документа?

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

Что делать, если команда печати не появилась?

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

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

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

Какие ограничения у внешних печатных форм?

Они могут не интегрироваться с типовыми механизмами отправки, сохранения и согласования, а также могут требовать доработки при изменении структуры документа или платформы.