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