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

Другое · 6 мин

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

Пошаговое руководство: добавить кнопку печати на форму собственного документа в 1C, настроить обработчик, проверить права и избежать ошибок при редактировании конфигурации.

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

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

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

Определить тип формы и способ печати

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

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

Добавить команду печать в управляемой форме

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

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

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

Если печатная форма уже есть

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

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

Если нужно создать печать вручную

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

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

1c
Процедура Печать(Команда)
    ТабДок = Новый ТабличныйДокумент;
    ЭтотОбъект.ВывестиПечать(ТабДок);
    ТабДок.Печать();
КонецПроцедуры

Обработчик нажатия и вывод печатной формы

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

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

Проверка прав, ролей и доступа

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

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

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

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

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

Типичные ошибки
01
Кнопка добавлена, но обработчик пуст, поэтому при нажатии ничего не происходит.
02
Права на печатную форму не проверены, пользователь видит кнопку, но получает отказ при выводе.

Безопасные правки, расширения и тестирование

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

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

Итог

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

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

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

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

Можно ли добавить кнопку без программирования?

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

Почему кнопка есть, а печать не запускается?

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

Безопасно ли править типовую конфигурацию напрямую?

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