ИнформацияОбОшибке

Типы · ErrorInfo · информация об ошибке

Предназначен для представления структурированной информации об ошибке (исключении).

Примеры платформы

Попытка
    ...
Исключение
    Инфо = ИнформацияОбОшибке();
    Сообщить(НСтр("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. Создайте отдельную собственную учебную конфигурацию с именем УчебнаяКонфигурацияСинтаксиса. Не используйте рабочую базу или копию с включёнными заданиями обмена, рассылки и обработчиками бизнес-данных.

  2. Создайте неглобальный общий модуль УчебныеФоновыеЗадачи: Сервер = Истина, Глобальный = Ложь, Привилегированный = Ложь. Вставьте полный модуль одного урока; имя модуля используется в строке запуска.

  3. ВыполнитьПример() вызывайте из серверного обработчика своей учебной команды обычного сеанса 1С. Не запускайте из COM/внешнего соединения с файловой базой или из другого фонового задания файловой базы.

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

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

  6. Выполнить возвращает объект задания, а не результат вычисления. Трёхсекундный таймаут ограничивает одно ожидание; он не отменяет задание и не доказывает успешное завершение.

Процедура Рассчитать(Количество, Цена, Режим) Экспорт
    Если Количество < 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. Запустить ту же экспортную процедуру с отрицательным количеством: проверка входных данных находится внутри фонового метода.

  2. Обновить объект ограниченным ожиданием. Если пока Активно, не читать отсутствующую ошибку как успешный результат.

  3. Только при ЗавершеноАварийно получить ИнформацияОбОшибке, проверить собственный текст и вывести модуль, номер строки и описание.

  4. Исправить -1 на 3 и повторить запуск с новым ключом. Это новая задача, а не изменение уже завершённой.

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

  1. При аварийном завершении поиск собственного текста ошибки даёт Истина.

  2. При количестве 3 задача должна завершиться успешно. Текст об отрицательном количестве исчезает; при таймауте окончательный результат пока неизвестен.

Ожидаемый результат

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

На что обратить внимание

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

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

  3. Не перезапускайте финансовую или обменную операцию автоматически только потому, что истёк таймаут. Этот урок считает только собственные числа.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Показать информацию о намеренно вызванной учебной ошибке преобразования

Получаем ИнформацияОбОшибке внутри Исключение. Используем собственную вымышленную строку, не реальные пароли, токены или ответы сервиса.

Где и как запускать

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

Подготовка

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

  2. Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.

  3. В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.

  4. Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.

  5. Используйте новую пустую учебную базу и отдельную копию EPF для каждой задачи. Команды не должны обращаться к рабочим данным, внешним сервисам или процедурам записи.

  6. Основной пример выполняется в тонком/толстом клиенте Windows. Доступность веб-клиента оговаривается отдельно; наличие Асинх в имени не гарантирует веб-доступность.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
    Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.ЗначениеПримера = 3;
    Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "ЗначениеПримера";
    Поле.Заголовок = "Учебное количество";


    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Показать собственную ошибку";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    ИсходнаяСтрока = "не число: учебный образец";
    Попытка
        Результат = Число(ИсходнаяСтрока);
        Сообщить(Результат);
    Исключение
        Сведения = ИнформацияОбОшибке();
        ПоказатьИнформациюОбОшибке(Сведения);
        Возврат;
    КонецПопытки;
КонецПроцедуры

Разбор по шагам

  1. Ошибка специально вызывается преобразованием своей нечисловой строки.

  2. В обработчике Исключение получаем объект ИнформацияОбОшибке, а не только текст ОписаниеОшибки.

  3. Передаём этот объект в клиентский ПоказатьИнформациюОбОшибке.

  4. После показа выходим; ложный нулевой результат не подставляется и расчёт не продолжается.

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

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

  2. Замените исходную строку на "12": выводится число 12, окно ошибки не появляется.

Ожидаемый результат

Разобрана локальная отрицательная проверка и правильный тип аргумента показа ошибки.

На что обратить внимание

  1. Не передавайте строку вместо объекта ИнформацияОбОшибке.

  2. Реальная диагностическая информация может содержать пути/данные: не показывайте её без разбора всем пользователям и не публикуйте секреты.

  3. Это не исправление ошибки и не доказательство пригодности данных к дальнейшей записи.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.