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

Другое · 7 мин

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

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

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

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

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

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

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

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

Где размещать кнопку и как создавать команду

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

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

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

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

Печатная форма, макет и параметры вывода

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

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

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

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

Права доступа, видимость и условия срабатывания

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

Условия доступности лучше прописывать явно: например, кнопка активна только для объекта в состоянии «Черновик» или только после проведения. Это снижает число ошибочных нажатий и неправильных печатных форм.

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

Частые ошибки и как их избежать

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

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

Типичные ошибки
01
Кнопка создана, но не привязана к процедуре печати; нажатие не дает результата
02
Команда ссылается на удаленный макет или несуществующий объект; печать выдает ошибку

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

Как проверить, что кнопка работает

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

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

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

Открытие печатной формы после нажатия
Норма

Открывается предварительный просмотр или файл

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

Окно не открывается или появляется ошибка

Содержимое печатной формы
Норма

Данные документа подставлены корректно

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

Пустая форма или неверные реквизиты

Доступность кнопки в черновике и после проведения
Норма

Кнопка активна только в нужных состояниях

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

Кнопка активна всегда или недоступна совсем

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

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

Итог

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

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

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

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

Можно ли добавить кнопку в типовую конфигурацию без потери обновлений?

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

Почему кнопка печати может быть неактивна?

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

Что делать, если после нажатия кнопки выводится пустой документ?

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