Получает описание ошибки (исключительной ситуации), включая информацию о строке модуля и вложенных исключениях.
Синтаксис
ОписаниеОшибки()Примеры платформы
Попытка
...
Исключение
Ошибка = ОписаниеОшибки();
ЗаписьЖурналаРегистрации("НедопустимаяОперация", УровеньЖурналаРегистрации.Ошибка,,,
Ошибка);
КонецПопыткиПолное описание, параметры и ограничения
Глобальный контекст.ОписаниеОшибки (Global context.ErrorDescription)
Глобальный контекст (Global context)
ОписаниеОшибки (ErrorDescription)
Доступен, начиная с версии 8.0.
Синтаксис:
ОписаниеОшибки()
Возвращаемое значение:
Тип: Строка.
Возвращает описание ошибки, такое же, какое было бы выдано в окне сообщений в случае отсутствия обработчика исключительной ситуации, за исключением описания модуля и строки, в которой ошибка возникла.
Описание:
Получает описание ошибки (исключительной ситуации), включая информацию о строке модуля и вложенных исключениях.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Внимание: Данный метод не поддерживается при работе через COM-соединение
Примечание:
Применять данную функцию имеет смысл только внутри операторных скобок Исключение - КонецПопытки, так как в ином случае она вернет пустую строку. Помогает в выдаче диагностики при возникновении ошибок.
Не рекомендуется использовать для отображения пользователю.
Пример:
Попытка
...
Исключение
Ошибка = ОписаниеОшибки();
ЗаписьЖурналаРегистрации("НедопустимаяОперация", УровеньЖурналаРегистрации.Ошибка,,,
Ошибка);
КонецПопытки
См. также:
МенеджерОбработкиОшибок
МенеджерОбработкиОшибок, метод КраткоеПредставлениеОшибки
МенеджерОбработкиОшибок, метод ПодробноеПредставлениеОшибки
МенеджерОбработкиОшибок, метод ПоказатьИнформациюОбОшибке
Глобальный контекст, метод ИнформацияОбОшибке
Глобальный контекст, метод КраткоеПредставлениеОшибки
Глобальный контекст, метод ПодробноеПредставлениеОшибки
Глобальный контекст, метод ПоказатьИнформациюОбОшибке
ИнформацияОбОшибке, свойство Причина
ФоновоеЗадание, свойство ИнформацияОбОшибке
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Отдельно переключить текущие итоги собственного регистра остатков
УстановитьИспользованиеТекущихИтогов возвращает Булево. Код проверяет только тип ответа, не считает его старым флагом; состояние заново читается getter.
Где и как запускать
Полный серверный модуль своей новой ПУСТОЙ УчебныеОстатки85, платформа 8.5.1.1343. Административные настройки собственного регистра; здесь не запускался.
Подготовка
Создайте НОВУЮ пустую файловую базу, имя корневой конфигурации УчебныеОстатки85. Не добавляйте эти объекты в УТ/КА2/УНФ/БП. Режим управления блокировкой данных конфигурации — Управляемый.
Документы → Добавить: УчебноеДвижение85. Номер: Строка длиной 40, автонумерация выключена. Модули объекта и менеджера оставьте пустыми; не добавляйте обработчики, подписки и обязательные пользовательские реквизиты.
Регистры накопления → Добавить: УчебныеОстатки85. Вид регистра Остатки. Единственное измерение КодТовара: Строка 50, индексировать, проверка заполнения Показывать ошибку. Единственный ресурс Количество: Число 12,3, неотрицательное. Дополнительных реквизитов нет.
В списке регистраторов выберите только собственный документ УчебноеДвижение85. Оставьте модули регистра пустыми, использование итогов включённым. Планы обмена, разделители, историю данных и фоновые задания для урока не создавайте.
Корневой режим совместимости Не использовать; платформа именно 8.5.1.1343. Единственный регистр — собственный УчебныеОстатки85 вида Остатки, единственный документ — УчебноеДвижение85. База новая пустая, не копия рабочей.
Для этого блока никакие документы и движения не создавайте. Запрос проверяет отсутствие записей своего регистра до административного вызова. Других пользователей, обменов, расширений и фоновых заданий нет.
Создайте серверный общий модуль УчебныеИтогиПримеры. Вставьте весь модуль одного урока, вызовите ВыполнитьПример() Экспорт из собственной серверной команды обработки; обновите конфигурацию БД.
Это операции настройки/обслуживания регистра, не проведение документа. Откат движений не обещает восстановить все настройки/внутренние таблицы итогов.
Урок с границами сознательно меняет диапазон в собственном одноразовом пустом стенде. Он не восстанавливает исходный диапазон и не предназначен для рабочего регистра. Перед таким ручным опытом сохраните резервную копию собственной учебной базы.
При переключении булевых флагов исходное значение читается заранее и восстанавливается при успехе/ошибке. Если восстановление само завершилось ошибкой, код сообщает об этом явно; успешное восстановление не выдумывается.
Примеры здесь не запускались в 1С. Ваши настройки, документы и итоги этим заполнением не изменялись.
У своего УчебныеОстатки85 добавьте макет УчебнаяПамяткаИтогов типа Текстовый документ: первая строка OWN-TOTALS-85, вторая Пустой учебный регистр, не рабочая база. Обновите БД.
Процедура ВыполнитьПример() Экспорт
Если Метаданные.Документы.Количество() <> 1
Или Метаданные.РегистрыНакопления.Количество() <> 1
Или Метаданные.Документы.Найти("УчебноеДвижение85") = Неопределено Тогда
ВызватьИсключение "Разрешены только собственный учебный документ и регистр";
КонецЕсли;
Описание = Метаданные.РегистрыНакопления.Найти("УчебныеОстатки85");
Если Описание = Неопределено Тогда
ВызватьИсключение "Сначала создайте собственный учебный регистр";
КонецЕсли;
Если Описание.ВидРегистра <> Метаданные.СвойстваОбъектов.ВидРегистраНакопления.Остатки
Или Описание.Измерения.Количество() <> 1
Или Описание.Ресурсы.Количество() <> 1
Или Описание.Реквизиты.Количество() <> 0
Или Описание.Измерения.Найти("КодТовара") = Неопределено
Или Описание.Ресурсы.Найти("Количество") = Неопределено Тогда
ВызватьИсключение "Нужен регистр остатков с КодТовара и Количество";
КонецЕсли;
Менеджер = РегистрыНакопления.УчебныеОстатки85;
Если Метаданные.РежимСовместимости <> Метаданные.СвойстваОбъектов.РежимСовместимости.НеИспользовать Тогда
ВызватьИсключение "Нужен собственный стенд без старого режима совместимости";
КонецЕсли;
Если ТранзакцияАктивна() Тогда
ВызватьИсключение "Не вызывайте административный опыт внутри чужой транзакции";
КонецЕсли;
Проверка = Новый Запрос;
Проверка.Текст = "ВЫБРАТЬ КОЛИЧЕСТВО(*) КАК Строк
|ИЗ РегистрНакопления.УчебныеОстатки85";
Данные = Проверка.Выполнить().Выгрузить();
Если Данные.Количество() <> 1 Тогда
ВызватьИсключение "Не получена собственная контрольная строка";
КонецЕсли;
Если Данные[0].Строк <> 0 Тогда
ВызватьИсключение "В собственном регистре уже есть движения: этот пустой административный опыт запрещён";
КонецЕсли;
ИсходныйФлаг = Менеджер.ПолучитьИспользованиеТекущихИтогов();
Если ТипЗнч(ИсходныйФлаг) <> Тип("Булево") Тогда
ВызватьИсключение "Не получен собственный исходный флаг";
КонецЕсли;
ИзменениеНачато = Ложь;
Попытка
ИзменениеНачато = Истина;
ОтветПлатформы = Менеджер.УстановитьИспользованиеТекущихИтогов(Не ИсходныйФлаг);
Сообщить(ТипЗнч(ОтветПлатформы) = Тип("Булево"));
Сообщить(Менеджер.ПолучитьИспользованиеТекущихИтогов() = Не ИсходныйФлаг);
Менеджер.УстановитьИспользованиеТекущихИтогов(ИсходныйФлаг);
Если Менеджер.ПолучитьИспользованиеТекущихИтогов() <> ИсходныйФлаг Тогда
ВызватьИсключение "Не подтверждено восстановление собственного флага";
КонецЕсли;
ИзменениеНачато = Ложь;
Сообщить(Менеджер.ПолучитьИспользованиеТекущихИтогов() = ИсходныйФлаг);
Исключение
ИсходнаяОшибка = ОписаниеОшибки();
Если ИзменениеНачато Тогда
Попытка
Менеджер.УстановитьИспользованиеТекущихИтогов(ИсходныйФлаг);
Если Менеджер.ПолучитьИспользованиеТекущихИтогов() <> ИсходныйФлаг Тогда
Сообщить("Восстановление собственного флага текущие итоги не подтверждено");
КонецЕсли;
Исключение
Сообщить("Восстановление собственного флага текущие итоги завершилось ошибкой; проверьте учебный стенд");
КонецПопытки;
КонецЕсли;
ВызватьИсключение ИсходнаяОшибка;
КонецПопытки;
КонецПроцедурыРазбор по шагам
Проверить собственный регистр вида Остатки и ноль движений.
Сохранить именно флаг текущих итогов, не флаг общего использования.
Перед вызовом отметить намерение изменения и переключить только эту настройку.
Булев ответ setter не объявлять исходным состоянием; проверить новое состояние независимым getter.
Восстановить прочитанный флаг в обоих исходах, предупреждая о неуспешном восстановлении.
Как проверить результат
Тип ответа Булево и две проверки фактического состояния Истина.
Общее использование итогов этим уроком не переключается.
После нормального завершения исходный флаг текущих итогов восстановлен.
Ожидаемый результат
Два вида использования итогов и особый возвращаемый тип не смешиваются.
На что обратить внимание
Свойства и методы относятся только к собственному пустому регистру. Нельзя менять проверку имени на рабочий регистр ради опыта.
ПолучитьИспользованиеИтогов и ПолучитьИспользованиеТекущихИтогов — разные настройки. Текущие итоги применимы только к Остатки.
Булево возвращаемое значение метода не объявляется исходным состоянием или измеренным ускорением без отдельного контракта.
Типизированные даты/флаги и явные проверки не являются доказательством запуска в 1С; здесь выполнялись только статические проверки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Изменить только разделение итогов собственного пустого регистра
Разделение связано с параллельными записями итогов, а не с разделителями данных конфигурации. Здесь один сеанс и никаких обещаний ускорения.
Где и как запускать
Полный серверный модуль своей новой ПУСТОЙ УчебныеОстатки85, платформа 8.5.1.1343. Административные настройки собственного регистра; здесь не запускался.
Подготовка
Создайте НОВУЮ пустую файловую базу, имя корневой конфигурации УчебныеОстатки85. Не добавляйте эти объекты в УТ/КА2/УНФ/БП. Режим управления блокировкой данных конфигурации — Управляемый.
Документы → Добавить: УчебноеДвижение85. Номер: Строка длиной 40, автонумерация выключена. Модули объекта и менеджера оставьте пустыми; не добавляйте обработчики, подписки и обязательные пользовательские реквизиты.
Регистры накопления → Добавить: УчебныеОстатки85. Вид регистра Остатки. Единственное измерение КодТовара: Строка 50, индексировать, проверка заполнения Показывать ошибку. Единственный ресурс Количество: Число 12,3, неотрицательное. Дополнительных реквизитов нет.
В списке регистраторов выберите только собственный документ УчебноеДвижение85. Оставьте модули регистра пустыми, использование итогов включённым. Планы обмена, разделители, историю данных и фоновые задания для урока не создавайте.
Корневой режим совместимости Не использовать; платформа именно 8.5.1.1343. Единственный регистр — собственный УчебныеОстатки85 вида Остатки, единственный документ — УчебноеДвижение85. База новая пустая, не копия рабочей.
Для этого блока никакие документы и движения не создавайте. Запрос проверяет отсутствие записей своего регистра до административного вызова. Других пользователей, обменов, расширений и фоновых заданий нет.
Создайте серверный общий модуль УчебныеИтогиПримеры. Вставьте весь модуль одного урока, вызовите ВыполнитьПример() Экспорт из собственной серверной команды обработки; обновите конфигурацию БД.
Это операции настройки/обслуживания регистра, не проведение документа. Откат движений не обещает восстановить все настройки/внутренние таблицы итогов.
Урок с границами сознательно меняет диапазон в собственном одноразовом пустом стенде. Он не восстанавливает исходный диапазон и не предназначен для рабочего регистра. Перед таким ручным опытом сохраните резервную копию собственной учебной базы.
При переключении булевых флагов исходное значение читается заранее и восстанавливается при успехе/ошибке. Если восстановление само завершилось ошибкой, код сообщает об этом явно; успешное восстановление не выдумывается.
Примеры здесь не запускались в 1С. Ваши настройки, документы и итоги этим заполнением не изменялись.
У своего УчебныеОстатки85 добавьте макет УчебнаяПамяткаИтогов типа Текстовый документ: первая строка OWN-TOTALS-85, вторая Пустой учебный регистр, не рабочая база. Обновите БД.
Процедура ВыполнитьПример() Экспорт
Если Метаданные.Документы.Количество() <> 1
Или Метаданные.РегистрыНакопления.Количество() <> 1
Или Метаданные.Документы.Найти("УчебноеДвижение85") = Неопределено Тогда
ВызватьИсключение "Разрешены только собственный учебный документ и регистр";
КонецЕсли;
Описание = Метаданные.РегистрыНакопления.Найти("УчебныеОстатки85");
Если Описание = Неопределено Тогда
ВызватьИсключение "Сначала создайте собственный учебный регистр";
КонецЕсли;
Если Описание.ВидРегистра <> Метаданные.СвойстваОбъектов.ВидРегистраНакопления.Остатки
Или Описание.Измерения.Количество() <> 1
Или Описание.Ресурсы.Количество() <> 1
Или Описание.Реквизиты.Количество() <> 0
Или Описание.Измерения.Найти("КодТовара") = Неопределено
Или Описание.Ресурсы.Найти("Количество") = Неопределено Тогда
ВызватьИсключение "Нужен регистр остатков с КодТовара и Количество";
КонецЕсли;
Менеджер = РегистрыНакопления.УчебныеОстатки85;
Если Метаданные.РежимСовместимости <> Метаданные.СвойстваОбъектов.РежимСовместимости.НеИспользовать Тогда
ВызватьИсключение "Нужен собственный стенд без старого режима совместимости";
КонецЕсли;
Если ТранзакцияАктивна() Тогда
ВызватьИсключение "Не вызывайте административный опыт внутри чужой транзакции";
КонецЕсли;
Проверка = Новый Запрос;
Проверка.Текст = "ВЫБРАТЬ КОЛИЧЕСТВО(*) КАК Строк
|ИЗ РегистрНакопления.УчебныеОстатки85";
Данные = Проверка.Выполнить().Выгрузить();
Если Данные.Количество() <> 1 Тогда
ВызватьИсключение "Не получена собственная контрольная строка";
КонецЕсли;
Если Данные[0].Строк <> 0 Тогда
ВызватьИсключение "В собственном регистре уже есть движения: этот пустой административный опыт запрещён";
КонецЕсли;
ИсходныйФлаг = Менеджер.ПолучитьРежимРазделенияИтогов();
Если ТипЗнч(ИсходныйФлаг) <> Тип("Булево") Тогда
ВызватьИсключение "Не получен собственный исходный флаг";
КонецЕсли;
ИзменениеНачато = Ложь;
Попытка
ИзменениеНачато = Истина;
Менеджер.УстановитьРежимРазделенияИтогов(Не ИсходныйФлаг);
Сообщить(Менеджер.ПолучитьРежимРазделенияИтогов() = Не ИсходныйФлаг);
Менеджер.УстановитьРежимРазделенияИтогов(ИсходныйФлаг);
Если Менеджер.ПолучитьРежимРазделенияИтогов() <> ИсходныйФлаг Тогда
ВызватьИсключение "Не подтверждено восстановление собственного флага";
КонецЕсли;
ИзменениеНачато = Ложь;
Сообщить(Менеджер.ПолучитьРежимРазделенияИтогов() = ИсходныйФлаг);
Исключение
ИсходнаяОшибка = ОписаниеОшибки();
Если ИзменениеНачато Тогда
Попытка
Менеджер.УстановитьРежимРазделенияИтогов(ИсходныйФлаг);
Если Менеджер.ПолучитьРежимРазделенияИтогов() <> ИсходныйФлаг Тогда
Сообщить("Восстановление собственного флага разделение итогов не подтверждено");
КонецЕсли;
Исключение
Сообщить("Восстановление собственного флага разделение итогов завершилось ошибкой; проверьте учебный стенд");
КонецПопытки;
КонецЕсли;
ВызватьИсключение ИсходнаяОшибка;
КонецПопытки;
КонецПроцедурыРазбор по шагам
Проверить пустой собственный регистр без параллельных пользователей.
Прочитать исходный флаг разделения, независимо от использования итогов.
Отметить намерение изменения до процедуры установки.
Переключить и повторно прочитать флаг; не выдумывать измерение параллельности по одному сеансу.
Вернуть исходный флаг; неуспех восстановления выводится явно.
Как проверить результат
Проверки переключения и возврата Истина.
Никакие разделители данных или права не изменяются.
Производительность не измерялась.
Ожидаемый результат
Проверено собственное состояние механизма без подмены другим видом разделения.
На что обратить внимание
Свойства и методы относятся только к собственному пустому регистру. Нельзя менять проверку имени на рабочий регистр ради опыта.
ПолучитьИспользованиеИтогов и ПолучитьИспользованиеТекущихИтогов — разные настройки. Текущие итоги применимы только к Остатки.
Булево возвращаемое значение метода не объявляется исходным состоянием или измеренным ускорением без отдельного контракта.
Типизированные даты/флаги и явные проверки не являются доказательством запуска в 1С; здесь выполнялись только статические проверки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.