Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Try-catch

...

Version 19 (Net)

Группа действий: Базовые действия 

Описания

Данное действие предназначено для обработки исключений в выбранных действиях.

Image Removed

Иконка

Image Removed

Параметры

Входные параметры

  1. Блок Try - Действия для выполнения, во время исполнения которых может произойти исключение.
  2. Блок Catch - Действия для обработки возникшего исключения.

Таких блоков может быть несколько, тогда будет создан параметр "Исключения для CATCH <номер последовательности>" для каждого из добавленных блоков.

Исключения - Список исключений, для обработки которых предназначена соответствующая последовательность Catch.

Таких последовательностей может быть несколько, тогда будет создан параметр "Исключения для CATCH <номер последовательности>" для каждой из добавленных.

3. Блок Finally - Действия для выполнения в любом случае.

Выходные параметры 

На выходе получаем ошибку возникшую в ходе выполнения блока Try.

Настройки

...

Действия для выполнения, во время исполнения которых может произойти исключение.

!! Данный параметр не отображается и назначается системой автоматически.

...

Да

Действия в блоке должны быть

...

Действия для обработки возникшего исключения.

Таких блоков может быть несколько, тогда будет создан параметр "Исключения для CATCH <номер последовательности>" для каждого из добавленных блоков.

!! Данный параметр не отображается и назначается системой автоматически.

...

Action group: General

...

Description

This action is designed to handle exceptions in selected actions.

Image Added

 

Action icon

Image Added

Parameters

Input parameters 

  1. Try clause - actions to execute, during the execution of which an exception may occur.
  2. Catch clause - actions to handle an exception

There can be several of these blocks, then the parameter "Exceptions for CATCH <sequence number>" will be created for each of the added blocks

Exceptions - exceptions collection that must be processed within the corresponding Catch clause

There may be several of these collections, then the parameter "Exceptions for CATCH <sequence number>" will be created for each of the added collections

3. Finally clause - actions to be taken either way

Output parameters 

The output is an error that occurred within the Try clause

Settings

PropertyDescriptionTypeFilling exampleMandatory field
Parameters
ExceptionsExceptions collection that must be processed within the corresponding Catch clause.Robin.Collection
Yes
Results
ErrorError that occurred within Try clause.Robin.Exception

Special conditions of use 

If there are no actions in the Catch clause(s), the studio will continue working, ignoring the caught errors.

If there are no actions in the Finally clause, the studio will continue working. 

How to work with Try-Catch

  1. Select the "Try-Catch" action from the "Base actions" action group and move to the workspace.
    Image Added
  2. In the "Try" clause place the actions for which the exception will be executed. In the "Catch" clause place the actions that will be executed if an exception occurs, i.e. any situation when the action is performed incorrectly, in other words, an error occurs. If the "Catch" clause is not filled in, the robot will continue working on the script, ignoring the errors that occurred.
    Fill-in example: 
    Image Added
    There can be several "CATCH" clauses, then the parameter "Exception for CATCH [Block Number]" will be created for each block. This is needed when there is a different action option for each possible error.
    Example:
    The "Try-Catch" action in the script: 

Image Added

Filled in parameters of the "Try-Catch" action: 

Image Added

Thus, if the web-element is not found, the robot will perform the action from the "Catch" clause, and if there is an unknown error, the robot will perform the action from the "CATCH 2" clause. 

3. Fill in parameters of the "Try-Catch" action.
The parameters are filled in the format of a collection, which is a list of exceptions that the corresponding Catch sequence is designed to handle.
Several types of errors are available.  To select an error type, click on the selected type and then on the arrow next to it.

Image Added

After moving all required error types, click the "Save" button. 

Example of the filled parameters:

Image Added

Example of filled parameters for several "Catch" clauses.

Image Added

Finally clause

The Finally clause is a non-mandatory clause. The actions specified in this clause will be executed regardless of whether an error occurs or not. If there are no actions in the Finally clause, the robot will continue its work.

Example of the filled Finally clause:

Image Added

Above the general aspects of working with the "Try-Catch" action have been considered. Let's consider the case "Weather", where the work of this action is demonstrated.

Example of use 

Task

The robot needs to go to a search engine, search for "Weather" and get today's temperature and then save it to an Excel-file.
The task is simple, but errors may occur during its execution.

Solution

Use the "Try-Catch" action for handling potential errors.

Implementation

  1. Place all script actions in the "Try" clause.
  2. In the "Catch" clause, place a "Message" action that tells the robot that a browser error has occurred.
  3. In the "CATCH 2" clause, place a "Message" action that will report that an error occurred in the "Excel" action group.
  4. In the Finally clause, place an informational message that the robot has finished its work.

Example of filling in the "Try" clause

Image Added

Image Added

Example of filling in the "Catch" clause

Image Added


5. Fill in the parameters: select the types of errors that can occur while working with the actions of the "Browsers" group for the "Catch" clause. 

Image Added

And the types of errors that can occur as a result of working with the Excel group actions from those suggested for the CATCH 2 clause.

Image Added


Result

Image Added


Then a message from the Finally clause appeared on the screen. 

Image Added


An error occurred while the robot was running, analyzing the log in the studio, you can see how the robot stopped working with the actions in the "Try" clause, went to the "CATCH 2" clause and displayed an informational message.

Image Added

Due to the presence of the "Try-Cath" clause, the robot completed its work without errors, even though an error occurred when opening the file

Нет

Действий в блоке может не быть

...

Список исключений, для обработки которых предназначена соответствующая последовательность Catch.

Таких последовательностей может быть несколько, тогда будет создан параметр "Исключения для CATCH <номер последовательности>" для каждой из добавленных.

...

Коллекция

...

Нет

Блока может не быть

...

Ошибка возникшая в ходе выполнения блока Try

...

Идентификатор типа исключения

Особые условия использования

Если в блоке/блоках Catch отсутствуют действия, то студия продолжит работу ,проигнорировав отловленные ошибки.

Если в блоке Finally отсутствуют действия, то студия продолжит работу.

Порядок работы с Try-Catch

  1. Выбрать действие «Try-Catch» из группы действий «Базовые действия» и перетащить  на рабочую область.
    Image Removed
  2. В блок «Try» поместить действия, для которых будет выполнено исключение. В блок «Catch» поместить действия, которые будут выполнены, если возникнет исключение, т.е. какая-либо ситуация, когда действие выполнено некорректно, иными словами, возникнет ошибка. Если блок «Catch» не заполнен, то робот продолжит работу сценария, проигнорировав возникшие ошибки.
    Пример заполнения: 
    Image Removed
    Блоков «Сatch» может быть несколько, тогда для каждого блока будет создан параметр «Исключение для CATCH [Номер блока]». Это нужно, когда для каждой возможной ошибки есть свой вариант действия.
    Пример:
    Действие «Try-Catch» в сценарии: 

Image Removed

Заполненные параметры действия «Try-Catch»: 

Image Removed

Таким образом, если веб-элемент не будет найден, то робот выполнит действие из блока «Catch», а если возникнет неизвестная ошибка, то робот выполнит действие из блока «CATCH 2». 

3.  Заполнить параметры действия «Try-Catch».
Параметры заполняются в формате коллекции, представляющей собой список исключений, для обработки которых предназначена соответствующая последовательность Catch.
Доступно несколько типов ошибок.  Для выбора типа ошибки необходимо нажать на выбранный тип, а затем на стрелку рядом с ним. 

Image Removed

После перенесения всех необходимых типов ошибок, нажать кнопку «Сохранить». 

Пример заполненных параметров: 

Image Removed

Пример заполненных параметров для нескольких блоков «Catch».

Image Removed

Блок Finally
Блок Finally является не обязательным блоком. Действия, указанные в этом блоке, выполнятся вне зависимости от того, возникла ошибка или нет. Если в блоке Finally отсутствуют действия, то робот продолжит свою работу.

Пример заполнения блока Finally:

Image Removed

Выше были рассмотрены общие моменты работы с действием «Try-Catch». Рассмотрим кейс «Погода», где продемонстрирована работа этого действия.

Пример использования 

Задача

Роботу необходимо зайти в поисковую систему, сделать запрос «Погода» и получить сегодняшнюю температуру, а затем сохранить ее в excel-файл.
Задача простая, но в ходе ее выполнения могут возникнуть ошибки.

Решение

воспользоваться действием «Try-Catch» для обработки возможных ошибок.  

Реализация

  1. Поместить все действия сценария в блок «Try»,
  2. В блок «Catch» поместить действие «Сообщение», в котором робот сообщит, что возникла ошибка при работе с браузером.
  3. В блок «CATCH 2» поместить действие «Сообщение», которое сообщит, что ошибка произошла в действии группы «Excel».

       4. В блоке Finally поместить информационное сообщение о том, что робот закончил работу.

Пример заполнения блока «Try»

Image Removed

Пример заполнения блока «Catch»

Image Removed

5. Заполнить параметры: выбрать типы ошибок, которые могут возникнуть во время работы с действиями группы «Браузеры» для блока «Catch». 

Image Removed

И типы ошибок, которые могут возникнуть в результате работы с действиями группы «Excel» из предложенных для блока «CATCH 2».

Image Removed

Результат: 

Image Removed

Затем на экране появилось сообщение из блока «Finally». 

Image Removed

При работе робота произошла ошибка, анализируя лог в студии, можно увидеть, как робот остановил работу с действиями в блоке «Try», перешел в блок «CATCH 2» и вывел на экран информационное сообщение. 

Image Removed

Из-за наличия блока «Try-Cath» робот завершил свою работу без ошибок , несмотря на то, что при открытии файла возникла ошибка.