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

← На главную

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

Использование метода «Напечатать()» для табличных документов

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

Метод Напечатать() имеет следующий синтаксис:

ТабличныйДокумент.Напечатать(<ИмяПринтера>, <КоличествоКопий>, <РазрешитьИзменениеПараметров>, <АвтоматическоеЗакрытие>, <ПараметрыПринтера>)

Давайте разберем основные параметры, которые нас интересуют для решения поставленной задачи:

ИмяПринтера (Строка): Мы можем указать конкретное имя принтера, на который будет отправлен документ. Если этот параметр оставить пустым (""), то будет использован системный принтер по умолчанию.
КоличествоКопий (Число): Здесь указываем, сколько копий документа необходимо распечатать. Обычно это 1.
РазрешитьИзменениеПараметров (Булево): Этот параметр определяет, будет ли перед печатью открываться стандартный диалог настроек печати (например, выбор страниц, ориентации). Для прямой печати без просмотра мы должны установить его в Ложь.
АвтоматическоеЗакрытие (Булево): Этот параметр является ключевым для нашей задачи. Если установить его в Истина, система не будет выводить окно предварительного просмотра или диалог печати, а сразу отправит документ на принтер.
ПараметрыПринтера (Структура): Более сложные параметры принтера, которые обычно не требуются для простой прямой печати.

Рассмотрим пример кода, как мы можем применить этот метод:


Процедура ПечатьТабличногоДокументаНапрямую()

    // 1. Создаем новый табличный документ.
    // В реальной ситуации ТабДок уже будет сформирован
    // например, в результате формирования отчета или макета.
    Перем ТабДок;
    ТабДок = Новый ТабличныйДокумент;

    // Для примера, заполним табличный документ некоторым текстом.
    // В вашем коде здесь будет логика формирования содержимого ТабДок.
    ТабДок.ВывестиТекст("Это тестовый документ, который будет напечатан напрямую.");
    ТабДок.ВывестиГоризонтальныйРазделительСтраниц();
    ТабДок.ВывестиТекст("Вторая страница тестового документа.");

    // 2. Определяем имя принтера.
    ИмяПринтера = ПараметрыРаботыСистемы.ПолучитьЗначениеПараметра("ОсновнойПринтерДляПечати");
    Если ИмяПринтера = Неопределено ИЛИ ИмяПринтера = "" Тогда
        // Используем системный принтер по умолчанию, если основной не задан.
        ИмяПринтера = ""; 
    КонецЕсли;

    // 3. Вызываем метод Напечатать() с необходимыми параметрами.
    Попытка
        ТабДок.Напечатать(ИмяПринтера, 1, Ложь, Истина);
        Сообщить("Документ успешно отправлен на печать.");
    Исключение
        Сообщить("Ошибка при отправке документа на печать: " + ОписаниеОшибки());
    КонецПопытки;

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

В этом примере мы сначала формируем ТабличныйДокумент. Затем мы определяем имя принтера. Мы можем использовать параметр системы для хранения основного принтера пользователя или просто оставить имя пустым, чтобы использовать системный принтер по умолчанию. Наконец, мы вызываем метод Напечатать(), передавая Ложь для запрета изменения параметров и Истина для автоматического закрытия, что и обеспечивает прямую печать без просмотра.

Особенности печати стандартных отчетов и использование подсистем БСП

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

Печать через структуру параметров

Метод Напечатать() объекта ТабличныйДокумент также может принимать структуру с параметрами печати. Этот подход удобен при разработке собственных расширений. Для быстрого проектирования можно использовать готовый шаблон внешних подключаемых печатных форм, который уже учитывает стандарты БСП.


Процедура ПечатьСтандартногоОтчетаЧерезПараметры()

    // 1. Создаем объект отчета.
    ОбъектОтчета = Отчеты.НачислениеЗарплаты.Создать(); 

    // 2. Формируем табличный документ отчета.
    Перем ТабДокОтчета;
    ТабДокОтчета = ОбъектОтчета.ПолучитьМакет("Основной");

    Если ТабДокОтчета = Неопределено Тогда
        ТабДокОтчета = Новый ТабличныйДокумент;
        ТабДокОтчета.ВывестиТекст("Отчет о продажах за месяц.");
    КонецЕсли;

    // 3. Создаем структуру с параметрами печати.
    ПараметрыПечати = Новый Структура;
    ПараметрыПечати.Вставить("ИмяПринтера", ""); 
    ПараметрыПечати.Вставить("КоличествоКопий", 1);
    ПараметрыПечати.Вставить("РазрешитьИзменениеПараметров", Ложь);
    ПараметрыПечати.Вставить("АвтоматическоеЗакрытие", Истина);
    
    // 4. Вызываем метод Напечатать().
    Попытка
        ТабДокОтчета.Напечатать(ПараметрыПечати);
        Сообщить("Отчет успешно отправлен на печать.");
    Исключение
        Сообщить("Ошибка при отправке отчета на печать: " + ОписаниеОшибки());
    КонецПопытки;

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

Использование функций БСП для печати

В современных конфигурациях для работы с печатью часто используются функции из модуля УправлениеПечатью. Чтобы лучше ориентироваться в доступном инструментарии, рекомендуем изучить справочник по методам БСП с примерами использования. Одной из таких функций является УправлениеПечатью.НапечататьТабличныйДокумент().

Если же ваша задача — интегрировать документ в стандартный интерфейс печати системы, можно использовать печать табличного документа через типовой механизм БСП, задействовав общую форму «ПечатьДокументов».


Процедура ПечатьЧерезБСП()

    // 1. Формируем табличный документ.
    Перем ТабДокДляПечати;
    ТабДокДляПечати = Новый ТабличныйДокумент;
    ТабДокДляПечати.ВывестиТекст("Документ, распечатанный через функции БСП.");

    // 2. Определяем параметры.
    ИмяПринтера = ""; 
    КоличествоКопий = 1;
    РазрешитьИзменениеПараметров = Ложь; 

    // 3. Вызываем функцию УправлениеПечатью.
    Попытка
        УправлениеПечатью.НапечататьТабличныйДокумент(
            ТабДокДляПечати, 
            КоличествоКопий, 
            РазрешитьИзменениеПараметров, 
            ИмяПринтера
        );
        Сообщить("Документ успешно отправлен на печать через БСП.");
    Исключение
        Сообщить("Ошибка при печати через БСП: " + ОписаниеОшибки());
    КонецПопытки;

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

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

Важные моменты и возможные нюансы

При реализации прямой печати мы должны учитывать несколько важных аспектов:

Контекст выполнения: Доступность принтеров зависит от того, где выполняется код (на клиенте или на сервере). На сервере доступны только принтеры, установленные непосредственно на сервере 1С.
Обработка ошибок: Всегда используйте блоки Попытка...Исключение, так как проблемы с очередью печати или правами доступа к принтеру возникают довольно часто.
Имя принтера: Для сетевых устройств важно указывать полный сетевой путь.
Настройка форм: Иногда пользователям требуется самостоятельно подправить оформление перед отправкой. В этом случае пригодится инструкция для пользователя по редактированию печатных форм.

Подводя итог, основной метод для программной печати табличных документов в 1С без предварительного просмотра – это ТабличныйДокумент.Напечатать() с параметрами АвтоматическоеЗакрытие = Истина и РазрешитьИзменениеПараметров = Ложь. Использование стандартов БСП делает этот процесс более унифицированным и надежным в рамках современных конфигураций.