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

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

Задача:

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

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

Решение:

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

Реализация:

  • Создать переменную «Строковая переменная» с типом «Строка».
  • Открыть группу действий «Базовые действия».
  • Поместить в рабочее пространство студии действие «Копировать текст в буфер».

Настройка действия:

Параметр «Текст». Выбрать переменную «Строковая переменная», текст из которой будет сохранен в буфера.

  • Запустить робота по кнопке «Запуск» в верхней панели*.

Результат:

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

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

Задача:

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

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

Решение:

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

Реализация:

  • Создать переменную «Result» с типом «Строка».
  • Открыть группу действий «Базовые действия».
  • Поместить в рабочее пространство студии действие «Получить текст из буфера».

Настройка действия:

Параметр «Результат». Выбрать переменную «Result», в которую будет сохранен текст из буфера.

  • Поместить в рабочее пространство студии действие «Ветвление» (см. описание действия «Ветвление / Switch»).
  • Нажать три раза на кнопку «CASE» на действии «Ветвление».
  • Поместить действие «Сообщение в лог» с сообщением «Ветвь №1», «Ветвь №2» и «Ветвь №3» соответствующую номеру ветвь (см. описание действия «Сообщение в лог / Log message»).
  • Запустить робота по кнопке «Запуск» в верхней панели*.

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

Результат:

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

Try-catch / Try-catch

Порядок работы с Try-Catch

  • Выбрать действие «Try-Catch» из группы действий «Базовые действия» и перетащить на рабочую область.

  • В блок «Try» поместить действия, для которых будет выполнено исключение. В блок «Catch» поместить действия, которые будут выполнены, если возникнет исключение, т.е. какая-либо ситуация, когда действие выполнено некорректно, иными словами, возникнет ошибка. Если блок «Catch» не заполнен, то робот продолжит работу сценария, проигнорировав возникшие ошибки.

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

Блоков «Сatch» может быть несколько, тогда для каждого блока будет создан параметр «Исключение для CATCH [Номер блока]». Это нужно, когда для каждой возможной ошибки есть свой вариант действия.

Пример:

Действие «Try-Catch» в сценарии:

Заполненные параметры действия «Try-Catch»:

Таким образом, если веб-элемент не будет найден, то робот выполнит действие из блока «Catch», а если возникнет неизвестная ошибка, то робот выполнит действие из блока «CATCH 2».

  • Заполнить параметры действия «Try-Catch».

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

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

После перенесения всех необходимых типов ошибок, нажать кнопку «Сохранить».

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

Пример заполненных параметров для нескольких блоков «Catch».

Блок Finally

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

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

Выше были рассмотрены общие моменты работы с действием «Try-Catch». Рассмотрим кейс «Погода», где продемонстрирована работа этого действия.

Кейс «Обработка ошибок при работе робота»

Задача:

Роботу необходимо зайти в поисковую систему, сделать запрос «Погода» и получить сегодняшнюю температуру, а затем сохранить ее в excel-файл.

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

Решение:

  • Поместим все действия сценария в блок «Try».
  • В блок «Catch» действие «Сообщение», в котором робот сообщит, что возникла ошибка при работе с браузером.
  • В блок «CATCH 2» поместим действие «Сообщение», которое сообщит, что ошибка произошла в действии группы «Excel».
  • В блоке Finally будет информационное сообщение о том, что робот закончил работу.

Пример заполнения блока «Try»:

Пример заполнения блока «Catch»:

  • Заполним параметры: Выберем типы ошибок, которые могут возникнуть во время работы с действиями группы «Браузеры» для блока «Catch».

И типы ошибок, которые могут возникнуть в результате работы с действиями группы «Excel» из предложенных для блока «CATCH 2».

Результат:

Затем на экране появилось сообщение из блока «Finally».

При работе робота произошла ошибка, анализируя лог в студии, можно увидеть, как робот остановил работу с действиями в блоке «Try», перешел в блок «CATCH 2» и вывел на экран информационное сообщение.

Из-за наличия блока «Try-Cath» робот завершил свою работу без ошибок , несмотря на то, что при открытии файла возникла ошибка.

Ветвление / Switch

Задача:

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

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

Решение:

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

Реализация:

  • Создать переменную «Строковая_переменная1» с типом «Строка», которая будет являться выражением и содержать текст «Red».
  • Открыть группу действий «Базовые действия».
  • Поместить в рабочее пространство студии действие «Ветвление».
  • Нажать три раза на кнопку «CASE» на действии.
  • Настройка действия:

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

Параметр «Условие для Ветки 1». Выбрать результат выражение «Blue», который будет сравниваться со значением в поле «Условия» действия «Ветвление».

Параметр «Условие для Ветки 2». Выбрать результат выражение «Red», который будет сравниваться со значением в поле «Условия» действия «Ветвление».

Параметр «Условие для Ветки 3». Выбрать результат выражение «Black», который будет сравниваться со значением в поле «Условия» действия «Ветвление».

  • Поместить действие «Сообщение в лог» с сообщением «Ветвь №1», «Ветвь №2» и «Ветвь №3» соответствующую номеру ветвь (см. описание действия «Сообщение в лог / Log message»).
  • Запустить робота по кнопке «Запуск» в верхней панели.

Результат:

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

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

Задача:

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

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

Решение:

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

Реализация:

  • Открыть группу действий «Диалоговые окна».
  • Поместить в рабочее пространство студии действие «Вопрос».
  • Настроить действие: в параметр «Вопрос» указать текст: «Остановить работу программы?»
  • Открыть группу действий «Базовые действия».
  • Поместить в рабочее пространство студии действие «Если» (см. описание действия «Если / If»).
  • Настроить действие:

Задать в условие результат действия «Вопрос».

Поместить на ветку «Да» действие «Вывести ошибку».

В параметр «Сообщение» действия «Вывести ошибку» указать текст: «Пользователь запросил остановку программы».

  • Запустить робота по кнопке «Запуск» в верхней панели.
  • Ответить «Да» на вопрос в диалоговом окне.

Результат:

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

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

Задача:

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

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

Решение:

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

Реализация:

  • Создать переменную «Числовая_переменная» с типом «Число», которая будет являться результатом действия «Получить количество строк» и содержать значение «0».
  • Открыть группу действий «Базовые действия».
  • Поместить в рабочее пространство студии действие «Группа действий» и настраиваем его параметры.
  • Открыть группу действий «Exel».
  • Поместить в контур действия «Группа действий «действие «Открыть » и настраиваем его параметры (см. описание действия «Открыть / Open») .
  • Поместить в контур действия «Группа действий «действие «Получить количество строк» и настраиваем его параметры (см. описание действия «Получить количество строк / Get Row number»).
  • Поместить в контур действия «Группа действий «действие «Закрыть » и настраиваем его параметры (см. описание действия «Закрыть / Close»).
  • Запустить робота по кнопке «Запуск» в верхней панели.

Результат:

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

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

Если / If

Задача:

Имеется две числовых переменных. Первая со значением = 10, вторая со значением = 11. Произвести сравнение переменных. Если первая переменная больше или равна второй, то вывести на экран сообщение, если нет, то проиграть звук.

Решение: воспользоваться действием «Если».

Реализация:

  • Перенести на рабочую область и настроить действие «Больше или равно», указав требуемые переменные в параметрах и создать переменную логического типа для указания результата действия.
  • Перенести на рабочую область и настроить действие «ЕСЛИ».

В условии действия указать переменную «Результат сравнения переменных».

Настроить действия «Сообщение» и «Звук».

  • Запустить робота по кнопке «Запуск» в верхней панели.
  • В результате действия «Если» проигран звук.

Изменить координаты точки/Change point coordinates

Задача:

Существует переменная «Координаты» со значениями (625,695). Необходимо изменить ось координат по X= +1, по Y= -9

Решение:

Настроить действие «Изменить координаты точки».

Реализация:

  • Открыть группу «Базовые действия» и перенести на рабочую область действие «Изменить координаты точки», настроить параметры действия:

В поле «Координаты точки» указать переменную с текущими координатами.

Создать числовую переменную со значением +1 и вторую числовую переменную со значением -9.

Создать переменную для новых координат с типом «Координаты точки» и указать ее в результате данного действия.

  • Произвести запуск робота по кнопке «Запустить» в верхней панели.

  • В переменную «Координаты новые» записано измененное значение координат.

Конвертировать данные / Convert data

Задача:

Необходимо конвертировать числовую переменную со значением = 1 в строковую.

Решение:

Воспользоваться действием «Конвертировать данные».

Реализация:

  • Открыть группу «Базовые действия» и перенести на рабочую область действие «Конвертировать данные».

  • Настроить параметры действия:

  • Запустить робота при помощи кнопки «Запуск» в верхней панели.

  • В переменную «Строковая» записано требуемое значение:

Ожидать / Sleep

Задача:

Установить ожидание на 2000 миллисекунды в процессе выполнения сценария.

Решение:

Добавить действие «Ожидать» в сценарий.

Реализация:

  • Создать переменную «время» с типом «Число», которая будет содержать значение 2000.
  • Разместить на рабочую область действие «Ожидать» и настроить параметр действия.
  • Запустить робота по кнопке «Запуск» в верхней панели. При выполнении действия «Ожидать» будет установлено время ожидания 2000 миллисекунды.

Получить координаты центра области/Get area center coordinates

Задача:

Необходимо получить координаты центра выбранной области.

Решение:

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

Реализация:

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

  • Создать переменную с типом «Область» и выбрать координаты, нажав на кнопку PickArea, затем сохранить сделанные изменения.

  • Указать в параметрах действия в поле «Область» созданную ранее переменную с координатами области.

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

Результат:

Робот отработал успешно, получены координаты центра области.

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

Задача:

Существует переменная с типом «Число», содержащая значение «1». Необходимо завершить работу цикла пока значение переменной не будет равно или больше 3.

Решение:

  • Добавить цикл «Пока».
  • Присвоить значение переменной.

Реализация:

  • Создать переменную «Переменная1» с типом «Объект», которая будет являться частью условия и содержать значение «1» и переменную «Переменная2» с типом объект, значением которого станет значение переданное на вход действия («Входное значение»).
  • Открыть группу действий «Базовые действия».
  • Поместить в рабочее пространство студии действие «Цикл «Пока» и настроить его. (см. действие Пока/ Loop while)
  • Поместить в рабочее пространство студии действие «Присвоить значение переменной».

Настройка действия:

  • Запустить робота по кнопке «Запуск» в верхней панели.
  • Алгоритм, согласно логам, прошел по циклу и был завершен после установки переменной значения «3».

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

Задача:

Сгенерировать случайное целое число от 1 от 10000 и записать результат в переменную.

Решение:

Настроить действие «Сгенерировать случайное число».

Реализация:

  • Открыть группу действий «Базовые действия» и перетащить на рабочую область действие «Сгенерировать случайное число».

  • Настроить параметры действия:

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

  • Робот сгенерировал случайное целое число в заданном интервале.

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

Задача: сделать скриншот активного окна в формате JPEG и поместить скрин в папку.

Решение: воспользоваться действием «Сделать скриншот».

Реализация:

  • Перенести на рабочую область действие «Сделать скриншот» и настроить его параметры: указать папку в которую будет сохранен скрин, имя файла, формат - JPEG, тип - активное окно.
  • Запустить робота по кнопке «Запуск» в верхней панели.
  • В указанную папку сохранен сделанный скриншот.

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

Задача:

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

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

Решение:

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

Реализация:

  • Создать переменную «Строковая_переменная1» с типом «Строка», которая будет являться выражением и содержать текст «Red».
  • Открыть группу действий «Базовые действия».
  • Поместить в рабочее пространство студии действие «Ветвление».
  • Нажать два раза на кнопку «CASE» на действии «Ветвление» и получить три рабочие ветви. Ветвь Default можно удалить.
  • Настроить параметры действия «Ветвление» таким образом, чтобы текст «Red» соответствовал второй ветви (см. описание действия «Ветвление / Switch»).
  • Поместить действия «Сообщение в лог» в каждую ветвь и настраиваем параметры:

Параметр «Сообщение» для действия «Сообщение в лог» первой ветви. Указать текст «Ветвь №1», для вывода в лог-файл сообщения.

Параметр «Сообщение» для действия «Сообщение в лог» второй ветви. Указать текст «Ветвь №2», для вывода в лог-файл сообщения.

Параметр «Сообщение» для действия «Сообщение в лог» третьей ветви. Указать текст «Ветвь №3», для вывода в лог-файл сообщения.

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

Результат:

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

Цикл Для /For-Loop

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

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

  • Заполнить тело цикла необходимыми действиями;

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

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

Начальное значение (значение, с которого начнется отсчет);

Конечное значение (значение до которого будет вестись отсчет.);

Инкремент (число, на которое будет увеличиваться значение итератора);

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

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

Кейс «Работа с циклом «Для»

Задача:

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

Решение:

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

Реализация:

  • Открываем группу действий «Базовые действия».
  • Помещаем в рабочее пространство студии действие «Цикл Для».

Настройка действия:

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

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

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

Результат «Состояние итератора». Выбираем переменную «ITERATION_ACTUAL_STATE», в которую будет помещено значение счетчика для каждого шага цикла.

  • Помещаем в рабочее пространство студии действие «Если» (см. описание действия «Если»).
  • Задаем условие «ITERATION_ACTUAL_STATE == 2».
  • Помещаем в рабочее пространство действия «Если» ветви «Нет» действие «Сообщение в лог» (см. описание действия «Сообщение в лог / Log message»).
  • Помещаем в рабочее пространство действия «Если» ветви «Нет» действие «Прервать цикл» (см. описание действия «Прервать цикл / Break the loop»).
  • Помещаем в рабочее пространство студии действие «Сообщение в лог» (см. описание действия «Сообщение в лог / Log message»).
  • Запускаем робота по кнопке «Запуск» в верхней панели.

Результат:

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

Кейс «Нумерация строк в excel-файле»

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

Решение:

  • Создать переменную «Номер». Тип переменной «Число».
  • Перенести на рабочую область действие «Открыть» из группы действий «Excel».
  • Перенести на рабочую область действие «Для» (цикл) из группы действий «Базовые действия».
  • Перенести на рабочую область действия «Сохранить» из группы действий «Excel».
  • Перенести на рабочую область действия «Закрыть» из группы действий «Excel».
  • Заполнить параметры действий, перенесенных на рабочую область:

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

Действие «Для»:

«Начальное значение», «Конечное значение» и «Инкремент».

В параметр «Результат» записать созданную ранее переменную «Номер».

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

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

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

Действие «Закрыть»:

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

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

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

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

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

Действие «Соединить»:

«Текст 1» - название столбца, который будет пронумерован.

«Текст 2» - результат действия «Конвертировать данные».

Действие «Установить значение ячейки»:

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

В строке «Ячейка» указать результат действия «Соединить».

В строке «Значение» указать переменную «Номер».

  • Запустить робота по кнопке «Старт» в верхней панели.

Результат:

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

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

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

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

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

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

Порядок работы с циклом «Для каждого»:

  • Выбрать действие «Для каждого» из группы действий «Базовые действия» и перенести в сценарий;
  • Заполнить тело цикла необходимыми действиями;

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

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

Коллекция (список значений, которые будут обработаны в цикле)

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

  • Результат работы цикла: объект, в который будет помещен каждый элемент коллекции во время выполнения итерации.

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

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

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

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

Кейс 1 «Цикл «Для каждого»

Задача:

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

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

Решение:

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

Реализация:

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

Настройка действия:

  • Параметр «Коллекция». Выбираем коллекцию «Коллекция_значений», проход по объектам которой будет осуществляться в цикле.
  • Параметр «Объект». Выбираем переменную «ITERATION_ACTUAL_STATE», в которую будет помещен каждый элемент коллекции.
  • Поместить в рабочее пространство студии действие «Если» (см. описание действия «Если»).
  • Поместить в рабочее пространство действия «Если» ветви «Нет» действие «Сообщение в лог» (см. описание действия «Сообщение в лог»).
  • Поместить в рабочее пространство действия «Если» ветви «Нет» действие «Прервать цикл» (см. описание действия «Прервать цикл»).
  • Поместить в рабочее пространство студии действие «Сообщение в лог» (см. описание действия «Сообщение в лог»).
  • Запустить робота по кнопке «Запуск» в верхней панели.

Результат:

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

Кейс 2 «Цикл «Для каждого»

Задача:

В папке находятся файлы с расширением .xls(x) и .docx. Необходимо создать папки с названием расширения и распределить файлы по папкам.

Решение:

  • На рабочую область перенести действия «Получить содержимое папки» и «Для каждого».
  • Заполнить параметры действий.
  • Действие «Получить содержимое папки».

В строке «Папка» указать путь до папки с файлами, которые необходимо рассортировать.

В поле «Тип объектов» указать значение «только файлы».

  • Действие «Для каждого».

В строке «Коллекция» указать результат выполнения действия «Получить содержимое папки».

Пример:

  • В тело цикла поместить следующие действия в указанном порядке:

«Получить информацию о файле»;

«Извлечь с позиции»;

«Найти папку»;

«Получить длину»;

«Если»

  • На ветвь «Истина» поставить действия:

«Получить значение по индексу»;

Конвертировать данные;

«Переместить файл»;

  • На ветвь «Ложь» установить действия:

«Создать новую папку»;

«Переместить файл»;

  • Заполнить параметры действий.
  • Для действия «Получить информацию о файле»:

Параметр «Файл» - ссылка на объект, обрабатываемый в момент итерации цикла.

Параметр «Свойство» - «Тип».

  • Для действия «Извлечь с позиции»:

Параметр «Исходный текст» - результат действия «Получить информацию о файле».

Параметр «Позиция» - 1.

Параметр «Длина» - если данный параметр не заполнен, то текст извлекается с заданной позицией до конца.

  • Для действия «Найти папку»:

Параметр «Папка для поиска» - путь до папки, где храниться подпапка для сортировки файлов.

Параметр «Шаблон поиска» - результат действия «Извлечь с позиции».

  • Для действия «Получить длину»:

Параметр «Коллекция или массив» - результат действия «Найти папку».

  • Для действия «Если»:

С помощью инструмента построения выражения в параметр условия записать логический оператор «Больше чем», где первый операнд – результат действия «Получить длину», а второй – 0.

  • Для действия «Получить значение по индексу»:

Параметр «Коллекция» - результат действия «Найти папку».

Параметр «Индекс» - 0.

  • Для действия «Конвертировать данные»:

Параметр «Источник» - результат действия «Путь к папке».

Параметр «Тип» - путь к папке.

  • Для действия «Переместить файл»:

Параметр «Файл» - ссылка на объект, обрабатываемый в момент итерации цикла.

Параметр «Папка назначения» - результат действия «Конвертировать данные».

  • Для действия «Создать новую папку»:

Параметр «Родительская папка» - путь до папки, где , где храниться подпапка для сортировки файлов.

Параметр «Имя» - результат действия «Извлечь с позиции».

  • Для действия «Переместить файл»:

Параметр «Файл» - ссылка на объект, обрабатываемый в момент итерации цикла.

Параметр «Папка назначения» - результат действия «Создать новую папку».

Результат:

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

Цикл «Пока»/ Loop while

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

  • Выбрать действие «Пока» из группы действий «Базовые действия» и перенести в сценарий.
  • Заполнить тело цикла (блок внутри цикла, где прописывается алгоритм для работы робота) необходимыми действиями;

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

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

Условие (критерий, по которому будет приниматься решение о продолжении или прекращении работы цикла).

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

Если условие заполняется посредством инструмента построения выражений, то оно отобразиться в разделе «Условие» внутри цикла.

Инструмент построения выражений:

При заполнении чек-бокса условие цикла считается равным True. Если чек-бокс не заполнен и не указано иное условие, то условие цикла считается равным False.

Пример цикла с условием, заполненным с помощью инструмента построения выражений:

Кейс «Поиск дня с отрицательной температурой»

Задача:

В excel-файле записаны дата и температура за это число. Необходимо найти первый день в списке, когда температура стала отрицательной.

Решение:

  • Создать переменные «Счетчик» и «Значение», тип переменных – число.
  • На рабочую область перенести действия «Открыть» и «Получить данные из столбца» (группа «Excel»), действие «Пока» (группа «Базовые действия»), «Сохранить» и «Закрыть» (группа «Excel»).
  • Заполнить параметры действий:

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

  • Действие «Получить значение из столбца».

Указать контекст и название столбца с температурными данными.

  • Действие «Пока».

С помощью инструмента построения выражений записать условие «Переменная Значение больше 0».

Пример:

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

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

  • Действие «Закрыть».

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

  • В тело цикла добавить действие «Получить значение по индексу» (группа действий «Коллекции») и «Сложение» (группа действий «Операторы»).
  • Заполнить параметры этих действий:
  • Действие «Получить значение».

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

В строке «Индекс» указать переменную «Счетчик».

В параметре «Результат» записать переменную «Значение».

  • Действие «Сложение».

Первый слагаемое – переменная «Счетчик».

Второе слагаемое – 1.

Результат – переменная «Счетчик».

Результат:

Алгоритм начнет перебирать значения коллекции в цикле и прекратит работу, как только встретит первое отрицательное число. Оно будет записано в переменную «Значение».

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

Задача:

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

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

Решение:

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

Реализация:

  • Создать переменную «Числовая_переменная2» с типом «Число», которая будет являться частью условия «Если» и содержать значение «0».
  • Создать переменную «Коллекция» с элементами»(1988, 8, 2, 4)», проход по которым будет осуществляться в цикле.
  • Открыть группу действий «Базовые действия».
  • Поместить в рабочее пространство студии действие «Цикл «Для каждого» (см. описание действия «Цикл «Для каждого» / Loop For Each»«).
  • Поместить в рабочее пространство студии действие «Если» (см. описание действия «Если / If»).
  • Поместить в рабочее пространство действия «Если» ветви «Ложь» действие «Сообщение в лог» (см. описание действия «Сообщение в лог / Log message»).
  • Поместить в рабочее пространство действия «Если» ветви «Ложь» действие «Прервать цикл».
  • Поместить в рабочее пространство студии действие «Сообщение в лог» (см. описание действия «Сообщение в лог / Log message»).
  • Запустить робота по кнопке «Запуск» в верхней панели.

Результат:

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

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

Задача:

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

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

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

Решение:

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

Реализация:

  • Создать переменную «Числовая_переменная2» с типом «Число», которая будет являться частью условия «Если» и содержать значение «0».
  • Создать переменную с типом «Коллекция» и элементами»(1988, 8, 2, 4)», проход по которым будет осуществляться в цикле.
  • Открыть группу действий «Базовые действия».
  • Поместить в рабочее пространство студии действие «Цикл «Для каждого» (см. описание действия «Цикл Для /For-Loop»«).
  • Поместить в рабочее пространство студии действие «Если» (см. описание действия «Если / If»).
  • Поместить в рабочее пространство действия «Если» ветви «Ложь» действие «Сообщение в лог» (см. описание действия «Сообщение в лог / Log message»).
  • Поместить в рабочее пространство действия «Если» ветви «Ложь» действие «Прервать цикл» (см. описание действия «Прервать цикл / Break the loop»).
  • Поместить в рабочее пространство действия «Если» ветви «Истина» действие «Продолжить цикл».
  • Поместить в рабочее пространство студии действие «Сообщение в лог» (см. описание действия «Сообщение в лог / Log message»).
  • Запустить робота по кнопке «Запуск» в верхней панели.

Результат:

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

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

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

Порядок работы с «Циклом с постусловием»:

  • Выбрать действие «Цикл с постусловием» из группы действий «Базовые действия» и перенести в сценарий.
  • Заполнить тело цикла необходимыми действиями.

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

  • Заполнить параметр действия (условие).

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

Если условие заполняется посредством инструмента построения выражений, то оно отобразиться в разделе «Условие» внутри цикла.

Пример цикла с постусловием, где условие заполнено с помощью инструмента построения выражений:

Сравнение циклов «Пока» и цикла с «Постусловием»

Оба цикла работают до тех пор, пока результат условия равен «True». Однако в цикле «Пока» проверка действия происходит перед началом выполнения цикла, т.е. цикл может отработать 0 раз и более.

Проверка условия в действии «Цикл с постусловием» происходит после выполнения действий в теле цикла, т.е. цикл отработает минимум один раз.

Кейс «Поиск файла». «Цикл с постусловием»

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

Решение:

  • Создать переменную «Счетчик», тип переменной – число.
  • Создать переменную «Значение», тип переменной – объект.
  • На рабочую область перенести действия «Получить содержимое папки» (группа действий «Файловая система»), «Цикл с постусловием» (группа действий «Базовые действия»).
  • Заполнить параметры действий:

Для действия «Получить содержимое папки»:

В параметр «Папка» указать путь до папки с подпапками.

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

Для действия «Цикл с постусловием»:

В параметр условие с помощью инструмента построение выражений записать условие «Длинна коллекции, полученной в результате действия «Найти файл» равно 0».

Пример:

  • В тело цикла добавить действия «Получить значение по индексу» (группа действий «Коллекции»), «Конвертировать данные» (группа действий «Базовые действия»), «Найти файл» (группа действий «Файловая система») и «Сложение» (группа действий «Операторы»).
  • Заполнить параметры действий:

Для действия «Получить значение по индексу»:

Параметр «Коллекция» - результат действия «Получить содержимое папки».

Параметр «Индекс» - переменная «Счетчик».

Параметр «Результат» - переменная «Значение».

Для действия «Конвертировать данные»:

Параметр «Источник» - результат действия «Получить значение по индексу».

Параметр «Тип» - путь до папки.

Для действия «Найти файл»:

Параметр «Папка для поиска» - результат действия «Конвертировать данные».

Параметр «Шаблон» - название искомого файла.

Для действия «Сложение»:

Первое слагаемое – переменная «Счетчик».

Второе слагаемое – 1.

Результат – переменная «Счетчик».

Результат:

Алгоритм пройдет по циклу до тех пор, пока не будет найден искомый файл. Путь до папки с этим файлом будет сохранен в переменную «Значение».

Кодировать в Base64/Encode in Base64

Описание Действие кодирует данные указанного файла в Base64.

Иконка

Параметры

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

Выпадающий список » Тип данных «. - Тип данных, которые будут кодироваться.

Поле » Файл » - Путь к файлу, данные которого будут кодироваться.

Поле » Строка » - Строка, которая будет кодироваться».

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

Поле « Результат » - Строка с кодированными данными.

Настройки

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

  • 1.Для кодирования пользователю необходимо указать тип данных для кодировки: файл или строку.
  • 2.Если пользователь выбрал тип данных, но не указал выбранный тип (файл/строка), то действие отобразит ошибку: «Некорректно заполнены входные параметры».
  • 3.Результатом действия является строка с кодированными данными.
  • 4.Существует ограничение на размер файла - 10МБ. При указании файла большего размера действие выдает ошибку в виде сообщения: «Размер файла больше допустимого».

Примеры использования Задача 1:

Необходимо закодировать данные, передаваемые во входном файле в Base64.

Решение:

  • Установить действие «Кодировать в Base64» на рабочую область.
  • Корректно заполнить параметры. «Тип данных» - Файл,
  • Запустить робота.

Реализация:

  • 1.Выбрать файл, который необходимо закодировать в Base64.

  • 2.Открыть группу действий «Базовые действия».

  • 3.Поместить в рабочее пространство студии действие «Кодировать в Base64».

  • 4.Нажать на действие.

  • 5.Настройка действия:

    • Параметр «Тип данных». Выбрать в выпадающем списке «Файл».
    • В поле «Файл» указать путь к папке, где находится файл.

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

Результат: Действие выдало результат в виде строки с кодированными в Base64 данными.

Задача 2

1.При некорректном задании параметров, например, при типе данных «Строка», поле «Строка» оставить незаполненным.

2.Запустить робота.

Результат

Действие кодировало указанную строку и вернуло строку с кодированными данными. Указанный файл действие не трогало.

Задача 3

Повторить задачу 2, указав «Тип данных» - Файл. В результате действие не будет трогать указанную строку.

Декодировать из Base64 / Decode from Base64

Описание

Действие декодирует указанную строку данных из Base64 в файл.

  • В результате возвращается файл с декодированными данными Base64.
  • Для декодирования необходимо использовать код, закодированный в Base64.
  • Для декодирования необходимо указать путь к файлу и имя файла, в котором будут находиться декодированные данные.

Иконка

Параметры

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

Поле » Данные » - Строка с закодированными в Base64 данными.

Поле » Имя файла » - Имя файла (с расширениями или без), в котором находятся декодированные данные.

Поле » Путь к папке » - Путь к почте, куда сохраняется файл с декодированными данными.

Чекбокс » Перезаписать » - Если значение «Истина», файл перезаписывается в международный файл с таким же именем. Если значение «Ложь», то в случае подачи файла с таким же именем робот выбрасывает ошибку».

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

Путь к файлу с декодированными данными. Тип данных - Путь к файлу.

Настройки

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

  1. При указании недопустимых в названии имени файла символов ( / : * ? » < > | + пробел) робот выдаст ошибку: «В файле введен некорректный символ: / : * ? «< > | + пробел».
  2. Если в имени файла будет указано расширение (в конце имени поставит точку и напишет расширение), то результатом будет файл с указанием расширения.
  3. Если не будет указано расширение имени файла, то получится файл без расширения.
  4. Добавлена возможность перезаписать файл: Если значение параметра «true», файл перезаписывается в случае подачи файла с таким же именем. Если значение параметра «false», то в случае сохранения файла с таким же именем робот выдает ошибку: «Файл с таким именем уже существует».
  5. Если действие не сможет декодировать данные, то будет выдана ошибка: «Не удалось декодировать данные».

Примеры использования Задача 1:

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

Решение:

  1. Установить действие «Декодировать из Base64» на рабочую область.
  2. Корректно заполнить параметры. «Данные» - строка в Base64», «Имя файла» имя с допустимыми символами без расширения.
  3. Запустить робота.

Реализация:

Предусловие: предварительно закодируйте файл в Base64, как было описано в Задаче 1 действия «Кодировать в Base64».

  1. Выбрать файл, который необходимо декодировать в Base64.
  2. Открыть группу действий «Базовые действия».
  3. Поместить в рабочее пространство студии действие «Декодировать из Base64».
  4. Нажать на действие.
  5. Настройка действия:
  • Параметр «Имя файла». Набрать имя файла с расширением или без расширения.
  • В поле «Путь к папке» указать путь к папке, где находится файл. Для этого необходимо нажать на 3 точки,выбрать квадратик с зеленой стрелочкой, при этом откроется модальное окно, в котором неоходимо выбрать место, где хранится файл.
  1. Запустить робота по кнопке «Запуск» в верхней панели.

Результат:

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

Задача 2

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

Результат

Действие не перезапишет файл.

Задача 3

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

Результат

Действие перезапишет файл.