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

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

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

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

Подготовка метаданных и создание команды

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

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

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

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

Размещение элементов управления на форме

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

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

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

Написание программного кода обработчика

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

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

Процедура КомандаПечатьНажатие(Команда)

// Получаем объект документа из формы
ОбъектПечати = Объект;

// Проверяем, записан ли объект
Если ОбъектПечати.Пустая() Тогда
Сообщить("Документ еще не записан. Печать невозможна.");
Возврат;
КонецЕсли;

// Получаем макет из метаданных
МакетПечати = ПолучитеМакет("МакетПечатнойФормы");

// Заполняем макет данными
ОбластьЗаполнения = МакетПечати.ПолучитьОбласть("Заголовок");
ОбластьЗаполнения.Параметры.Номер = ОбъектПечати.Номер;
ОбластьЗаполнения.Параметры.Дата = ОбъектПечати.Дата;
МакетПечати.Вывести(ОбластьЗаполнения);

// Вывод на печать
МакетПечати.Вывести(Новый НастройкиПечати());

КонецПроцедуры

В приведенном примере используется метод ПолучитеМакет для доступа к внешнему макету, хранящемуся в метаданных. Затем происходит работа с областями макета, куда передаются значения реквизитов документа. Финальный вызов метода Вывести открывает стандартное окно настроек печати 1С, позволяя пользователю выбрать принтер или сохранить файл.

Работа с макетами и компоновкой данных

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

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

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

Тип макета	Сложность настройки	Гибкость вывода	Рекомендуемое использование
Табличный документ	Низкая	Средняя	Простые счета, акты, письма
Компоновка данных	Высокая	Высокая	Торговые отчеты, аналитика, сложные накладные
HTML-шаблон	Средняя	Высокая	Печать для веб-клиента, email-рассылки

Особенности печати в веб-клиенте и тонком клиенте

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

В Веб-клиенте ситуация сложнее из-за ограничений безопасности браузеров. Прямой доступ к принтеру из кода 1С невозможен. Вместо этого система формирует файл (обычно PDF) и открывает его в новой вкладке браузера, откуда пользователь уже запускает стандартную процедуру печати браузера. Это необходимо учитывать при проектировании интерфейса.

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

⚠️ Внимание: Функционал прямой печати без диалога выбора принтера в веб-клиенте ограничен и требует установки специального расширения браузера или использования сервера печати 1С. Всегда тестируйте сценарий в том клиенте, где будет работать пользователь.

Как настроить сервер печати 1С?

Сервер печати 1С — это отдельное приложение, которое устанавливается на компьютер пользователя. Оно перехватывает задания печати от веб-клиента и отправляет их на локальный принтер. Для работы необходимо скачать установку с сайта ИТС и запустить мастер настройки.

Отладка и обработка возможных ошибок

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

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

Процедура КомандаПечатьНажатие(Команда)

Попытка

// Логика печати
Макет.Вывести(Настройки);

Исключение
ОписаниеОшибки = ОписаниеОшибки();
Сообщить("Не удалось выполнить печать: " + ОписаниеОшибки.Причина);
// Запись в журнал регистрации
ЖурналРегистрации.Записать(Событие.Ошибка, , ОписаниеОшибки.Причина);

КонецПопытки;

КонецПроцедуры

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

Часто задаваемые вопросы

Как сделать так, чтобы печать запускалась автоматически без диалогового окна?

Для автоматической печати без вывода окна настроек необходимо в методе Вывести передать объект НастройкиПечати, в котором явно указан имя принтера. Например: Настройки = Новый НастройкиПечати("ИмяПринтера"); Макет.Вывести(Настройки);. Однако в веб-клиенте это работает только при наличии установленного сервера печати 1С.

Почему кнопка печати неактивна (серая) в списке документов?

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

Можно ли печатать сразу несколько выбранных документов одной кнопкой?

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

Как изменить ориентацию страницы (альбомная/книжная) в макете?

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

Где хранить макеты печатных форм: в метаданных или в базе данных?

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