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

Другое · 6 мин

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

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

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

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

Ниже рассмотрены основные способы, условия их применения, ограничения и типичные ошибки при реализации.

Когда нужно выводить сообщение об ошибке

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

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

Основные способы вывода сообщения в 1С

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

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

Операция не может быть выполненаИспользуйте СообщениеОбОшибке

Проверьте, что все условия валидации описаны до вызова.

Нужно лишь уведомить пользователяИспользуйте Сообщение или Предупреждение

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

Требуется фиксация для администратораЗапись в журнал регистрации

Проверьте права на запись и настройки журнала.

Сообщение об ошибке с прерыванием выполнения

Процедура СообщениеОбОшибке("Текст ошибки") выводит окно с текстом и завершает выполнение текущей процедуры или функции. Код, расположенный после вызова, не выполняется. Это полезно для остановки проведения документа, записи или расчёта при обнаружении критического нарушения.

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

Информационное уведомление без прерывания

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

Не стоит использовать эти способы вместо ошибки, если дальнейшая обработка без исправления данных приведёт к порче документов. В таких случаях прерывание является более безопасным поведением.

Запись в журнал регистрации

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

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

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

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

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

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

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

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

Итог

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

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

Часто задаваемые вопросы

Чем отличается Сообщение от СообщенияОбОшибке?

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

Прервёт ли СообщениеОбОшибке всю обработку документа?

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

Можно ли перехватить ошибку, вызванную СообщениемОбОшибке?

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

Куда пишется журнал регистрации и кто его видит?

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

Нужно ли показывать пользователю технический текст ошибки?

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