...

Loop "For" Version 11 (Java)

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

Описание

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

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

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

Image Removed

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

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

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

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

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

Настройки

...

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

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

...

Image Removed

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

Image Removed

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

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

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

Image Removed

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

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

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

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

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

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

Задача

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

Решение

1. Добавить цикл "Для".

2. Добавить действие "Равно" внутрь цикла "Для".

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

Реализация

...

Открываем группу действий "Базовые действия".

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

1. Параметр "Начальное значение". Задаем начальное значение счетчика для цикла.

2. Параметр "Конечное значение". Задаем конечное значение счетчика для цикла.

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

...

Помещаем в рабочее пространство студии действие "Равно", внутрь цикла "Для". В данном действии будет проверяться равно ли текущее значение счетчика цикла указанному значению.

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 icon

Image Added

Settings of parameters

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. 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

1. Add a "For" loop.

2. Add an "Equal to" action inside the "For" loop.

3. 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

1. Open the "Base actions" action group.

2. 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
   
   

3. 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
      
      

4. 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
      
      

5. 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 
   
   

6. 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
   
   

7. Place the "Break the loop" action in the "If" action workspace of the "True" branch (see the description of the action "Break the loop (Base actions)").
   
   

8. Launch the robot using the "Start" button in the top panel. The final scheme of the robot will look as follows:

   Image Added

Result

The robot completed successfully. The algorithm went through the loop and was interrupted after setting the iterator state to "2".

Image Added

Case " String numbering". Loop "For".

Task

Number the first 10 rows in column "A" in an Excel file.

Solution

1. Move the "Open" loop action to the studio workspace.

2. Move the "For" loop action into the Studio workspace.

3. Move the "Set cell value" action inside the "For" loop to the Studio workspace.

4. Move the "Save" action to the Studio workspace.

5. Move the "Close" action to the Studio workspace.

Implementation

1. Move the "Open" loop action to the studio workspace.

   1. "Path to file" parameter. Specify the path to the Excel file to be opened.

      Image Added
      
      

2. Move the "For" loop action to the Studio workspace and set its parameters.

   1. "From" parameter. Set the initial value of the counter for the loop.

   2. "To" parameter. Specify the final counter value for the loop.

   3. "Increment" parameter. Set the value by which the counter will be incremented.

   Image Added
   
   

3. Move the "Set cell value" action to the Studio workspace inside the "For" loop.

   1. "Context" parameter. Specify the context of the opened Excel file.

   2. "Column of the cell" parameter. Specify the name of the column in which row numbering will be performed.

   3. "Row of the cell" parameter. Specify the number of the row in which the value will be filled. In this case, the value of the loop counter is specified.

   4. "Value" parameter. Specify the value that will be written to the cell. In this case, the value of the loop counter is specified.Image Added
      
      

4. Move the "Save" action to the studio workspace.

   1. "Context" parameter. Specify the context of the opened Excel file.

      Image Added
      
      

5. Move the "Close" action to the studio workspace.

   1. "Context" parameter. Specify the context of the opened Excel file.

      Image Added
      
      

6. Launch the robot using the "Start" button in the top panel.

Result

The robot completed successfully. 

Image Added

The algorithm looped through, the rows in the selected column of the excel file were numbered.

Image Added

...

В параметре "Первый операнд" указываем текущее состояние итератора (счетчика) цикла.

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

...

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

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

...

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

...

Запускаем робота по кнопке "Запуск" в верхней панели. Итоговая схема робота будет выглядеть следующим образом:

Image Removed

Результат

...

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

Задача

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

Решение

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

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

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

4. Перенести в рабочее пространство студии действие "Сохранить".

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

Реализация

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

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

...

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

1. Параметр "Начальное значение". Задаем начальное значение счетчика для цикла.

2. Параметр "Конечное значение". Задаем конечное значение счетчика для цикла.

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

...

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

...

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

...

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

...

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

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

...

Перенести в рабочее пространство студии действие "Сохранить".

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

...

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

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

...

Запустить робота по кнопке "Запуск" в верхней панели.

Image Removed

Результат

Робот отработал успешно. 

Image Removed

Алгоритм прошел по циклу, строки в выбранном столбце excel-файла были пронумерованы.

Image Removed