Цикл Для /For-Loop
Группа действий: Базовые действия
Данное действие предназначено для обеспечения заданной итерации по счетчику шагов.
Для добавления в тело цикла последовательности действий необходимо переместить их на контур действия "Цикл Для".


Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры |
Начальное значение | Первоначальное значение счетчика | Robin.Numeric | | Да |
Конечное значение | Конечное значение счётчика | Robin.Numeric | | Да |
Инкремент | Увеличение шага цикла | Robin.Numeric | | Да |
Результаты |
Состояние итератора | Значение счётчика, для использования в текущей итерации цикла | Robin.Numeric | | |
Особые условия использования
Отсутствуют.
Порядок работы с действием цикл «Для»:
1.Выбрать действие «Для» из группы действий «Базовые действия» и перенести в сценарий;

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

3. Заполнить параметры действия:
- Начальное значение (значение, с которого начнется отсчет);
- Конечное значение (значение до которого будет вестись отсчет.);
- Инкремент (число, на которое будет увеличиваться значение итератора);
Пример заполнения:

4. Результат работы цикла: состояние итератора, т.е. значение счетчика для использования в текущей итерации цикла.
Сравнение циклов «Для» и «Для каждого».
Цикл «Для» выполнит работу заданное количество раз. Итератор будет принимать значения от начального заданного значения до конечного с шагом, указанным в поле «Инкремент».
Цикл «Для каждого» последовательно работает с элементами выбранной коллекции. Количество итераций равно количеству элементов в коллекции, выбранной на входе.
Таким образом результат цикла «Для» это число, а «Для каждого» объект.
Пример использования
Задача:
Необходимо завершить работу цикла, если состояние итератора будет равно значению "2".
Решение:
- Добавить цикл "Для".
- Добавить действие "Равно" внутрь цикла "Для".
- Добавить условие "Если" внутрь цикла "Для". В ветвь "Ложь" добавить действие "Сообщение в лог". В ветвь "Истина" добавить действие "Сообщение в лог" и действие "Прервать цикл"
Реализация:
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие цикл "Для".
Настройка действия: - Параметр "Начальное значение". Задаем начальное значение счетчика для цикла.
- Параметр "Конечное значение". Задаем конечное значение счетчика для цикла.
- Параметр "Инкремент". Задаем значение, на которое будет увеличиваться счетчик.

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

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

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

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

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

Кейс «Нумерация строк». Цикл «Для».
Задача: Пронумеровать первые 10 строк в столбце "A" в Excel-файле.
Решение:
- Перенести в рабочее пространство студии действие "Открыть"
- Перенести в рабочее пространство студии действие цикл "Для"
- Перенести в рабочее пространство студии внутрь цикла "Для" действие "Установить значение ячейки"
- Перенести в рабочее пространство студии действие "Сохранить"
- Перенести в рабочее пространство студии действие "Закрыть"
Реализация:
- Перенести в рабочее пространство студии действие "Открыть".
- Параметр "Путь к файлу". Указать путь к Excel-файлу, который необходимо открыть

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

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

- Перенести в рабочее пространство студии действие "Сохранить".
- Параметр "Контекст". Указывать контекст открытого Excel-файла.

- Перенести в рабочее пространство студии действие "Закрыть"
- Параметр "Контекст". Указывать контекст открытого Excel-файла.

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

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

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