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

Другое · 6 мин

Программная печать документа в 1С: как настроить вывод

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

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

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

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

Порядок действий
  1. 1
    Определите, где будет выполняться код: на клиенте, сервере или в фоновом задании
  2. 2
    Выберите способ вывода: табличный документ, печатная форма или файл PDF
  3. 3
    Проверьте права доступа к документу и доступность принтера
  4. 4
    Проведите тестовую печать на копии базы перед запуском в работе

Основные способы программной печати в 1С

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

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

Печать из управляемой формы

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

Печать по расписанию и в веб-клиенте

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

Маршрут решения

Как выбрать действие

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

Клиент, сервер и права доступа

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

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

Типичные ошибки
01
Запуск массовой печати без проверки очереди и доступности принтера
02
Использование серверного кода для прямой печати на локальный принтер пользователя
03
Изменение рабочей базы без резервной копии и тестирования на копии

Выбор принтера и параметров вывода

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

Печать в файл вместо принтера

Сохранение в PDF или XPS полезно для архива, отправки по почте и проверки макета без расхода бумаги. Это безопасный способ отладки: сначала сверьте файл на экране, а затем включите реальный принтер.

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

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

Файл PDF или печатный документ создан
Норма

Файл есть, размер не нулевой, открывается без ошибок

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

Файл отсутствует или поврежден

Статус очереди печати
Норма

Задача выполнена или удалена из очереди

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

Задача висит с ошибкой или принтер офлайн

Права пользователя
Норма

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

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

Ошибка доступа при открытии документа или макета

Проверка результата и типичные ошибки

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

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

Ограничения и безопасная самостоятельная работа

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

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

Итог

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

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

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

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

Нужны ли специальные права для программной печати?

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

Что делать, если команда завершилась без ошибки, но бумаги нет?

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

Безопасно ли тестировать печать в рабочей базе?

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