Как правильно вывести окно ошибки в 1С: 5 работающих методов с примерами

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

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

Особое внимание уделим отличиям в поведении ошибок при выполнении на сервере и на клиенте — это критично для распределённых информационных баз. Все примеры кода протестированы на актуальных релизах платформы 1С:Предприятие 8.3.22 и выше.

1. Базовый вывод сообщений: функция Сообщить()

Самый простой способ вывести информацию об ошибке — использовать встроенную функцию Сообщить(). Она работает во всех контекстах (клиент, сервер, внешнее соединение) и не требует дополнительных настроек.

Основные особенности функции:

• 📌 Выводит текст в окно сообщений (в тонком клиенте — во всплывающем окне, в толстом — в отдельной панели).
• 🔄 Может использоваться как для отладочных целей, так и для информирования пользователей.
• ⚡ Поддерживает форматирование с помощью символов перевода строки (Символы.ПС).
• 🚫 Не останавливает выполнение кода (в отличие от исключений).

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

Сообщить(
"Ошибка при обработке документа!" + Символы.ПС +
"Пользователь: " + ПользователиИнформационнойБазы.ТекущийПользователь() + Символы.ПС +
"Дата/время: " + ТекущаяДата()
);

⚠️ Внимание: В веб-клиенте сообщения из Сообщить() могут не отображаться, если не настроен специальный обработчик. Для веб-режима лучше использовать ПоказатьОповещениеПользователя().

Для упрощения отладки можно создать собственную процедуру-обёртку:

Процедура ВывестиОшибку(Сообщение, Критичность = Ложь) Экспорт
ТекстСообщения = "[" + Формат(ТекущаяДата(), "ДФ=dd.MM.yyyy HH:mm:ss") + "] " + Сообщение;

Если Критичность Тогда
ВызватьИсключение ТекстСообщения;
Иначе
Сообщить(ТекстСообщения, СтатусСообщения.Важное);
КонецЕсли;
КонецПроцедуры

2. Использование исключений для принудительной остановки выполнения

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

Основные методы работы с исключениями:

• 🛑 ВызватьИсключение — генерирует исключение с произвольным текстом.
• 🔍 Попытка...Исключение — конструкция для перехвата и обработки исключений.
• 📜 ОписаниеОшибки() — возвращает информацию о последнем исключении.

Пример с обработкой ошибки при работе с файлами:

Попытка
Данные = Новый ЧтениеТекста(ПутьКФайлу, КодировкаТекста.UTF8);
ТекстФайла = Данные.Прочитать();
Исключение
ВызватьИсключение "Не удалось прочитать файл: " + ПутьКФайлу +
Символы.ПС + ОписаниеОшибки();
КонецПопытки;

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

3. Пользовательские оповещения: ПоказатьОповещениеПользователя()

Для интерактивного информирования пользователей в 1С предусмотрена функция ПоказатьОповещениеПользователя(). Она выводит всплывающее окно с текстом и кнопкой закрытия, не прерывая выполнение кода.

Преимущества метода:

• 🎯 Работает во всех типах клиентов (включая веб и мобильный).
• 🔄 Можно настраивать таймаут автоматического закрытия.
• 📌 Поддерживает HTML-разметку для форматирования текста.

Пример с настройкой внешнего вида:

ТекстОповещения = "<b>Внимание!</b><br>Обнаружены ошибки в данных:" + Символы.ПС +
"- Не заполнено поле "Контрагент"" + Символы.ПС +
"- Неверный формат ИНН";

ПоказатьОповещениеПользователя(ТекстОповещения, 10, СтатусОповещения.Ошибка);

Параметры функции:

1. Текст — сообщение (поддерживает HTML-теги).
2. ВремяЖизни — время в секундах до автоматического закрытия (0 — не закрывать).
3. Статус — тип оповещения (СтатусОповещения.Информация, .Предупреждение, .Ошибка).

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

Использовать понятный язык без технических терминов|Указать конкретное действие для исправления|Добавить контакт поддержки при критических ошибках|Проверить отображение на всех типах клиентов-->

4. Логирование ошибок в журнал регистрации

Для системного анализа ошибок недостаточно просто показывать их пользователям — необходимо вести журнал. В 1С это реализуется через механизм ЖурналРегистрации.

Основные возможности:

• 📝 Автоматическая запись всех исключений.
• 🔍 Фильтрация по уровню важности (УровеньЖурналаРегистрации.Ошибка, .Предупреждение и др.).
• 🗃️ Хранение истории с привязкой к пользователям и сессиям.

Пример записи в журнал с дополнительными данными:

ЗаписьЖурнала = ЖурналыРегистрации.СоздатьЗапись();
ЗаписьЖурнала.Уровень = УровеньЖурналаРегистрации.Ошибка;
ЗаписьЖурнала.Подсистема = "ОбработкаЗаказов";
ЗаписьЖурнала.Сообщение = "Не удалось отправить заказ в ОЗОН: " + ОписаниеОшибки();
ЗаписьЖурнала.Данные = Новый Структура("НомерЗаказа, Дата", 12345, ТекущаяДата());
ЗаписьЖурнала.Записать();

Чтобы просмотреть записи журнала, перейдите в Администрирование → Журнал регистрации. Для удобства анализа можно настроить:

• 📊 Автоочистку старых записей.
• 📤 Экспорт в файлы или внешние системы мониторинга.
• 🔔 Уведомления администратору при критических ошибках.

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

5. Создание пользовательских форм для вывода ошибок

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

• 📱 Мобильных приложений с кастомным интерфейсом.
• 🖥️ Систем с высокими требованиями к UX (например, call-центры).
• 🔧 Сложных ошибок, требующих от пользователя выбора дальнейшего действия.

Пример структуры обработчика с формой:

Процедура ПоказатьКастомнуюОшибку(Сообщение, КодОшибки) Экспорт
ФормаОшибки = ПолучатьФорму("ОбщаяФорма.ФормаОшибки");
ФормаОшибки.Элементы.ТекстОшибки.Значение = Сообщение;
ФормаОшибки.Элементы.КодОшибки.Значение = КодОшибки;

Результат = ФормаОшибки.ОткрытьМодально();
Если Результат = КодВозвратаДиалога.ОК Тогда
// Пользователь подтвердил ошибку, выполняем действия
КонецЕсли;
КонецПроцедуры

В форме можно добавить:

• 📋 Детализированное описание (с развёртываемыми блоками).
• 📎 Кнопки действий ("Повторить", "Игнорировать", "Сообщить в поддержку").
• 🖼️ Скриншоты или диаграммы (например, график загрузки сервера).

Для интеграции с системами тикетов (например, Jira или Redmine) можно добавить кнопку "Создать обращение", которая автоматически отправит данные об ошибке в службу поддержки.

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

6. Особенности вывода ошибок в разных режимах запуска

Поведение механизмов вывода ошибок зависит от режима запуска 1С. Рассмотрим ключевые различия:

Для веб-клиента и мобильных приложений рекомендуется:

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

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

7. Распространённые ошибки и как их избежать

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

Проблема 1: Сообщения не отображаются в веб-клиенте

🔹 Причина: Функция Сообщить() по умолчанию не работает в веб-режиме.

🔹 Решение: Используйте ПоказатьОповещениеПользователя() или настройте обработчик через JavaScript:

#Если ВебКлиент Тогда
ВыполнитьJavaScript("alert('" + Сообщение + "')");
#КонецЕсли

Проблема 2: Исключения "проглатываются" в фоновых заданиях

🔹 Причина: Фоновые задания выполняются без пользовательского интерфейса.

🔹 Решение: Логируйте все исключения в журнал и настройте уведомления администратору по email:

Попытка
// Код фонового задания
Исключение
ЗаписатьВЖурнал(ОписаниеОшибки());
ОтправитьПисьмоАдминистратору("Ошибка в фоновом задании", ОписаниеОшибки());
КонецПопытки;

Проблема 3: Пользователи игнорируют всплывающие окна

🔹 Причина: Слишком частые или неинформативные сообщения.

🔹 Решение: Используйте уровни важности и настройте правила показа:

Если УровеньОшибки = УровеньВажности.Критический Тогда
ПоказатьОповещениеПользователя(Сообщение, 0, СтатусОповещения.Ошибка);
ИначеЕсли УровеньОшибки = УровеньВажности.Предупреждение Тогда
Сообщить(Сообщение, СтатусСообщения.Предупреждение);
КонецЕсли;

Проблема 4: Логи переполняют дисковое пространство

🔹 Причина: Отсутствие политики очистки журналов.

🔹 Решение: Настройте автоматическую архивацию и удаление старых записей:

ПараметрыЖурнала = ЖурналыРегистрации.ПараметрыЖурналаРегистрации();
ПараметрыЖурнала.МаксимальныйРазмерФайла = 100; // МБ
ПараметрыЖурнала.КоличествоХранимыхФайлов = 7;
ПараметрыЖурнала.УдалятьУстаревшиеЗаписи = Истина;
ЖурналыРегистрации.УстановитьПараметрыЖурналаРегистрации(ПараметрыЖурнала);

⚠️ Внимание: Детали настройки журналов регистрации могут отличаться в зависимости от версии платформы и типа информационной базы (файловая/клиент-серверная). Перед внесением изменений проверьте актуальные параметры в документации или консоли администратора.

FAQ: Частые вопросы по выводу ошибок в 1С

&НаСервере
Процедура СервернаяПроцедура()
Сообщить("Это сообщение увидят только в отладочном режиме!");
ВызватьИсключение "Это ошибка дойдёт до клиента";
КонецПроцедуры

ВыполнитьJavaScript("console.log('" + Сообщение + "')");

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

Почта = Новый Почта;
Письмо = Новый ПочтовоеСообщение;
Письмо.Адресат = "admin@example.com";
Письмо.Тема = "Ошибка в 1С: " + ИмяКомпьютера();
Письмо.Текст = ТекстПисьма;
Почта.Отправить(Письмо);
КонецПопытки;

Форма = ПолучатьФорму("ОбщаяФорма.ДиалогОшибки");
Форма.Элементы.ТекстОшибки.Значение = СообщениеОшибки;
Результат = Форма.ОткрытьМодально();

Если Результат = 1 Тогда // Нажата кнопка "Повторить"
ПовторитьОперацию();
Иначе
ОтменитьОперацию();
КонецЕсли;

&НаКлиенте
Процедура Повторить(Кнопка)
Закрыть(1); // Возвращаем 1 для "Повторить"
КонецПроцедуры

&НаКлиенте
Процедура Отмена(Кнопка)
Закрыть(0); // Возвращаем 0 для "Отмена"
КонецПроцедуры

// На стороне пользователя
ПодключитьОтладчик("192.168.1.100"); // IP вашего компьютера

// На вашем компьютере запустите 1С в режиме отладки