Почему один внешний отчет в 1С формируется в фоне, а другой блокирует работу всей программы?

← На главную

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

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

1. Разница на уровне платформы: Метод СкомпоноватьРезультат()

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

Проанализируем два возможных сценария вызова этого метода:

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

СкомпоноватьРезультат(РежимКомпоновкиРезультата.Фоновый);

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

Синхронный (блокирующий) режим. Если в коде используется непосредственное формирование или метод вызывается без параметров (так как режим «Непосредственно» является поведением по умолчанию):


СкомпоноватьРезультат(РежимКомпоновкиРезультата.Непосредственно);
// или просто:
СкомпоноватьРезультат();

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

2. Использование механизмов БСП и подсистемы «Длительные операции»

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

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

Типичный код инициализации длительной операции выглядит следующим образом:


ПараметрыВыполнения = ДлительныеОперации.ПараметрыВыполненияВФоне(УникальныйИдентификатор);
ПараметрыВыполнения.НаименованиеФоновогоЗадания = "Формирование сложного отчета";

РезультатВыполнения = ДлительныеОперации.ВыполнитьВФоне(
    "МойМодульОтчета.СформироватьЭкспорт", 
    ПараметрыОтчета, 
    ПараметрыВыполнения
);

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

3. Настройки регистрации отчета в справочнике «Дополнительные отчеты и обработки»

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

Разберем структуру заполнения параметров команды. Посмотрим на пример кода регистрации:


Функция СведенияОВнешнейОбработке() Экспорт
    ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("3.0.1.1");
    ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидДополнительногоОтчета();
    
    НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
    НоваяКоманда.Представление = "Открыть отчет";
    НоваяКоманда.Идентификатор = "ОткрытьОтчет";
    
    // Способ вызова команды определяет поведение интерфейса:
    НоваяКоманда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыОткрытиеФормы();
    
    Возврат ПараметрыРегистрации;
КонецФункции

Здесь критически важна строка определения типа команды Использование:

Если указан тип команды ТипКомандыОткрытиеФормы(), то при запуске будет открыта форма отчета. Если используется стандартная форма БСП, она автоматически инициализирует фоновое формирование отчета.
Если же во втором отчете по ошибке или умышленно указан тип ТипКомандыВызовСерверногоМетода(), и при этом в модуле объекта в процедуре ВыполнитьКоманду() написан тяжелый алгоритм компоновки, то выполнение произойдет синхронно на сервере, лишая пользователя возможности работать во время формирования.

4. Наличие кастомной (собственной) формы отчета

Степень кастомизации отчета программистом также напрямую влияет на режим его выполнения:

Отчет без собственной формы. Если во внешнем отчете отсутствует созданная разработчиком форма, платформа автоматически генерирует ее на основе стандартной общей формы отчета из БСП. Эта общая форма спроектирована так, чтобы по умолчанию запускать компоновку данных асинхронно через фоновые задания. Это объясняет, почему первый отчет работает «в фоне».
Отчет с кастомной формой. Если разработчик создал уникальную форму отчета для размещения на ней специфических элементов управления, но при этом вручную переопределил стандартную команду «Сформировать» (например, написал собственный обработчик вывода данных через ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент), то этот код по умолчанию будет выполняться синхронно. Если разработчик забыл обернуть этот алгоритм в длительную операцию, отчет гарантированно заблокирует 1С.

5. Влияние режима работы информационной базы (Файловый vs Клиент-серверный)

Стоит упомянуть системный нюанс работы с фоновыми заданиями, который зависит от архитектуры развертывания базы данных:

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

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

Резюме и рекомендации по исправлению блокирующего отчета

Если один из ваших внешних отчетов блокирует работу программы, выполните следующие шаги для локализации и устранения проблемы:

Проверьте наличие собственной формы в структуре внешнего отчета. Если она есть и не содержит уникальной логики, попробуйте удалить её, позволив системе использовать стандартную форму БСП.
Проанализируйте модуль управляемой формы отчета. Найдите обработчик команды формирования отчета и убедитесь, что в метод СкомпоноватьРезультат() передается параметр РежимКомпоновкиРезультата.Фоновый.
Откройте модуль объекта отчета и изучите функцию СведенияОВнешнейОбработке(). Убедитесь, что для команд вызова используется режим открытия формы, а не прямой вызов серверного метода для длительных расчетов.