Цикл Для /For-Loop

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

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

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

Настройки

Initial value

End value

Increment

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

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

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

1.Выбрать действие «Для» из группы действий «Базовые действия» и перенести в сценарий;

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

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

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

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

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

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

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

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

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

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

Задача:

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

Решение:

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

Реализация:

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

Результат:

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

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

Задача: пронумеровать строки в excel-файле
Решение:

1. Создать переменную «Номер». Тип переменной «Число». 

2. Перенести на рабочую область действие «Открыть» из группы действий «Excel».

3. Перенести на рабочую область действие «Для» (цикл) из группы действий «Базовые действия».

4. Перенести на рабочую область действия «Сохранить» из группы действий «Excel».

5. Перенести на рабочую область действия «Закрыть» из группы действий «Excel».

6. Заполнить параметры действий, перенесенных на рабочую область:

а. Действие «Открыть»: В строке «Путь к фалу» указать путь к excel-файлу в котором будет проведена работа. 

b. Действие «Для»:
«Начальное значение», «Конечное значение» и «Инкремент».
В параметр «Результат» записать созданную ранее переменную «Номер».

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

с. Для действия «Сохранить». 

В строке «Контекст» указать экземпляр открытого excel-файла.

d. Действие «Закрыть». 
В строке «Контекст» указать экземпляр открытого excel-файла. 

7. В тело цикла поместить действия «Конвертировать данные» из группы «Базовые действий», «Соединить» из группы «Текст» и «Установить значение ячейки» из группы действий «Excel». 

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

1. 1. Действие «Конвертировать данные» 

В строке «Источник» выбрать переменную «Номер».

В строке «Тип» выбрать значение «Строка» из выпадающего цикла.

b. Действие «Соединить».
«Текст 1»  - название столбца, который будет пронумерован.
«Текст 2» - результат действия «Конвертировать данные».

с. Действие «Установить значение ячейки».
В строке «Контекст» указать экземпляр открытого excel-файла.
В строке «Ячейка» указать результат действия «Соединить».
В строке «Значение» указать  переменную «Номер». 

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

Результат: алгоритм прошел по циклу, ячейки в выбранном столбце excel-файла были пронумерованы.