Предназначен для представления структурированной информации об ошибке (исключении).
Примеры платформы
Попытка
...
Исключение
Инфо = ИнформацияОбОшибке();
Сообщить(НСтр("ru='Описание=';en='Description='") + Инфо.Описание + "'");
Сообщить(НСтр("ru='ИмяМодуля=';en='ModuleName='") + Инфо.ИмяМодуля + "'");
Сообщить(НСтр("ru='НомерСтроки=';en='LineNumber='") + Инфо.НомерСтроки + "'");
Сообщить(НСтр("ru='ИсходнаяСтрока=';en='SourceLine='") + Инфо.ИсходнаяСтрока + "'");
КонецПопытки;Полное описание, параметры и ограничения
ИнформацияОбОшибке (ErrorInfo)
ИнформацияОбОшибке (ErrorInfo)
Доступен, начиная с версии 8.1.
Свойства:
ДополнительнаяИнформация (AdditionalInformation)
ИмяМодуля (ModuleName)
ИсходнаяСтрока (SourceLine)
Код (Code)
НомерСтроки (LineNumber)
Описание (Description)
Причина (Cause)
Методы:
ЯвляетсяОшибкойКатегории (IsErrorOfCategory)
Описание:
Предназначен для представления структурированной информации об ошибке (исключении).
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Сериализуется.
Пример:
Попытка
...
Исключение
Инфо = ИнформацияОбОшибке();
Сообщить(НСтр("ru='Описание=';en='Description='") + Инфо.Описание + "'");
Сообщить(НСтр("ru='ИмяМодуля=';en='ModuleName='") + Инфо.ИмяМодуля + "'");
Сообщить(НСтр("ru='НомерСтроки=';en='LineNumber='") + Инфо.НомерСтроки + "'");
Сообщить(НСтр("ru='ИсходнаяСтрока=';en='SourceLine='") + Инфо.ИсходнаяСтрока + "'");
КонецПопытки;
См. также:
Глобальный контекст, метод ИнформацияОбОшибке
Глобальный контекст, метод ПоказатьИнформациюОбОшибке
ИнформацияОбОшибке, свойство Причина
Глобальный контекст, метод КраткоеПредставлениеОшибки
ФоновоеЗадание, свойство ИнформацияОбОшибке
Глобальный контекст, метод ПодробноеПредставлениеОшибки
Использование в версии:
Доступен, начиная с версии 8.1.
Описание изменено в версии 8.3.21.
Методическая информация
Практические примеры
Найти причину ошибки собственного фонового расчёта
Передаём -1 вместо количества и намеренно получаем собственную ошибку в фоне. Исключение внутри рабочего метода отличаем от исключения запуска.
Где и как запускать
Полный серверный неглобальный общий модуль УчебныеФоновыеЗадачи отдельной собственной учебной конфигурации.
Подготовка
Создайте отдельную собственную учебную конфигурацию с именем УчебнаяКонфигурацияСинтаксиса. Не используйте рабочую базу или копию с включёнными заданиями обмена, рассылки и обработчиками бизнес-данных.
Создайте неглобальный общий модуль УчебныеФоновыеЗадачи: Сервер = Истина, Глобальный = Ложь, Привилегированный = Ложь. Вставьте полный модуль одного урока; имя модуля используется в строке запуска.
ВыполнитьПример() вызывайте из серверного обработчика своей учебной команды обычного сеанса 1С. Не запускайте из COM/внешнего соединения с файловой базой или из другого фонового задания файловой базы.
Нужны права запуска собственных фоновых заданий. Не включайте привилегированный режим для обхода отказа. Передаются только сериализуемые числа и строка режима.
Задание считает собственные числа в памяти и публикует СообщениеПользователю. Документы, регистры, файлы, интернет и настройки пользователей не меняются. История собственных заданий остаётся в базе по правилам платформы.
Выполнить возвращает объект задания, а не результат вычисления. Трёхсекундный таймаут ограничивает одно ожидание; он не отменяет задание и не доказывает успешное завершение.
Процедура Рассчитать(Количество, Цена, Режим) Экспорт
Если Количество < 0 Или Количество > 1000000 Или Количество <> Цел(Количество) Тогда
ВызватьИсключение "guide-owned: количество должно быть целым от 0 до 1000000";
КонецЕсли;
Если Цена < 0 Тогда
ВызватьИсключение "guide-owned: цена не может быть отрицательной";
КонецЕсли;
Если Режим = "Книга" Тогда
Сумма = Количество * Цена;
ИначеЕсли Режим = "Пакет" Тогда
Сумма = 0;
Для Номер = 1 По Количество Цикл
Сумма = Сумма + Цена;
КонецЦикла;
Иначе
ВызватьИсключение "guide-owned: неизвестный режим";
КонецЕсли;
Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = "guide-owned: сумма " + Формат(Сумма, "ЧГ=0");
Сообщение.Сообщить();
КонецПроцедуры
Процедура ВыполнитьПример() Экспорт
Параметры = Новый Массив;
Параметры.Добавить(-1);
Параметры.Добавить(250);
Параметры.Добавить("Книга");
Ключ = "guide-owned-" + Строка(Новый УникальныйИдентификатор);
Задание = ФоновыеЗадания.Выполнить("УчебныеФоновыеЗадачи.Рассчитать", Параметры, Ключ, "guide-owned: расчёт книги");
Сообщить("Собственный идентификатор: " + Строка(Задание.УникальныйИдентификатор));
Задание = Задание.ОжидатьЗавершенияВыполнения(3);
Если Задание.Состояние = СостояниеФоновогоЗадания.Активно Тогда
Сообщить("Таймаут: собственное задание ещё активно, успех не подтверждён");
Возврат;
КонецЕсли;
Если Задание.Состояние <> СостояниеФоновогоЗадания.ЗавершеноАварийно Тогда
Сообщить("Ожидалось аварийное завершение, фактически: " + Строка(Задание.Состояние));
Возврат;
КонецЕсли;
Ошибка = Задание.ИнформацияОбОшибке;
Если Ошибка = Неопределено Тогда
ВызватьИсключение "Аварийное состояние без доступной информации об ошибке";
КонецЕсли;
Сообщить(СтрНайти(Ошибка.Описание, "guide-owned: количество") > 0);
Сообщить("Модуль: " + Ошибка.ИмяМодуля);
Сообщить("Строка: " + Строка(Ошибка.НомерСтроки));
Сообщить("Описание: " + Ошибка.Описание);
КонецПроцедурыРазбор по шагам
Запустить ту же экспортную процедуру с отрицательным количеством: проверка входных данных находится внутри фонового метода.
Обновить объект ограниченным ожиданием. Если пока Активно, не читать отсутствующую ошибку как успешный результат.
Только при ЗавершеноАварийно получить ИнформацияОбОшибке, проверить собственный текст и вывести модуль, номер строки и описание.
Исправить -1 на 3 и повторить запуск с новым ключом. Это новая задача, а не изменение уже завершённой.
Как проверить результат
При аварийном завершении поиск собственного текста ошибки даёт Истина.
При количестве 3 задача должна завершиться успешно. Текст об отрицательном количестве исчезает; при таймауте окончательный результат пока неизвестен.
Ожидаемый результат
Полный воспроизводимый пример диагностики собственной валидации в фоне, без проведения документов.
На что обратить внимание
Выполнить может сам выбросить исключение до запуска, например из-за прав или несериализуемого параметра: тогда объекта задания нет.
ОжидатьЗавершенияВыполнения возвращает состояние, а не автоматически выбрасывает исключение из завершившегося рабочего метода.
Не перезапускайте финансовую или обменную операцию автоматически только потому, что истёк таймаут. Этот урок считает только собственные числа.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Показать информацию о намеренно вызванной учебной ошибке преобразования
Получаем ИнформацияОбОшибке внутри Исключение. Используем собственную вымышленную строку, не реальные пароли, токены или ответы сервиса.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
Используйте новую пустую учебную базу и отдельную копию EPF для каждой задачи. Команды не должны обращаться к рабочим данным, внешним сервисам или процедурам записи.
Основной пример выполняется в тонком/толстом клиенте Windows. Доступность веб-клиента оговаривается отдельно; наличие Асинх в имени не гарантирует веб-доступность.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = 3;
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Учебное количество";
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Показать собственную ошибку";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
ИсходнаяСтрока = "не число: учебный образец";
Попытка
Результат = Число(ИсходнаяСтрока);
Сообщить(Результат);
Исключение
Сведения = ИнформацияОбОшибке();
ПоказатьИнформациюОбОшибке(Сведения);
Возврат;
КонецПопытки;
КонецПроцедуры
Разбор по шагам
Ошибка специально вызывается преобразованием своей нечисловой строки.
В обработчике Исключение получаем объект ИнформацияОбОшибке, а не только текст ОписаниеОшибки.
Передаём этот объект в клиентский ПоказатьИнформациюОбОшибке.
После показа выходим; ложный нулевой результат не подставляется и расчёт не продолжается.
Как проверить результат
Команда показывает окно информации об ошибке преобразования; наружу необработанное исключение не выходит.
Замените исходную строку на "12": выводится число 12, окно ошибки не появляется.
Ожидаемый результат
Разобрана локальная отрицательная проверка и правильный тип аргумента показа ошибки.
На что обратить внимание
Не передавайте строку вместо объекта ИнформацияОбОшибке.
Реальная диагностическая информация может содержать пути/данные: не показывайте её без разбора всем пользователям и не публикуйте секреты.
Это не исправление ошибки и не доказательство пригодности данных к дальнейшей записи.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.