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

Другое · 7 мин

Как вывести кнопку печати на форму в 1С 8.3

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

Задача вывести кнопку печати на форму в 1С 8.3 возникает, когда пользователю нужно быстро сформировать печатный документ по текущей записи, не открывая отдельные отчёты. Кнопка обычно размещается на командной панели формы и запускает подготовленный макет табличного документа.

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

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

Когда платформа показывает кнопку печати сама

В 1С 8.3 печатная форма может быть зарегистрирована для объекта конфигурации, например справочника, документа или отчёта. Если такая регистрация есть, платформа может отобразить соответствующую команду в интерфейсе формы без дополнительного программирования. Это удобный способ, но он работает только при правильно настроенной печатной форме и доступном макете.

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

Как добавить кнопку в командную панель управляемой формы

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

Создание команды формы

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

Обработчик команды и печать

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

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

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

Кнопка печати на обычной форме

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

В обычной форме нужно внимательно следить за тем, в каком контексте выполняется обработчик: доступ к реквизитам, табличным частям и текущему объекту может отличаться от управляемых форм. Если форма вызывается из списка, печать может требовать выделения строки или передачи ссылки на объект.

Проверка результата и права доступа

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

Типичные ошибки
01
Кнопка создана, но обработчик не формирует и не выводит табличный документ
02
Попытка печати объекта без зарегистрированной печатной формы и макета
03
Изменение типовых объектов без копии базы, что может помешать обновлениям

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

Частые ошибки и ограничения

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

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

Автоматическая команда печати

Подходит, если печатная форма зарегистрирована для объекта; ограничение — мало возможностей изменить место и оформление без доработки регистрации.

Ручная команда на панели формы

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

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

Сравнение способов вывода кнопки

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

Итог

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

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

Нужно ли программировать, чтобы добавить кнопку печати?

Не всегда. Если печатная форма уже зарегистрирована для объекта, команда может появиться автоматически. Если нет, придётся создать команду на панели формы и описать обработчик в модуле формы.

Что делать, если кнопка есть, но печать не работает?

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

Отличается ли порядок для управляемых и обычных форм?

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

Можно ли вывести кнопку печати без доступа к конфигуратору?

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