Исключение
Throw
Элемент позволяет вызвать исключение в сценарии автоматизации. Вызов исключения может быть полезен в тестировании ошибочных сценариев и помогает настроить обработку исключений разных типов.
Свойства
Описание общих свойств см. в разделе Свойства элемента. Обязательными для заполнения являются либо свойство Сообщение, либо Переменная исключения. Остальные параметры опциональные.
- Сообщение* [String] — сообщение создаваемого исключения. Пример:
"Создаем пользовательское исключение"
. Если сообщение указано, то свойство Переменная исключения заполнять не надо. - Переменная исключения* — название переменной для хранения исключения. Если переменная указана, то свойства Код, Сообщение и Тип исключения заполнять не нужно — значения будут взяты из переменной. Переменная может быть двух типов данных:
- [System.Exception ].
- [LTools.Common.Model.ExecutionExceptionInfo] — переменная с этим типом данных впоследствии может использоваться в элементе Try-Catch для повторного вызова исключения (например, в блоке Catch). Этот тип данных поддерживается в версии 1.24.6.22 (LTS), а также в Студии версии 1.24.10+.
- Тип исключения [LTools.Common.Exceptions.ExceptionTypes] — тип исключения. Чтобы выбрать значение, нажмите выпадающий список:
- General — общее исключение. Значение по умолчанию.
- ArgumentException — недопустимый аргумент, который передается методу.
- NullReference — попытка обращения по нулевой ссылке.
- IO Exception — ошибка ввода-вывода. Например, когда не найден указанный файл или папка.
- Invalid Operation — вызов метода недопустим в текущем состоянии объекта.
- Time Out — истекло время, выделенное для операции.
- Custom — пользовательское исключение.
- Business — исключение, связанное с бизнес-логикой. Например, когда определенные данные, которые необходимы в сценарии автоматизации, являются неполными или отсутствуют.
- Application — исключение, которое вызвано технической проблемой, например, приложение не отвечает.
- Код [Int32] — код исключения. Код указывается пользователем на свое усмотрение, заданных кодов нет. Пример:
1
.
Дополнительно
С версии Студии 1.24.10 доступно пакетное логирование. При отключении логирования для элемента Исключение, само исключение будет продолжать логироваться в рамках пакетного логирования. Это гарантирует фиксацию данных об ошибках и исключениях независимо от настроек для остальных элементов.
Пример использования
В нашем публичном репозитории Learning доступен RPA-проект, демонстрирующий работу элемента совместно с Try-Catch.
- Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning .
- Распакуйте архив и откройте в Студии проект StudioActivities.
- Выберите процесс
StudioActivities/Ru/Управление/Try-Catch Исключение.ltw
для просмотра.
Только код
Пример использования элемента в процессе с типом Только код (Pure code):
C#
throw new Exception("ThrowText"); //Для изменения типа исключения
следует вместо Exception указывать тот класс, который подходит в данной
ситуации. Например, ApplicationException. throw new
ApplicationException("text2");