Глобальный контекст.ИнформацияОбОшибке

Методы · ErrorInfo

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

Синтаксис

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

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

Попытка
    ...
Исключение
    Инфо = ИнформацияОбОшибке();
    Сообщить("Описание='" + Инфо.Описание + "'");
    Сообщить("ИмяМодуля='" + Инфо.ИмяМодуля + "'");
    Сообщить("НомерСтроки=" + Инфо.НомерСтроки);
    Сообщить("ИсходнаяСтрока='" + Инфо.ИсходнаяСтрока + "'");
КонецПопытки;
Полное описание, параметры и ограничения

Глобальный контекст.ИнформацияОбОшибке (Global context.ErrorInfo)

Глобальный контекст (Global context)

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

Доступен, начиная с версии 8.1.

Синтаксис:
ИнформацияОбОшибке()
Возвращаемое значение:
Тип: ИнформацияОбОшибке.

Описание:

Получает структурированную информацию об исключении.

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

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Внимание: Данный метод не поддерживается при работе через COM-соединение
Пример:

Попытка
...
Исключение
Инфо = ИнформацияОбОшибке();
Сообщить("Описание='" + Инфо.Описание + "'");
Сообщить("ИмяМодуля='" + Инфо.ИмяМодуля + "'");
Сообщить("НомерСтроки=" + Инфо.НомерСтроки);
Сообщить("ИсходнаяСтрока='" + Инфо.ИсходнаяСтрока + "'");
КонецПопытки;

Использование в версии:

Доступен, начиная с версии 8.1.

Методическая информация

Практические примеры

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

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

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

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

Подготовка

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обработать учебный пакет и сохранить все отказы отдельно

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

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

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

Подготовка

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

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

  3. Данный учебный контракт запрещает дроби, знак, пробелы и ведущие нули. Это не универсальное правило количеств в конфигурациях 1С.

  4. Никакой записи в базе нет: успешные строки и отказы собираются в двух массивах.


Функция УчебноеКоличествоИзСтроки(Текст) Экспорт
    Если ТипЗнч(Текст) <> Тип("Строка") Тогда
        ВызватьИсключение "Количество должно быть строкой";
    КонецЕсли;
    Если СтрДлина(Текст) > 6 Или Не СтрПодобнаПоРегулярномуВыражению(Текст, "^(0|[1-9][0-9]{0,5})$") Тогда
        ВызватьИсключение "Ожидается целое количество от 0 до 999999 без знака и ведущих нулей";
    КонецЕсли;
    Возврат Число(Текст);
КонецФункции

Процедура ВыполнитьПример() Экспорт
    Входящие = Новый Массив;
    Входящие.Добавить("0");
    Входящие.Добавить("3");
    Входящие.Добавить("-1");
    Входящие.Добавить("1.5");
    Входящие.Добавить("abc");
    Входящие.Добавить("1234567");
    Принятые = Новый Массив;
    Отказы = Новый Массив;
    Номер = 0;
    Для Каждого Текст Из Входящие Цикл
        Номер = Номер + 1;
        Попытка
            Количество = УчебноеКоличествоИзСтроки(Текст);
            Принятые.Добавить(Новый Структура("Номер,Количество", Номер, Количество));
        Исключение
            Ошибка = ИнформацияОбОшибке();
            Отказы.Добавить(Новый Структура("Номер,Описание", Номер, КраткоеПредставлениеОшибки(Ошибка)));
        КонецПопытки;
    КонецЦикла;
    Для Каждого Запись Из Принятые Цикл
        Сообщить(СтрШаблон("Принято: строка %1, количество %2", Запись.Номер, Запись.Количество));
    КонецЦикла;
    Для Каждого Отказ Из Отказы Цикл
        Сообщить(СтрШаблон("Отклонено: строка %1, %2", Отказ.Номер, Отказ.Описание));
    КонецЦикла;
    Сообщить(СтрШаблон("Принято %1; отказов %2", Принятые.Количество(), Отказы.Количество()));
    Если Принятые.Количество() <> 2 Или Отказы.Количество() <> 4 Тогда
        ВызватьИсключение "Учебный пакет дал неожиданные итоги";
    КонецЕсли;
КонецПроцедуры

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

  1. Функция проверяет вход и только затем преобразует допустимую строку в число.

  2. Внутри цикла отдельная Попытка относится к одной записи, поэтому остальные входы продолжают проверяться.

  3. Принятые записи сохраняют исходный номер строки и количество; отказы — номер и причину.

  4. Итоговый контроль доказывает полноту обработки шести входов, а не только отсутствие необработанного исключения.

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

  1. Приняты строки 1 и 2 с количествами 0 и 3; отклонены строки 3, 4, 5 и 6.

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

  3. Замените abc на 5: измените контрольные итоги на 3 и 3; новый вход должен стать успешным.

  4. Строка 03 отклоняется по согласованному правилу ведущих нулей, тогда как 0 допустима.

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

Каждый вход получил отдельный результат, и все отказы сохранены без остановки учебного пакета.

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

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

  2. При реальной записи в базу отдельно проектируйте транзакции, повторные попытки и защиту от дублей.

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

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

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

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

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

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