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

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

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

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

1. Использование журнала регистрации 1С

Самый универсальный способ отслеживать сообщения из фоновых заданий — журнал регистрации. Он фиксирует все события платформы, включая вывод в Сообщить() из фоновых процессов. Однако здесь есть нюансы: по умолчанию журнал может не сохранять сообщения с уровнем «Информация» или «Предупреждение», если они исходят из фоновых задач.

Чтобы настроить журнал правильно:

• 🔧 Перейдите в Администрирование → Журналы регистрации.
• 📝 Выберите нужный журнал (или создайте новый) и настройте фильтры:
  • Уровень событий: Информация, Предупреждение, Ошибка.
  • Источник: Фоновые задания или конкретное имя задания.
  • Период хранения: не менее 30 дней (по умолчанию может быть 7 дней).
• 💾 Сохраните настройки и перезапустите службу 1С:Предприятия (если используется серверный вариант).

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   ЖурналРегистрации.Дата,
|   ЖурналРегистрации.Уровень,
|   ЖурналРегистрации.Сообщение,
|   ЖурналРегистрации.Дополнительно
|ИЗ
|   РегистрСведений.ЖурналРегистрации КАК ЖурналРегистрации
|ГДЕ
|   ЖурналРегистрации.Источник = &Источник
|   И ЖурналРегистрации.Дата > &ДатаНачала
|УПОРЯДОЧИТЬ ПО
|   Дата УБЫВ";
Запрос.УстановитьПараметр("Источник", "ИмяВашегоФоновогоЗадания");
Запрос.УстановитьПараметр("ДатаНачала", НачалоДня(ТекущаяДата()));
Результат = Запрос.Выполнить();

⚠️ Внимание: Если фоновое задание выполняется на сервере 1С, а журнал регистрации настроен только на клиенте, сообщения могут не сохраняться. Проверьте настройки серверного журнала в Администрирование → Серверы 1С:Предприятия.

2. Передача сообщений через параметры задания

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

Пример кода для запуска задания с возвратом сообщения:

Параметры = Новый Структура;
Параметры.Вставить("ИдентификаторДокумента", 12345);
// Запускаем фоновое задание
Задание = ФоновыеЗадания.Выполнить("Обработка.ОбработкаДокументовСервер",
Параметры,
Истина,  // Ждать завершения
Ложь     // Не показывать прогресс
);

// Получаем результат
Если Задание.Статус = СтатусФоновогоЗадания.Завершено Тогда
Сообщение = Задание.Параметры.Получить("СообщениеОбОшибке");
Если Не ЗначениеЗаполнено(Сообщение) Тогда
Сообщить("Задание выполнено успешно!");
Иначе
Сообщить("Ошибка: " + Сообщение);
КонецЕсли;
КонецЕсли;

В самом фоновом задании (в модуле обработки) добавьте запись сообщения в параметры перед завершением:

Попытка
// Основной код задания
...
Исключение
Параметры.Вставить("СообщениеОбОшибке", ОписаниеОшибки());
Параметры.Вставить("СтекВызовов", ИнформацияОбИсключении().СтекВызовов);
КонецПопытки;

3. Хранение сообщений в регистре сведений

Для структурированного хранения сообщений из фоновых заданий рекомендуется создавать специальный регистр сведений. Это позволит не только сохранять логи, но и анализировать ихlater по различным критериям (дата, тип ошибки, идентификатор задания).

Создайте регистр сведений ЛогиФоновыхЗаданий со следующими измерениями и ресурсами:

• 📅 Измерения:
  • ДатаВремя (тип Дата)
  • ИмяЗадания (тип Строка)
  • ИдентификаторЗадания (тип Строка или Число)
  • Уровень (тип ПеречислениеСсылка.УровниСообщений)
• 📝 Ресурсы:
  • Сообщение (тип Строка, неограниченная длина)
  • Дополнительно (тип Строка, для стека вызовов или JSON-данных)

Пример записи в регистр из фонового задания:

Процедура ЗаписатьВЛог(Уровень, Сообщение, Дополнительно = "") Экспорт
НаборЗаписей = РегистрыСведений.ЛогиФоновыхЗаданий.СоздатьНаборЗаписей();
Запись = НаборЗаписей.Добавить();
Запись.ДатаВремя = ТекущаяДата();
Запись.ИмяЗадания = ТекущееИмяЗадания(); // Функция должна возвращать имя задания
Запись.ИдентификаторЗадания = ТекущийИдентификаторЗадания();
Запись.Уровень = Уровень;
Запись.Сообщение = Сообщение;
Запись.Дополнительно = Дополнительно;
НаборЗаписей.Записать();
КонецПроцедуры

// Пример использования в коде задания
Попытка
// Основной код
Исключение
ЗаписатьВЛог(Перечисления.УровниСообщений.Ошибка,
ОписаниеОшибки(),
ИнформацияОбИсключении().СтекВызовов);
КонецПопытки;

⚠️ Внимание: При большом количестве фоновых заданий регистр может быстро разрастаться. Настройте регламентное задание для очистки устаревших записей (например, старше 30 дней) или используйте механизм Периодичность в регистре.

4. Обмен сообщениями через HTTP-сервис

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

Алгоритм работы:

1. Создайте HTTP-сервис в 1С с методом для приёма сообщений.
2. В фоновом задании отправляйте сообщения на этот сервис через HTTPСоединение.
3. На стороне клиента опрашивайте сервис на наличие новых сообщений.

Пример кода HTTP-сервиса:

// В модуле HTTP-сервиса
Функция ПринятьСообщение(Заголовки, Тело) Экспорт
Данные = JSON.Прочитать(Тело);
ИмяЗадания = Данные.ИмяЗадания;
Сообщение = Данные.Сообщение;

// Сохраняем в регистр или отправляем дальше
ЗаписатьВЛог(Данные.Уровень, Сообщение, Данные.Дополнительно);

Возврат "OK";
КонецФункции

Отправка сообщения из фонового задания:

Процедура ОтправитьСообщениеНаСервер(Уровень, Сообщение, Дополнительно)
Адрес = "http://ваш-сервер/hs/ЛогиФоновыхЗаданий/ПринятьСообщение";
Заголовки = Новый Соответствие;
Заголовки.Вставить("Content-Type", "application/json");

Тело = JSON.Записать(Новый Структура(
"ИмяЗадания, Уровень, Сообщение, Дополнительно",
ТекущееИмяЗадания(), Уровень, Сообщение, Дополнительно
));

HTTP = Новый HTTPСоединение(Адрес);
Ответ = HTTP.Постить(Тело, Заголовки);
Если Ответ.КодСостояния <> 200 Тогда
ЗаписатьВЛог(Перечисления.УровниСообщений.Ошибка,
"Не удалось отправить сообщение на сервер: " + Ответ.Текст,
Адрес);
КонецЕсли;
КонецПроцедуры

Если Не Заголовки.СодержитКлюч("Authorization") Тогда
Возврат Новый HTTPСервисОтвет(401, "Unauthorized");
КонецЕсли;

5. Использование механизма оповещений 1С

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

Чтобы отправить оповещение:

• 📌 В фоновом задании используйте метод Оповещения.Отправить().
• 👤 Укажите получателя (пользователя или роль).
• 📝 Задайте текст сообщения и при необходимости добавьте ссылку на объект (например, документ, который обрабатывался).

Пример кода:

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

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

⚠️ Внимание: Оповещения хранятся ограниченное время (по умолчанию 7 дней). Если нужно долгосрочное хранение, дублируйте сообщения в регистр сведений или журнал регистрации.

6. Альтернативные способы: файлы и внешние СУБД

Если стандартные механизмы 1С не подходят (например, из-за ограничений лицензии или архитектуры), можно использовать внешние хранилища:

Вариант 1: Запись в текстовые файлы

Простейший способ — сохранять логи в файлы на диске. Подходит для отладки или временных решений:

Процедура ЗаписатьВФайл(Сообщение)
Путь = КаталогВременныхФайлов() + "ЛогиФоновыхЗаданий\" + Формат(ТекущаяДата(), "ДФ=yyyyMMdd") + ".log";
Если Не КаталогСуществует(Путь) Тогда
СоздатьКаталог(Путь);
КонецЕсли;

Запись = Новый ЗаписьТекста(Путь, КодировкаТекста.UTF8, Истина);
Запись.ДобавитьСтроку(Формат(ТекущаяДата(), "ДЛФ=DT") + " | " + Сообщение);
Запись.Закрыть();
КонецПроцедуры

Вариант 2: Внешняя СУБД (PostgreSQL, MS SQL)

Для крупных систем с высокой нагрузкой можно настроить запись логов во внешнюю базу данных. Пример для PostgreSQL:

Соединение = Новый СоединениеСУБД(
"PostgreSQL",
"Server=localhost;Port=5432;Database=logs_db;User Id=postgres;Password=123;"
);

Запрос = Новый ЗапросСУБД(
"INSERT INTO фоновые_задания_логи (дата, имя_задания, сообщение, уровень)
VALUES (?, ?, ?, ?)"
);
Запрос.УстановитьПараметр(1, ТекущаяДата());
Запрос.УстановитьПараметр(2, ТекущееИмяЗадания());
Запрос.УстановитьПараметр(3, Сообщение);
Запрос.УстановитьПараметр(4, Уровень);
Соединение.ВыполнитьЗапрос(Запрос);

Для работы с внешними СУБД потребуется подключить соответствующие драйверы в 1С и настроить права доступа.

Типичные ошибки и их решения

При работе с сообщениями из фоновых заданий разработчики часто сталкиваются с следующими проблемами:

• 🚫 Сообщения не попадают в журнал регистрации:
  • Проверьте настройки уровня событий в журнале (должны быть включены Информация и Предупреждение).
  • Убедитесь, что журнал настроен на сервере, если задание выполняется там.
  • Используйте ЖурналРегистрации.ЗаписатьСобытие() вместо Сообщить() для гарантированной записи.
• 🔄 Фоновое задание «зависает» без сообщений:
  • Проверьте ВремяОжидания в настройках задания (по умолчанию может быть 0, что приводит к бесконечному ожиданию).
  • Добавьте в код задания тайм-ауты для долгих операций (например, при работе с веб-сервисами).
  • Используйте Диагностика.XDTO.ЗасечьВремя() для отладки производительности.
• 📵 Не приходят оповещения:
  • Проверьте, что у пользователя-получателя включены оповещения в настройках (Показывать оповещения).
  • Убедитесь, что фоновое задание имеет права на отправку оповещений (настройка ролей).
  • Используйте Оповещения.ОчиститьКэш(), если оповещения «застревают».

FAQ: Частые вопросы по работе с фоновыми заданиями

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   ФоновыеЗадания.Идентификатор,
|   ФоновыеЗадания.Имя,
|   ФоновыеЗадания.Статус,
|   ФоновыеЗадания.ДатаНачала
|ИЗ
|   РегистрСведений.ФоновыеЗадания КАК ФоновыеЗадания
|ГДЕ
|   ФоновыеЗадания.Статус = &Статус";
Запрос.УстановитьПараметр("Статус", Перечисления.СтатусыФоновыхЗаданий.Выполняется);
Результат = Запрос.Выполнить();