Loop For Version 11 (Java)

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

Описание

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

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

Иконка действия

Image Removed

Параметры действия

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

Поле "Начальное значение". Первоначальное значение счетчика.
Поле "Конечное значение". Конечное значение счётчика.
Поле "Инкремент". Увеличение шага цикла.

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

Поле "Состояние итератора". Значение счётчика, для использования в текущей итерации цикла.

Настройки

...

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

Порядок работы с действием цикл «Для»

...

Action group: Base actions

...

Description

This action is intended to provide the specified iteration on the step counter.

To add a sequence of actions to the loop body, you must move them to the "Loop For" action loop.

Action group

Image Added

Action parameters

Input parameters

"From" field. The initial value of the counter.
"To" field. The final value of the counter.
"Increment" field. Increase of the loop step.

Output parameters

"Iteration actual state" field. Counter value, to be used in the current loop iteration.

Settings

Property	Description	Type	Mandatory field
Parameters
From	Initial counter value	Robin.Numeric	Yes
To	Checked before each iteration of the loop	Robin.Numeric	Yes
Increment	Increasing the loop step	Robin.Numeric	Yes
Results
Iteration actual state	Counter value for use in the current loop iteration	Robin.Numeric

Special conditions of use

Procedure for working with the "For" loop action

1. Select the "For" action from the "Base Actions" action group and transfer it to the script;

Image Added

2. Fill the body of the loop with the required actions.
Filling example:

Image Added

3. Set the action parameters:

1. From (the value from which the countdown will start).
2. To (the value up to which the countdown will continue).
3. Increment (the number by which the iterator value will be incremented).

Example of filling:

Image Added

4. The result of the loop: the state of the iterator, i.e. the counter value to be used in the current iteration of the loop.

Comparison of the "For" and "Foreach" loops.

The "For" loop will do the job the specified number of times. The iterator will take values from the initial specified value to the final value in increments specified in the "Increment" field.

The "Foreach" loop works sequentially with the elements of the selected collection. The number of iterations is equal to the number of elements in the collection selected on the input.

Thus, the result of the "For" loop is a number, and "Foreach" is an object.

Example of use

Task

The loop must be terminated if the iterator state is equal to the value "2".

Solution

Add a "For" loop.
Add an "Equal to" action inside the "For" loop.
Add "If" condition inside the "For" loop. Add the "Message in log" action to the "False" branch. Add the "Message in log" action and the "Break the loop" action to the "True" branch.

Implementation

Open the "Base actions" action group.
Place the "For" loop action in the Studio workspace and set its parameters.
1. "From" parameter. Set the initial value of the counter for the loop.
2. "To" parameter. Set the final counter value for the loop.
3. "Increment" parameter. Set the value by which the counter will be incremented.
Image Added
Place the "Equal to" action inside the "For" loop in the Studio workspace. This action will check if the current value of the loop counter is equal to the specified value.
1. In the "First operand" parameter we specify the current state of the loop iterator (counter).
2. In the "Second operand" parameter we specify the value "2".
  Image Added
Place the "If" action inside the "For" loop in the Studio workspace (see the description of the "If" action).
1. Set the condition. The condition will be the result of the "Equal to" action.
  Image Added
Place the "Message in log" action in the "If" action workspace of the "False" branch (see the description of the "Message in log" action).
Image Added
Place the "Message in log" action in the "If" action workspace of the "True" branch (see the description of the "Message in log" action).
Image Added
Place the "Break the loop" action in the "If" action workspace of the "True" branch (see the description of the action

Image Removed

2. Заполнить тело цикла необходимыми действиями.
Пример заполнения:

Image Removed

3. Заполнить параметры действия:

1. Начальное значение (значение, с которого начнется отсчет).
2. Конечное значение (значение до которого будет вестись отсчет.).
3. Инкремент (число, на которое будет увеличиваться значение итератора).

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

Image Removed

4. Результат работы цикла: состояние итератора, т.е. значение счетчика для использования в текущей итерации цикла.

Сравнение циклов «Для» и «Для каждого».

Цикл «Для» выполнит работу заданное количество раз. Итератор будет принимать значения от начального заданного значения до конечного с шагом, указанным в поле «Инкремент».

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

Таким образом результат цикла «Для» это число, а «Для каждого» объект.

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

Задача

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

Решение

Добавить цикл "Для".
Добавить действие "Равно" внутрь цикла "Для".
Добавить условие "Если" внутрь цикла "Для". В ветвь "Ложь" добавить действие "Сообщение в лог". В ветвь "Истина" добавить действие "Сообщение в лог" и действие "Прервать цикл".

Реализация

Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие цикл "Для" и настраиваем его параметры.
1. Параметр "Начальное значение". Задаем начальное значение счетчика для цикла.
2. Параметр "Конечное значение". Задаем конечное значение счетчика для цикла.
3. Параметр "Инкремент". Задаем значение, на которое будет увеличиваться счетчик.
Image Removed
Помещаем в рабочее пространство студии действие "Равно", внутрь цикла "Для". В данном действии будет проверяться равно ли текущее значение счетчика цикла указанному значению.
В параметре "Первый операнд" указываем текущее состояние итератора (счетчика) цикла.

В параметре "Второй операнд" указываем значение "2".

Image Removed

Помещаем в рабочее пространство студии действие "Если", внутрь цикла "Для" (см. описание действия "Если").

Задаем условие. Условием будет являться результат действия "Равно".

Image Removed

Помещаем в рабочее пространство действия "Если" ветви "Ложь" действие "Сообщение в лог" (см. описание действия "Сообщение в лог").

Image Removed
Помещаем в рабочее пространство действия "Если" ветви "Истина" действие "Сообщение в лог" (см. описание действия "Сообщение в лог").
Image Removed
Помещаем в рабочее пространство действия "Если" ветви "Истина" действие "Прервать цикл" (см. описание действия "Break the loop Base actions").

Запускаем робота по кнопке "Запуск" в верхней панели. Итоговая схема робота будет выглядеть следующим образомLaunch the robot using the "Start" button in the top panel. The final scheme of the robot will look as follows:

Результат

Result

The robot completed successfully. The algorithm went through the loop and was interrupted after setting the iterator state to Робот отработал успешно. Алгоритм прошел по циклу и был прерван после установки состояния итератора в значение "2".

Кейс «Нумерация строк». Цикл «Для».

Задача

Пронумеровать первые 10 строк в столбце "A" в Excel-файле.

Решение

Перенести в рабочее пространство студии действие "Открыть".
Перенести в рабочее пространство студии действие цикл "Для".
Перенести в рабочее пространство студии внутрь цикла "Для" действие "Установить значение ячейки".
Перенести в рабочее пространство студии действие "Сохранить".
Перенести в рабочее пространство студии действие "Закрыть".

Реализация

Перенести в рабочее пространство студии действие "Открыть".

Параметр "Путь к файлу". Указать путь к Excel-файлу, который необходимо открыть.

...

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

Параметр "Начальное значение". Задаем начальное значение счетчика для цикла.
Параметр "Конечное значение". Задаем конечное значение счетчика для цикла.
Параметр "Инкремент". Задаем значение, на которое будет увеличиваться счетчик.

...

Перенести в рабочее пространство студии внутрь цикла "Для" действие "Установить значение ячейки".

...

Параметр "Контекст". Указывать контекст открытого Excel-файла.

...

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

...

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

Параметр "Значение". Указать значение, которое будет записано в ячейку. В данном случае указывается значение счетчика цикла.

Case " String numbering". Loop "For".