Что использовать в 1С вместо Сообщить: обзор альтернатив

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

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

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

Почему Сообщить считается устаревшим подходом

Главный недостаток Сообщить — отсутствие контекста. Текст просто попадает в панель сообщений, и пользователь не может по нему перейти к проблемному полю или документу. Если обработка выводит двести строк «Ошибка в строке 15», найти нужную строку в данных практически невозможно.

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

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

СообщениеПользователю — основная замена

Объект СообщениеПользователю создаётся в коде, заполняется текстом и настройками, после чего выводится методом Сообщить(). Ключевое отличие — свойства КлючДанных и Поле, которые связывают сообщение с конкретным объектом и реквизитом.

Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = "Не заполнен склад отгрузки";
Сообщение.КлючДанных = Объект.Ссылка;
Сообщение.Поле = "Склад";
Сообщение.УстановитьДанные(Объект);
Сообщение.Сообщить();

При двойном клике по такому сообщению откроется форма объекта, а курсор встанет на поле «Склад». Для табличных частей путь к данным указывается через свойство ПутьКДанным с индексом строки, например Товары[2].Количество.

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

Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = "Не заполнен склад отгрузки";
Сообщение.КлючДанных = Объект.Ссылка;
Сообщение.Поле = "Склад";
Сообщение.Сообщить();

Статус и индикатор для длительных операций

Когда нужно не сообщить об ошибке, а показать ход выполнения обработки, подходят Статус и Индикатор. Они выводят текст в строку состояния внизу окна и не засоряют панель сообщений.

Для НомерСтроки = 1 По ВсегоСтрок Цикл
Статус("Обработано " + НомерСтроки + " из " + ВсегоСтрок);
// обработка строки
КонецЦикла;

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

Не вызывайте Статус на каждой итерации при больших объёмах — обновление интерфейса замедляет обработку. Обновляйте статус раз в 50–100 итераций или по проценту выполнения.

ПоказатьОповещениеПользователя для фоновых уведомлений

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

ПоказатьОповещениеПользователя(
"Загрузка завершена",
ПолучитьНавигационнуюСсылку(ДокументСсылка),
"Загружено 1250 позиций",
БиблиотекаКартинок.Информация);

Второй параметр — навигационная ссылка: клик по оповещению откроет связанный объект. Это удобно, когда пользователь должен перейти к результату обработки. Если переход не нужен, параметр опускают.

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

Журнал регистрации и исключения

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

ЗаписьЖурналаРегистрации(
"Обмен с сайтом.Загрузка заказов",
УровеньЖурналаРегистрации.Ошибка,
, ,
ОписаниеОшибки());

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

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

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

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

1. 1
   Найдите все вызовы Сообщить через глобальный поиск по конфигурации
2. 2
   Классифицируйте каждый вызов: ошибка, прогресс, уведомление, отладка
3. 3
   Ошибки валидации переведите на СообщениеПользователю с КлючДанных и Поле
4. 4
   Прогресс замените на Статус или Индикатор, уведомления — на ПоказатьОповещениеПользователя
5. 5
   Отладочный вывод удалите или перенесите в журнал регистрации
6. 6
   Проверьте работу в тонком клиенте: сообщения должны приходить с привязкой к полям

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

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

Проверка привязки проста: дважды кликните по сообщению в панели. Должна открыться форма объекта с фокусом на указанном поле. Если открывается пустая форма или ничего не происходит — проверьте КлючДанных (должна быть ссылка, а не объект) и правильность имени поля.

Частые вопросы