Группа действий / Sequence

Данное действие предназначено для группировки элементов/действий в отдельный блок.

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры

Идентификатор

Sequence ID

Идентификатор последовательности действий.

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

Robin.Internal.SequenceId

Нет

Последовательность может быть пустой.

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

Отсутствуют.

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

Задача:

Открыть excel-файл, посчитать количество строк в нем и закрыть файл.

Все действия должны быть сгруппированы в одну последовательность.

Решение:

Добавить действие Открыть для Exel-документа.
Добавить действие Получить количество строк.
Добавить действие Закрыть для Exel-документа.

Реализация:

Создаем переменную "Числовая_переменная" с типом "Число", которая будет являться результатом действия "Получить количество строк" и содержать значение "0".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Группа действий" и настраиваем его параметры.
Открываем группу действий "Exel".
Помещаем в контур действия "Группа действий "действие "Открыть " и настраиваем его параметры (см. описание действия "Открыть") .
Помещаем в контур действия "Группа действий "действие "Получить количество строк" и настраиваем его параметры (см. описание действия "Получить количество строк").
Помещаем в контур действия "Группа действий "действие "Закрыть " и настраиваем его параметры (см. описание действия "Закрыть").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Действия сгруппированы.

Алгоритм прошел по всем действиям группы и записал значение в переменную "Числовая_переменная".

Присвоить значение / Assign value

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Значение	Value	Значение, которое будет присвоено результату. Передано на выход действия в неизменном виде.	Robin.Object	56	Да
Результаты
Результат	Result	Переменная, которой будет присвоено указанное значение. Выход, значением которого станет значение переданное на вход действия.	Robin.Object

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

Значение полученное на входе передается на выход действия. При помощи данного действия можно присвоить значение переменной во время выполнения. Например, сброс счетчика.

Сгенерировать случайное число / Get random number

Данное действие предназначено для получения случайного числа.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Минимум	Minimum	Наименьшее возможное значение. По умолчанию используется граница типа.	Robin.Numeric	1	Нет
Максимум	Maximum	Наибольшее возможное значение. По умолчанию используется граница типа.	Robin.Numeric	100	Нет
Целое	Integer	Будет сгенерировано целое число.	Robin.Boolean	true	Нет
Результаты
Результат	Result	Сгенерированное случайное число.	Robin.Numeric

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

Отсутствуют.

Конвертировать в строку данные / Convert to string data

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Источник	Source	Переменная, значение которой будет конвертироваться.	Robin.Object	Числовая_переменная	Да
Тип	Data type	Тип данных, в который необходимо конвертировать значение параметра "Источник" Выпадающий список: Строка Число Изображение Путь к папке Путь к файлу Дата и время	Robin.String		Да
Результаты
Результат	Result	Переменная выбранного типа, в которую будет записано конвертированное значение из поля "Источник". Если тип неконвертируемый будет выводиться ошибка.	Robin.Object	Строковая_переменная	Нет

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

Отсутствуют.

Сделать скриншот / Take a screenshot

Данное действие предназначено для скриншота экрана.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Папка	Folder	Папка, где необходимо сохранить скриншот.	Robin.FolderPath	C:\Users\RLABUTIN\Documents\RobinStudio\1.1) Base action (RUS)\Base action (RUS)	Да
Имя файла	File name	Имя файла сохранения для скриншота.	Robin.String	Скрин1	Да
Формат	Format	Формат, в котором скриншот будет сохранен. Выпадающий список. Доступны значения: JPEG JPG BMP PNG GIF TIF TIFF	Robin.String	JPG	Да
Тип	Type	Типы скриншота области. Выпадающий список. Доступны значения: FullScreen - Весь экран. Window - Активное окно. Specific area - Выделенная область. По умолчанию значение равно "FullScreen".	Robin.String	Координаты	Да
Область	Area	Размер и положение области для скриншота. Пользователь имеет возможность вручную выделить область экрана или заполнить значения: X левого верхнего угла; Y левого верхнего угла; "Высота"; "Ширина". В случае ручного выделения Система автоматически заполнит эти значения данными выбранной области.	Robin.RectangleLocation		Нет
Результаты
Результат	Result	Путь до сохраненного скриншота. Будет сохранен в выбранной папке в формате "<<Имя файла>>.<<Формат>>"	Robin.Image	C:\Users\RLABUTIN\Documents\RobinStudio\1.1) Base action (RUS)\Base action (RUS)\Скрин1.jpg

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

Отсутствуют.

Вывести ошибку / Throw exception

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

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры

Сообщение

Message

Текст, который будет выведен в лог-файл сообщения.

Если параметр не заполнен будет выведено: "Неизвестная ошибка".

Robin.String

Возникла ошибка!

Нет

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

Отсутствуют.

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

Задача:

Необходимо получить ответ пользователя на вопрос о завершении программы.

Если ответ предполагает, что работу необходимо прекратить, вывести в лог сообщение и завершить работу.

Решение:

Добавить действие "Вопрос".
Добавить действие "Если".
Добавить действие "Вывести ошибку".

Реализация:

Открываем группу действий "Диалоговые окна".
Помещаем в рабочее пространство студии действие "Вопрос".
Настройка действия:
1. 1. В параметр "Вопрос" указываем текст: "Остановить работу программы?"
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0").
Настройка действия:
1. 1. Задаем в условие результат действия "Вопрос".
  2. Помещаем на ветку "Да" действие "Вывести ошибку".
  3. В параметр "Сообщение" действия "Вывести ошибку" указываем текст: "Пользователь запросил остановку программы".
Запускаем робота по кнопке "Запуск" в верхней панели.
Отвечаем "Да" на вопрос в диалоговом окне.

Результат:

Работа программы была завершена, в лог выведено сообщение "Пользователь запросил остановку программы".

Перехват ошибок / Try-catch

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Обязательность заполнения поля
Параметры
Блок Try	Try clause	Действия для выполнения, во время исполнения которых может произойти исключение. !! Данный параметр не отображается и назначается системой автоматически.	Robin.Internal.SequenceId	Да Действия в блоке должны быть
Блок Catch	Catch clause	Действия для обработки возникшего исключения. Таких блоков может быть несколько, тогда будет создан параметр "Исключения для CATCH <номер последовательности>" для каждого из добавленных блоков. !! Данный параметр не отображается и назначается системой автоматически.	Robin.Internal.SequenceId	Нет Действий в блоке может не быть
Исключения	Exceptions	Список исключений, для обработки которых предназначена соответствующая последовательность Catch. В тулзе к выбору предложены следующие типы: Вкладка не найдена Время истекло Время истекло (win) Изображение не найдено Индекс вне диапазона Неконвертируемый формат Параметр не найден Окно не найдено Ошибка в последовательности Ошибка базы данных Папка не найдена Папка недоступна Файл не найден Файл недоступен Ячейка не найдена Web-элемент не найден Web-элемент вне доступа Win-элемент не найден Неизвестная ошибка Любая ошибка Последовательностей CATCH может быть создано несколько, тогда для каждой из добавленных будет создан параметр "Исключения для CATCH <номер последовательности>" . "Неизвестная ошибка" - это ошибка, которая не принадлежит к одному из перечисленных определенных типов. "Любая ошибка" - это любая ошибка, определенного или неизвестного типа.	Robin.Collection	Да
Блок Finally	Finally clause	Действия для выполнения в любом случае.	Robin.Internal.SequenceId	Нет Блока может не быть
Результаты
Ошибка	Error	Ошибка возникшая в ходе выполнения блока Try	Robin.Exeception

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

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

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

Исключение типа "Любая ошибка" следует выбирать в последнем блоке Catch, если их несколько.

Если / If

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Условие	Condition	Логическое выражение, результат выполнения которого является условием перехода по веткам "Да" и "Нет".	Robin.Boolean	true	Да
Истина	True	Последовательность при выполнении условия. !! Данный параметр не отображается и назначается системой автоматически.	Robin.Internal.SequenceId		Нет Действий в последовательности может не быть
Ложь	False	Последовательность при невыполнении условия. !! Данный параметр не отображается и назначается системой автоматически.	Robin.Internal.SequenceId		Нет Действий в последовательности может не быть

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

Условие "Если" может иметь только две ветви. На каждой ветви уже указан результат выражения ("Да"/ "true") и "Нет"/ "false"), по которому будет осуществлять переход на данную ветвь. Для добавления в тело ветви последовательности действий необходимо переместить их на контур соответствующего действия.

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

Задача:

Существуют переменные с типом "Массив чисел" и "Число", содержащие соответственно значение "(1988, 8, 2, 4)" и "0".

Необходимо завершить работу цикла пока значение числовой переменной не будет равно значению "2".

Решение:

Добавить цикл "Для каждого".
Добавить условие "Если". В ветвь "Нет" добавить прерывание цикла и сообщение в лог.
Сообщение в лог.

Реализация:

Создаем переменную "Числовая_переменная2" с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
Создаем переменную "Массив_чисел" с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле.
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Цикл "Для каждого" (см. описание действия "Цикл "Для каждого"").
Помещаем в рабочее пространство студии действие "Если".
Настройка действия:
1. Параметр "Условие". Указываем логическое выражение "Числовая_переменная2!=2", частью которого является переменная "Числовая_переменная2".
2. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
3. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0").
Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм прошел по циклу и был прерван после установки переменной значения "2".

Сообщение в лог / Log message

Данное действие предназначено для отправки в лог-файл сообщения.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Сообщение	Message	Текст, который будет выведен в лог-файл сообщения.	Robin.String	Текстовое сообщение	Да

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

Отсутствуют.

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

Задача:

Существует переменная с типом "Строка", содержащая значение "Red".

Необходимо перейти на соответствующий раздел ветвления и вывести в лог сообщение.

Решение:

Добавить ветвление.
Добавить сообщение в лог.

Реализация:

Создаем переменную "Строковая_переменная1" с типом "Строка", которая будет являться выражением и содержать текст "Red".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Ветвление" .
Нажимаем два раза на кнопку "" на действии "Ветвление" и получаем три рабочие ветви. Ветвь Default можно удалить.
Настраиваем его параметры действия "Ветвление" таким образом, чтобы текст "Red" соответствовал второй ветви (см. описание действия "Базовые действия 2.0").
Помещаем действия "Сообщение в лог" в каждую ветвь и настраиваем параметры:
1. Параметр "Сообщение" для действия "Сообщение в лог" первой ветви. Указываем текст "Ветвь №1", для вывода в лог-файл сообщения.
2. Параметр "Сообщение" для действия "Сообщение в лог" второй ветви. Указываем текст "Ветвь №2", для вывода в лог-файл сообщения.
3. Параметр "Сообщение" для действия "Сообщение в лог" третьей ветви. Указываем текст "Ветвь №3", для вывода в лог-файл сообщения.
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм прошел по всем шагам, перешел по ветви№2 и вывел в лог сообщение "Ветвь №2".

Ожидать / Sleep

Данное действие предназначено для установки ожидания на заданное время в момент выполнения сценария.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Время ожидания	Sleep time	Время ожидания перехода алгоритма на следующий шаг. Указывается в миллисекундах.	Robin.Numeric	1000	Да

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

Отсутствуют.

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

Задача:

Существует массив чисел, содержащий значения "(1988, 8, 2, 4)".

Необходимо:

Пройти по элементам массива с ожиданием перехода на следующий шаг равным 1 секунде.
Завершить работу цикла, когда значение числовой переменной будет равно значению "2".

Решение:

Добавить цикл "Для каждого".
Добавить условие "Если". В ветвь "Да" добавить прерывание цикла и сообщение в лог. В ветвь "Нет" добавить время ожидания.

Реализация:

Создаем переменную "Числовая_переменная" с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
Создаем переменную "Массив_чисел" с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле..
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Цикл "Для каждого" (см. описание действия "Цикл "Для каждого"").
Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0").
1. Параметр "Условие". Указываем логическое выражение "Числовая_переменная != 2", частью которого является переменная "Числовая_переменная".
2. Помещаем в рабочее пространство действия "Если" ветви "Да" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0").
3. Помещаем в рабочее пространство действия "Если" ветви "Да" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
4. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Ожидать".
  Настройки действия:
  1. Параметр "Время ожидание". Вводим в поле значение "1000"
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм прошел по циклу и был прерван после установки переменной значения "2".

При переходе на ветвь "Нет" время ожидания перехода алгоритма на следующий шаг составило 1 секунду.

Ветвление / Switch

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

Для добавления нового условия необходимо нажимать на кнопку "", расположенной на самом действии.

Для добавления ветки перехода по умолчанию необходимо нажимать на кнопку "", расположенной на самом действии.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Выражение выбора	Expression	Значение для выбора выполняемой ветки.	Robin.String	Нужная_переменная	Да
Условие для Ветки, где "" - номер ветки	Branch* condition, где "*" - номер ветки	Значение, которое будет сравниваться со значением в поле "Условие". При совпадении будет выполняться соответствующая этому значению ветка. Заполняется для каждой созданной ветви ветвления, кроме ветви по умолчанию. Веток может быть создано несколько. По умолчанию создается 2 ветки - минимально возможное количество. Если две ветви содержат одинаковое условие, то действие завершится ошибкой.	Robin.String	Строковый текст	Да
Ветка, где "" - номер ветки	Branch, где "" - номер ветки	Последовательность действий, которая будет выполнена, если удовлетворяется условие. !! Данный параметр не отображается и назначается системой автоматически.	Robin.Internal.SequenceId		Да Действия в последовательности должны быть
Ветка по умолчанию	Default branch	Последовательность действий, которая будет выполнена, если не удовлетворяется ни одно условие. !! Данный параметр не отображается и назначается системой автоматически. Ветка необязательная, создается по желанию пользователя.	Robin.Internal.SequenceId

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

При добавления ветки перехода по умолчанию, данная ветка будет исполнена, если условие не совпало в остальных ветках.

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

Задача:

Существует переменная с типом "Строка", содержащая значение "Red".

Необходимо перейти на соответствующий раздел ветвления и вывести в лог сообщение.

Решение:

Добавить ветвление.
Добавить сообщение в лог.

Реализация:

Создаем переменную "Строковая_переменная1" с типом "Строка", которая будет являться выражением и содержать текст "Red".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Ветвление".
Нажимаем три раза на кнопку "" на действии.
Настройка действия:
1. Параметр "Условие". Выбираем переменную "Строковая_переменная1", значение которой будет проверяться на соответствие условиям.
2. Параметр "Условие для Ветки 1". Выбираем результат выражение "Blue", который будет сравниваться со значением в поле "Условия" действия "Ветвление".
3. Параметр "Условие для Ветки 2". Выбираем результат выражение "Red", который будет сравниваться со значением в поле "Условия" действия "Ветвление".
4. Параметр "Условие для Ветки 3". Выбираем результат выражение "Black", который будет сравниваться со значением в поле "Условия" действия "Ветвление".
Помещаем действие "Сообщение в лог" с сообщением "Ветвь №1", "Ветвь №2" и "Ветвь №3" соответствующую номеру ветвь (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм прошел по ветви№2 и вывел сообщение в лог "Ветвь №2".

Копировать текст в буфер / Copy text into clipboard

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Текст	Text	Переменная, которая будет сохранена в буфер.	Robin.String	Строковая переменная	Да

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

Отсутствуют.

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

Задача:

Существует переменная с типом "Строка".

Необходимо записать данные из переменной в буфер.

Решение:

Добавить действие "Копировать текст в буфер".
Заполнить параметр "Текст".

Реализация:

Создаем переменную "Строковая_переменная1" с типом "Строка".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Копировать текст в буфер".
Настройка действия:
1. Параметр "Текст". Выбираем переменную "Строковая_переменная1", текст из которой будет сохранен в буфера.
Запускаем робота по кнопке "Запуск" в верхней панели*.

Результат:

Текст из переменной записан в буфер

Получить текст из буфера / Get text from clipboard

Данное действие предназначено для сохранения текста из буфера в переменную типа "Строка".

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Результаты

Результат

Result

Переменная, в которую будет сохранен текст из буфера.

При неудаче извлечения значения из буфера в результат будет сохранена пустая строка.

Robin.String

Строковая_переменная

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

Отсутствуют.

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

Задача:

Существует переменная с типом "Строка".

Необходимо перейти на соответствующий раздел ветвления после получения текста из буфера.

Решение:

Добавить получения текста из буфера.
Добавить ветвление.
Добавить сообщение в лог.

Реализация:

Создаем переменную "Result" с типом "Строка".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Получить текст из буфера".
Настройка действия:
1. Параметр "Результат". Выбираем переменную "Result", в которую будет сохранен текст из буфера.
Помещаем в рабочее пространство студии действие "Ветвление" (см. описание действия "Базовые действия 2.0").
Нажимаем три раза на кнопку "" на действии "Ветвление".
Помещаем действие "Сообщение в лог" с сообщением "Ветвь №1", "Ветвь №2" и "Ветвь №3" соответствующую номеру ветвь (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели*.

*предварительно необходимо скопировать текст "Red" в буфер обмена (как вариант: создать на рабочем столе текстовый документ, содержащий текст "Red". Выделить текст Red" и с помощью ПКМ открыть контекстное меню и выбрать "Копировать").

Результат:

Алгоритм прошел по ветви №2 после получения данных из буфера.

Прервать цикл / Break the loop

Данное действие предназначено для прерывания текущей итерации цикла/ветвления и выхода из цикла/ветвления. Действия в цикле, установленные после действия "Продолжение цикла", завершены не будут.

Настройки

Отсутствуют.

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

Должен использоваться внутри цикла, в противном случае Система выведет предупреждение "Действие "Прервать цикл" находится вне цикла".

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

Задача:

Существуют переменные с типом "Массив чисел" и "Число", содержащие соответственно значение "(1988, 8, 2, 4)" и "0".

Необходимо завершить работу цикла пока значение числовой переменной не будет равно значению "2".

Решение:

Добавить цикл "Для каждого".
Добавить условие "Если". В ветвь "Нет" добавить прерывание цикла и сообщение в лог.
Сообщение в лог.

Реализация:

Создаем переменную "Числовая_переменная2" с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
Создаем переменную "Массив_чисел" с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле..
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Цикл "Для каждого" (см. описание действия "Цикл "Для каждого"").
Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0").
1. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
2. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл".
Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм прошел по циклу и был прерван после установки переменной значения "2".

Продолжить цикл / Continue the loop

Данное действие предназначено для прерывания текущей итерации цикла и начала следующей итерации. Действия в цикле, установленные после действия "Продолжение цикла", завершены не будут.

Настройки

Отсутствуют.

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

Должен использоваться внутри цикла, в противном случае Система выведет предупреждение "Действие "Продолжить цикл" находится вне цикла.".

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

Задача:

Существуют переменные с типом "Массив чисел" и "Число", содержащие соответственно значение "(1988, 8, 2, 4)" и "0".

Необходимо завершить работу цикла пока значение числовой переменной не будет равно значению "2".

Если элемент массива не равен значению "2", то текущая итерация должна быть прервана.

Решение:

Добавить цикл "Для каждого".
Добавить условие "Если". В ветвь "Нет" добавить прерывание цикла и сообщение в лог. В ветвь "Да" добавить продолжения цикла.
Сообщение в лог.

Реализация:

Создаем переменную "Числовая_переменная2" с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
Создаем переменную "Массив_чисел" с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле..
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Цикл "Для каждого" (см. описание действия "Цикл "Для каждого"").
Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0").
1. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
2. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0").
3. Помещаем в рабочее пространство действия "Если" ветви "Да" действие "Продолжить цикл".
Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм прошел по циклу и был прерван после установки переменной значения "2".

При этом, если элемент массива был не равен значению "2", то текущая итерация прерывалась и переходила на следующую.

Цикл с постусловием /Loop Do While

Данное действие предназначено для создания цикла действий, который выполняется до тех пор, пока результат условия равен "True". Для добавления условия используется инструмент построения выражений в параметре "Условие. Для добавление в тело цикла последовательности действий необходимо переместить их на контур блока "Тело цикла".

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Условие	Condition	Логическое выражение или переменная/значение логического типа, определяющее продолжение или прерывание цикла. Условие проверяется после выполнения тела цикла. Для задания логического выражения используется инструмент построителя выражений. !! Если пользователь удаляет из параметра значение, заданное инструментом построения выражений, блок "Условие" на флоу очищается.	Robin.Boolean	True	Да
Условие	Condition	Последовательность действий в выражении в условии. Заполняется в случае, когда условие задается через построитель выражений. !! Данный параметр не отображается в панели параметров, но отображается в блоке Условие на рабочей области (флоу). !! Параметр заполняется/редактируется через инструмент построения выражений и только через него. Любое редактирование данного блока на флоу для пользователя заблокировано.	Robin.Internal.SequenceId		Нет
Тело цикла	Loop body	Последовательности действий, которая должна выполняться на каждом шаге цикла. Заполняется добавлением действий в соответствующий блок в рабочую область. !! Данный параметр не отображается в панели параметров, но отображается в блоке Тело цикла на рабочей области (флоу).	Robin.Internal.SequenceId		Да

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

Так как это логическое выражение оценивается после каждого выполнения цикла, цикл "Пока" выполняется один или несколько раз.

Цикл Для /For-Loop

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

Для добавления в тело цикла последовательности действий необходимо переместить их на контур действия "Цикл Для".

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Начальное значение	Initial value	Первоначальное значение счетчика.	Robin.Numeric	0	Да
Конечное значение	End value	Конечное значение счетчика.	Robin.Numeric	10	Да
Инкремент	Increment	Увеличение шага цикла.	Robin.Numeric	1	Да
Идентификатор	Sequence Id	Идентификатор последовательности действий, которая должна выполняться на каждом шаге цикла. !! Данный параметр не отображается и назначается системой автоматически.	Robin.Internal.SequenceId		Да Действия внутри последовательности должны быть
Результаты
Состояние итератора	Iteration actual state	Значение счетчика для использования в текущей итерации цикла.	Robin.Numeric	ITERATION_ACTUAL_STATE

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

Отсутствуют.

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

Задача:

Необходимо завершить работу цикла, если состояние итератора будет равно значению "2".

Решение:

Добавить цикл "Для".
Добавить условие "Если". В ветвь "Нет" добавить прерывание цикла и сообщение в лог.
Сообщение в лог.

Реализация:

Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Цикл Для".
Настройка действия:
1. Параметр "Начальное значение". Задаем начальное значение счетчика для цикла.
2. Параметр "Конечное значение". Задаем конечное значение счетчика для цикла.
3. Параметр "Инкремент". Задаем значение, на которое будет увеличиваться счетчик.
4. Результат "Состояние итератора". Выбираем переменную "ITERATION_ACTUAL_STATE", в которую будет помещено значение счетчика для каждого шага цикла.
Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0").
1. Задаем условие "ITERATION_ACTUAL_STATE == 2"
2. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
3. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0")
Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм прошел по циклу и был прерван после установки состояния итератора в значение "2".

Цикл "Для каждого" / Loop For Each

Данное действие предназначено для обеспечения заданной итерации по элементам коллекции. Для добавления в тело цикла последовательности действий необходимо переместить их на контур действия "Цикл "Для каждого".

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Коллекция	Collection	Коллекция объектов, проход по которым будет осуществляться в цикле.	Robin.Collection	Коллекция_значений	Да
Идентификатор	Sequence Id	Идентификатор последовательности действий, которая должна выполняться на каждом шаге цикла. !! Данный параметр не отображается и назначается системой автоматически.	Robin.Internal.SequenceId		Да Действия в последовательности должны быть
Результаты
Объект	Object	Объект, в который будет помещен каждый элемент коллекции.	Robin.Object	ITERATION_ACTUAL_STATE

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

Отсутствуют.

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

Задача:

Существует коллекция переменных с типом "Массив чисел" и "Число", содержащие соответственно значение "(1988, 8, 2, 4)" и "0".

Необходимо завершить работу цикла, пока значение числовой переменной не будет равно значению "2".

Решение:

Добавить цикл "Для каждого".
Добавить условие "Если". В ветвь "Нет" добавить прерывание цикла и сообщение в лог.
Сообщение в лог.

Реализация:

Создаем и добавляем в коллекцию "Коллекция_значений" переменную с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
Создаем и добавляем в коллекцию "Коллекция_значений" переменную с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле.
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Цикл "Для каждого".
Настройка действия:
1. Параметр "Коллекция". Выбираем коллекцию "Коллекция_значений", проход по объектам которой будет осуществляться в цикле.
2. Параметр "Объект". Выбираем переменную "ITERATION_ACTUAL_STATE", в которую будет помещен каждый элемент коллекции.
Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0").
1. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
2. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0").
Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм прошел по циклу и был прерван после установки переменной значения "2".

Пока/ Loop while

Данное действие предназначено для создания цикла действий, который выполняется до тех пор, пока результат условия равен "True". Для добавления условия используется инструмент построения выражений в параметре "Условие. Для добавление в тело цикла последовательности действий необходимо переместить их на контур блока "Тело цикла".

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Условие	Condition	Логическое выражение или переменная/значение логического типа, определяющее продолжение или прерывание цикла. Условие проверяется до выполнения тела цикла. Для задания логического выражения используется инструмент построителя выражений. !! Если пользователь удаляет из параметра значение, заданное инструментом построения выражений, блок "Условие" на флоу очищается.	Robin.Boolean	True	Да
Условие	Condition	Последовательность действий в выражении в условии. Заполняется в случае, когда условие задается через построитель выражений. !! Данный параметр не отображается в панели параметров, но отображается в блоке Условие на рабочей области (флоу). !! Параметр заполняется/редактируется через инструмент построения выражений и только через него. Любое редактирование данного блока на флоу для пользователя заблокировано.	Robin.Internal.SequenceId		Да Действия в последовательности должны быть
Тело цикла	Loop body	Последовательности действий, которая должна выполняться на каждом шаге цикла. Заполняется добавлением действий в соответствующий блок в рабочую область. !! Данный параметр не отображается в панели параметров, но отображается в блоке Тело цикла на рабочей области (флоу).	Robin.Internal.SequenceId		Да Действия в последовательности должны быть

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

Так как это логическое выражение оценивается перед каждым выполнением цикла, цикл "Пока" выполняется ноль или несколько раз.

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

Задача:

Решение:

Документация ROBIN > Базовые действия > image2020-10-16_11-18-29.png

Реализация:

Результат: