Содержит варианты категории ошибки.
Полное описание, параметры и ограничения
КатегорияОшибки (ErrorCategory)
КатегорияОшибки (ErrorCategory)
Доступен, начиная с версии 8.3.17.
Значения
ВсеОшибки (AllErrors)
ИсключениеВызванноеИзВстроенногоЯзыка (ExceptionRaisedFromScript)
НарушениеПравДоступа (AccessViolation)
НеподдерживаемыйФормат (UnsupportedFormat)
НеправильныйПароль (InvalidPassword)
ОтсутствиеРазрешенияДляИспользованияФункциональности (NoPermissionToUseFunctionality)
ОшибкаВнешнегоИсточникаДанных (ExternalDataSourceError)
ОшибкаВоВремяВыполненияВстроенногоЯзыка (ScriptRuntimeError)
ОшибкаДоступаКЛокальномуФайлу (LocalFileAccessError)
ОшибкаИспользованияВстроенногоЯзыка (ScriptUseError)
ОшибкаКомпиляцииВстроенногоЯзыка (ScriptCompileError)
ОшибкаКонфигурации (ConfigurationError)
ОшибкаКопииБазыДанных (DatabaseCopyError)
ОшибкаНастроекКомпоновкиДанных (DataCompositionSettingsError)
ОшибкаПереходаПоНавигационнойСсылке (GotoURLError)
ОшибкаПолнотекстовогоПоиска (FullTextSearchError)
ОшибкаПреобразованияДокумента (DocumentConversionError)
ОшибкаПроверкиПодписи (SignatureVerificationError)
ОшибкаРаботыСПринтером (PrinterError)
ОшибкаРаботыСРечью (SpeechProcessingError)
ОшибкаСеанса (SessionError)
ОшибкаСети (NetworkError)
ОшибкаСистемыВзаимодействия (CollaborationSystemError)
ОшибкаСредствМультимедиа (MultimediaToolsError)
ОшибкаТабличногоПространстваБазыДанных (DatabaseTablespaceError)
ОшибкаХранимыхДанных (StoredDataError)
ПринудительноеЗавершениеРаботы (ForcedShutdown)
ПрочаяОшибка (OtherError)
Описание:
Содержит варианты категории ошибки.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Возможен обмен с сервером. Данный объект может быть сериализован в/из XML. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту, определяется в пространстве имен http://v8.1c.ru/8.2/data/bsl/. Имя типа XDTO: ErrorCategory.
Использование в версии:
Доступен, начиная с версии 8.3.17.
Описание изменено в версии 8.3.27.
Методическая информация
Практические примеры
Получить содержательное описание намеренной ошибки
Вызываем деление на ноль и изучаем объект ошибки: описание, модуль, исходную строку, категорию и возможную причину.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Ошибки намеренно создаются на вымышленных значениях в учебной базе; файлы и рабочие данные не используются.
ИнформацияОбОшибке и ОписаниеОшибки вызываются внутри Исключение, а не вне обработчика.
Сумма = 250;
Количество = 0;
Попытка
Среднее = Сумма / Количество;
Сообщить(Среднее);
Исключение
Ошибка = ИнформацияОбОшибке();
Сообщить(ОписаниеОшибки());
Сообщить(КраткоеПредставлениеОшибки(Ошибка));
Сообщить(ПодробноеПредставлениеОшибки(Ошибка));
Сообщить("Описание: " + Ошибка.Описание);
Сообщить("Модуль: " + Ошибка.ИмяМодуля);
Сообщить(СтрШаблон("Строка %1: %2", Ошибка.НомерСтроки, Ошибка.ИсходнаяСтрока));
Сообщить("Код: " + Ошибка.Код);
Сообщить("Дополнительная информация: " + Ошибка.ДополнительнаяИнформация);
Сообщить(Ошибка.ЯвляетсяОшибкойКатегории(КатегорияОшибки.ВсеОшибки));
Если Ошибка.Причина <> Неопределено Тогда
Сообщить("Причина: " + Ошибка.Причина.Описание);
Иначе
Сообщить("Отдельная вложенная причина не задана");
КонецЕсли;
КонецПопытки;Разбор по шагам
Деление на ноль заставляет управление перейти в Исключение; Среднее не является успешным результатом.
Сразу получаем объект ИнформацияОбОшибке и его текстовые представления.
Отделяем описание для пользователя от технических сведений о модуле и строке.
Код и дополнительная информация могут быть пустыми. Причину проверяем на Неопределено перед чтением свойств.
Как проверить результат
Количество=0 приводит к сообщениям об ошибке, а не к значению средней цены 0.
НомерСтроки указывает место в вашем модуле; он не обязан совпадать с номером строки HTML-примера.
Проверка категории ВсеОшибки даёт Истина. Измените количество на 2: выводится 125, обработчик ошибки не выполняется.
Ожидаемый результат
Ошибка диагностирована на контролируемом входе; успешный результат не подменён фиктивным нулём.
На что обратить внимание
Полный текст и исходная строка могут раскрывать секреты или личные данные — в рабочем приложении разделяйте пользовательское сообщение и защищённый технический журнал.
Не сравнивайте локализованный текст ошибки для бизнес-логики. Для специально маркированных ошибок используйте согласованный код или категорию.
Здесь ошибка поглощена ради просмотра диагностики. В реальной операции её нужно вернуть как явный статус либо передать вызывающему коду.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.