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

Другое · 6 мин

Как написать сообщение в 1С: способы и примеры

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

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

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

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

Когда сообщение нужно, а когда лучше обойтись без него

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

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

Вывести текст в строку состояния

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

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

Показать уведомление с действием

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

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

Порядок действий
  1. 1
    Определите контекст вызова и способ информирования
  2. 2
    Напишите текст сообщения на языке встроенной системы
  3. 3
    Проверьте поведение на копии базы
  4. 4
    Убедитесь, что сообщение не блокирует фоновые процессы

Сообщения внутри форм и подсказки

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

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

Типичные ошибки
01
Использование интерактивного сообщения в фоновом задании, что может приостановить выполнение
02
Дублирование каждого действия сообщениями, из-за чего пользователи перестают их читать
03
Отсутствие проверки на копии базы перед изменением конфигурации

Фоновые процессы, обмен данными и ограничения

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

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

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

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

Появление сообщения при целевом событии
Норма

Сообщение отображается в ожидаемом месте

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

Сообщение отсутствует или показывается не там

Влияние на выполнение
Норма

Работа продолжается без блокировок

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

Выполнение приостанавливается неожиданно

Поведение в фоновом режиме
Норма

Интерактивное сообщение не используется

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

Фоновое задание ожидает действия пользователя

Проверка результата и безопасная работа

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

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

Итог

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

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

В чем разница между сообщением в строке состояния и уведомлением?

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

Можно ли использовать интерактивное сообщение в фоновом задании?

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

Почему сообщение может не появиться?

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

Безопасно ли изменять конфигурацию для добавления сообщений?

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