История страницы
| Оглавление | ||
|---|---|---|
|
Группа действий / Sequence
...
Данное действие предназначено для группировки элементов/действий в отдельный блок.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Идентификатор | Sequence ID | Идентификатор последовательности действий. !! Данный параметр не отображается и назначается системой автоматически. | Robin.Internal.SequenceId | Нет Последовательность может быть пустой. | |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Открыть excel-файл, посчитать количество строк в нем и закрыть файл.
...
Алгоритм прошел по всем действиям группы и записал значение в переменную "Числовая_переменная".
Присвоить значение / Assign value
...
Присваивает результату действия указанное значение.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Значение | Value | Значение, которое необходимо присвоить результату. Передается на выход действия в неизменном виде. | Robin.Object | Шаг_счетчика + 1 * через тулзу Выражение | Да |
| Результаты | |||||
| Результат | Result | Переменная, которой будет присвоено указанное значение. Тип данных переменной должен совпадать с типом данных значения. | Robin.Object | Шаг_счетчика | |
Особые условия использования
При помощи данного действия можно присвоить значение переменной во время выполнения сценария.
Для дальнейшей корректной работы с такой переменной ее тип данных и тип данных в параметре "Значение" должны совпадать.
Сгенерировать случайное число / Get random number
...
Данное действие предназначено для получения случайного числа.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Минимум | Minimum | Наименьшее возможное значение. По умолчанию используется граница типа. | Robin.Numeric | 1 | Нет |
| Максимум | Maximum | Наибольшее возможное значение. По умолчанию используется граница типа. | Robin.Numeric | 100 | Нет |
| Целое | Integer | Будет сгенерировано целое число. | Robin.Boolean | true | Нет |
| Результаты | |||||
| Результат | Result | Сгенерированное случайное число. | Robin.Numeric | ||
Особые условия использования
Отсутствуют.
Конвертировать данные / Convert data
...
Данное действие предназначено для преобразования переменной одного типа данных в другой.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Источник | Source | Переменная, значение которой будет конвертироваться. | Robin.Object | Числовая_переменная | Да |
| Тип | Data type | Тип данных, в который необходимо конвертировать значение параметра "Источник" Выпадающий список:
| Robin.String | Да | |
| Результаты | |||||
| Результат | Result | Переменная выбранного типа, в которую будет записано конвертированное значение из поля "Источник". Если тип неконвертируемый будет выводиться ошибка. | Robin.Object | Строковая_переменная | Нет |
Особые условия использования
Отсутствуют.
Сделать скриншот / Take a screenshot
...
Данное действие предназначено для скриншота экрана.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Папка | Folder | Папка, где необходимо сохранить скриншот. | Robin.FolderPath | C:\Users\RLABUTIN\Documents\RobinStudio\1.1) Base action (RUS)\Base action (RUS) | Да |
| Имя файла | File name | Имя файла сохранения для скриншота. | Robin.String | Скрин1 | Да |
| Формат | Format | Формат, в котором скриншот будет сохранен. Выпадающий список. Доступны значения:
| Robin.String | JPG | Да |
| Тип | Type | Типы скриншота области. Выпадающий список. Доступны значения:
По умолчанию значение равно "FullScreen". | Robin.String | Координаты | Да |
| Область | Area | Размер и положение области для скриншота. Пользователь имеет возможность вручную выделить область экрана или заполнить значения:
В случае ручного выделения Система автоматически заполнит эти значения данными выбранной области. | Robin.RectangleLocation | Нет | |
| Результаты | |||||
| Результат | Result | Путь до сохраненного скриншота. Будет сохранен в выбранной папке в формате "<<Имя файла>>.<<Формат>>" | Robin.Image | C:\Users\RLABUTIN\Documents\RobinStudio\1.1) Base action (RUS)\Base action (RUS)\Скрин1.jpg | |
Особые условия использования
Отсутствуют.
Вывести ошибку / Throw exception
...
Данное действие предназначено для принудительного завершения работы робота, в связи с тем, что алгоритм на этом шаге продолжаться не должен.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Сообщение | Message | Текст, который будет выведен в лог-файл сообщения. Если параметр не заполнен будет выведено: "Неизвестная ошибка". | Robin.String | Возникла ошибка! | Нет |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Необходимо получить ответ пользователя на вопрос о завершении программы.
...
- Открываем группу действий "Диалоговые окна".
- Помещаем в рабочее пространство студии действие "Вопрос".
- Настройка действия:
- В параметр "Вопрос" указываем текст: "Остановить работу программы?"
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0Если").
- Настройка действия:
- Задаем в условие результат действия "Вопрос".
- Помещаем на ветку "Да" действие "Вывести ошибку".
В параметр "Сообщение" действия "Вывести ошибку" указываем текст: "Пользователь запросил остановку программы".
- Запускаем робота по кнопке "Запуск" в верхней панели.
- Отвечаем "Да" на вопрос в диалоговом окне.
...
Работа программы была завершена, в лог выведено сообщение "Пользователь запросил остановку программы".
Перехват ошибок / Try-catch
...
Данное действие предназначено для обработки исключений в выбранных действиях.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Блок Try | Try clause | Действия для выполнения, во время исполнения которых может произойти исключение. !! Данный параметр не отображается и назначается системой автоматически. | Robin.Internal.SequenceId | Да Действия в блоке должны быть | |
| Блок Catch | Catch clause | Действия для обработки возникшего исключения. Таких блоков может быть несколько, тогда будет создан параметр "Исключения для CATCH <номер последовательности>" для каждого из добавленных блоков. !! Данный параметр не отображается и назначается системой автоматически. | Robin.Internal.SequenceId | Нет Действий в блоке может не быть | |
| Исключения | Exceptions | Список исключений, для обработки которых предназначена соответствующая последовательность Catch. В тулзе к выбору предложены следующие типы:
Последовательностей CATCH может быть создано несколько, тогда для каждой из добавленных будет создан параметр "Исключения для CATCH <номер последовательности>" . "Неизвестная ошибка" - это ошибка, которая не принадлежит к одному из перечисленных определенных типов. "Любая ошибка" - это любая ошибка, определенного или неизвестного типа. | Robin.Collection | Да | |
| Блок Finally | Finally clause | Действия для выполнения в любом случае. | Robin.Internal.SequenceId | Нет Блока может не быть | |
| Результаты | |||||
| Ошибка | Error | Ошибка возникшая в ходе выполнения блока Try | Robin.Exeception | ||
...
Список эксепшенов с описанием применимости
Если / If
...
Данное действие предназначено для определения какой оператор будет выполняться при выполнении условия, заданного логическим выражением.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Условие | Condition | Логическое выражение, результат выполнения которого является условием перехода по веткам "Да" и "Нет". | Robin.Boolean | true | Да |
| Истина | True | Последовательность при выполнении условия. !! Данный параметр не отображается и назначается системой автоматически. | Robin.Internal.SequenceId | Нет Действий в последовательности может не быть | |
| Ложь | False | Последовательность при невыполнении условия. !! Данный параметр не отображается и назначается системой автоматически. | Robin.Internal.SequenceId | Нет Действий в последовательности может не быть | |
Особые условия использования
Условие "Если" может иметь только две ветви. На каждой ветви уже указан результат выражения ("Да"/ "true") и "Нет"/ "false"), по которому будет осуществлять переход на данную ветвь. Для добавления в тело ветви последовательности действий необходимо переместить их на контур соответствующего действия.
Пример использования
Задача:
Существуют переменные с типом "Массив чисел" и "Число", содержащие соответственно значение "(1988, 8, 2, 4)" и "0".
...
- Создаем переменную "Числовая_переменная2" с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
- Создаем переменную "Массив_чисел" с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле.
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие "Цикл "Для каждого" (см. описание действия "Цикл "Для каждого"").
- Помещаем в рабочее пространство студии действие "Если".
Настройка действия:- Параметр "Условие". Указываем логическое выражение "Числовая_переменная2!=2", частью которого является переменная "Числовая_переменная2".
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0Прервать цикл").
- Параметр "Условие". Указываем логическое выражение "Числовая_переменная2!=2", частью которого является переменная "Числовая_переменная2".
- Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Запускаем робота по кнопке "Запуск" в верхней панели.
...
Алгоритм прошел по циклу и был прерван после установки переменной значения "2".
Сообщение в лог / Log message
...
Данное действие предназначено для отправки в лог-файл сообщения.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Сообщение | Message | Текст, который будет выведен в лог-файл сообщения. | Robin.String | Текстовое сообщение | Да |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Существует переменная с типом "Строка", содержащая значение "Red".
...
- Создаем переменную "Строковая_переменная1" с типом "Строка", которая будет являться выражением и содержать текст "Red".
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие "Ветвление" .
- Нажимаем два раза на кнопку "
" на действии "Ветвление" и получаем три рабочие ветви. Ветвь Default можно удалить. - Настраиваем его параметры действия "Ветвление" таким образом, чтобы текст "Red" соответствовал второй ветви (см. описание действия "Базовые действия 2.0Ветвление").
- Помещаем действия "Сообщение в лог" в каждую ветвь и настраиваем параметры:
- Параметр "Сообщение" для действия "Сообщение в лог" первой ветви. Указываем текст "Ветвь №1", для вывода в лог-файл сообщения.
- Параметр "Сообщение" для действия "Сообщение в лог" второй ветви. Указываем текст "Ветвь №2", для вывода в лог-файл сообщения.
- Параметр "Сообщение" для действия "Сообщение в лог" третьей ветви. Указываем текст "Ветвь №3", для вывода в лог-файл сообщения.
- Параметр "Сообщение" для действия "Сообщение в лог" первой ветви. Указываем текст "Ветвь №1", для вывода в лог-файл сообщения.
- Запускаем робота по кнопке "Запуск" в верхней панели.
...
Алгоритм прошел по всем шагам, перешел по ветви№2 и вывел в лог сообщение "Ветвь №2".
Ожидать / Sleep
...
Данное действие предназначено для установки ожидания на заданное время в момент выполнения сценария.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Время ожидания | Sleep time | Время ожидания перехода алгоритма на следующий шаг. Указывается в миллисекундах. | Robin.Numeric | 1000 | Да |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Существует массив чисел, содержащий значения "(1988, 8, 2, 4)".
...
- Создаем переменную "Числовая_переменная" с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
- Создаем переменную "Массив_чисел" с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле..
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие "Цикл "Для каждого" (см. описание действия "Цикл "Для каждого"").
- Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0Если").
- Параметр "Условие". Указываем логическое выражение "Числовая_переменная != 2", частью которого является переменная "Числовая_переменная".
- Помещаем в рабочее пространство действия "Если" ветви "Да" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0Прервать цикл").
- Помещаем в рабочее пространство действия "Если" ветви "Да" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Ожидать".
Настройки действия:- Параметр "Время ожидание". Вводим в поле значение "1000"
- Параметр "Время ожидание". Вводим в поле значение "1000"
- Параметр "Условие". Указываем логическое выражение "Числовая_переменная != 2", частью которого является переменная "Числовая_переменная".
- Запускаем робота по кнопке "Запуск" в верхней панели.
...
При переходе на ветвь "Нет" время ожидания перехода алгоритма на следующий шаг составило 1 секунду.
Ветвление / Switch
...
Данное действие предназначено для выбора выполнения одного раздела ветвления из списка вариантов, сравнивая их с выражением соответствия.
...
Для добавления ветки перехода по умолчанию необходимо нажимать на кнопку "
", расположенной на самом действии.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Выражение выбора | Expression | Значение для выбора выполняемой ветки. | Robin.String | Нужная_переменная | Да |
Условие для Ветки*, где "*" - номер ветки | Branch* condition, где "*" - номер ветки | Значение, которое будет сравниваться со значением в поле "Условие". При совпадении будет выполняться соответствующая этому значению ветка. Заполняется для каждой созданной ветви ветвления, кроме ветви по умолчанию. Веток может быть создано несколько. По умолчанию создается 2 ветки - минимально возможное количество. Если две ветви содержат одинаковое условие, то действие завершится ошибкой. | Robin.String | Строковый текст | Да |
| Ветка*, где "*" - номер ветки | Branch*, где "*" - номер ветки | Последовательность действий, которая будет выполнена, если удовлетворяется условие. !! Данный параметр не отображается и назначается системой автоматически. | Robin.Internal.SequenceId | Да Действия в последовательности должны быть | |
| Ветка по умолчанию | Default branch | Последовательность действий, которая будет выполнена, если не удовлетворяется ни одно условие. !! Данный параметр не отображается и назначается системой автоматически. Ветка необязательная, создается по желанию пользователя. | Robin.Internal.SequenceId | ||
Особые условия использования
При добавления ветки перехода по умолчанию, данная ветка будет исполнена, если условие не совпало в остальных ветках.
...
- Создаем переменную "Строковая_переменная1" с типом "Строка", которая будет являться выражением и содержать текст "Red".
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие "Ветвление".
- Нажимаем три раза на кнопку "" на действии.
- Настройка действия:
- Параметр "Условие". Выбираем переменную "Строковая_переменная1", значение которой будет проверяться на соответствие условиям.
- Параметр "Условие для Ветки 1". Выбираем результат выражение "Blue", который будет сравниваться со значением в поле "Условия" действия "Ветвление".
- Параметр "Условие для Ветки 2". Выбираем результат выражение "Red", который будет сравниваться со значением в поле "Условия" действия "Ветвление".
- Параметр "Условие для Ветки 3". Выбираем результат выражение "Black", который будет сравниваться со значением в поле "Условия" действия "Ветвление".
- Помещаем действие "Сообщение в лог" с сообщением "Ветвь №1", "Ветвь №2" и "Ветвь №3" соответствующую номеру ветвь (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Запускаем робота по кнопке "Запуск" в верхней панели.
...
Алгоритм прошел по ветви№2 и вывел сообщение в лог "Ветвь №2".
Копировать текст в буфер / Copy text into clipboard
...
Данное действие предназначено для сохранения текста в буфер.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Текст | Text | Переменная, которая будет сохранена в буфер. | Robin.String | Строковая переменная | Да |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Существует переменная с типом "Строка".
...
Текст из переменной записан в буфер
Получить текст из буфера / Get text from clipboard
...
Данное действие предназначено для сохранения текста из буфера в переменную типа "Строка".
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Результаты | |||||
| Результат | Result | Переменная, в которую будет сохранен текст из буфера. При неудаче извлечения значения из буфера в результат будет сохранена пустая строка. | Robin.String | Строковая_переменная | |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Существует переменная с типом "Строка".
...
- Создаем переменную "Result" с типом "Строка".
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие "Получить текст из буфера".
Настройка действия:- Параметр "Результат". Выбираем переменную "Result", в которую будет сохранен текст из буфера.
- Помещаем в рабочее пространство студии действие "Ветвление" (см. описание действия "Базовые действия 2.0Ветвление").
- Нажимаем три раза на кнопку "" на действии "Ветвление".
- Помещаем действие "Сообщение в лог" с сообщением "Ветвь №1", "Ветвь №2" и "Ветвь №3" соответствующую номеру ветвь (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Запускаем робота по кнопке "Запуск" в верхней панели*.
...
Алгоритм прошел по ветви №2 после получения данных из буфера.
Прервать цикл / Break the loop
...
Данное действие предназначено для прерывания текущей итерации цикла/ветвления и выхода из цикла/ветвления. Действия в цикле, установленные после действия "Продолжение цикла", завершены не будут.
Настройки
Отсутствуют.
Особые условия использования
Должен использоваться внутри цикла, в противном случае Система выведет предупреждение "Действие "Прервать цикл" находится вне цикла".
Пример использования
Задача:
Существуют переменные с типом "Массив чисел" и "Число", содержащие соответственно значение "(1988, 8, 2, 4)" и "0".
...
- Создаем переменную "Числовая_переменная2" с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
- Создаем переменную "Массив_чисел" с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле..
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие "Цикл "Для каждого" (см. описание действия "Цикл "Для каждого"").
- Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0Если").
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл".
- Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Запускаем робота по кнопке "Запуск" в верхней панели.
...
Алгоритм прошел по циклу и был прерван после установки переменной значения "2".
Продолжить цикл / Continue the loop
...
Данное действие предназначено для прерывания текущей итерации цикла и начала следующей итерации. Действия в цикле, установленные после действия "Продолжение цикла", завершены не будут.
Настройки
Отсутствуют.
Особые условия использования
Должен использоваться внутри цикла, в противном случае Система выведет предупреждение "Действие "Продолжить цикл" находится вне цикла.".
Пример использования
Задача:
Существуют переменные с типом "Массив чисел" и "Число", содержащие соответственно значение "(1988, 8, 2, 4)" и "0".
...
- Создаем переменную "Числовая_переменная2" с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
- Создаем переменную "Массив_чисел" с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле..
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие "Цикл "Для каждого" (см. описание действия "Цикл "Для каждого"").
- Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0Если").
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0Прервать цикл").
- Помещаем в рабочее пространство действия "Если" ветви "Да" действие "Продолжить цикл".
- Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Запускаем робота по кнопке "Запуск" в верхней панели.
...
При этом, если элемент массива был не равен значению "2", то текущая итерация прерывалась и переходила на следующую.
Цикл с постусловием /Loop Do While
...
Данное действие предназначено для создания цикла действий, который выполняется до тех пор, пока результат условия равен "True". Для добавления условия используется инструмент построения выражений в параметре "Условие. Для добавление в тело цикла последовательности действий необходимо переместить их на контур блока "Тело цикла".
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Условие | Condition | Логическое выражение или переменная/значение логического типа, определяющее продолжение или прерывание цикла. Условие проверяется после выполнения тела цикла. Для задания логического выражения используется инструмент построителя выражений. !! Если пользователь удаляет из параметра значение, заданное инструментом построения выражений, блок "Условие" на флоу очищается. | Robin.Boolean | True | Да |
| Условие | Condition | Последовательность действий в выражении в условии. Заполняется в случае, когда условие задается через построитель выражений. !! Данный параметр не отображается в панели параметров, но отображается в блоке Условие на рабочей области (флоу). !! Параметр заполняется/редактируется через инструмент построения выражений и только через него. Любое редактирование данного блока на флоу для пользователя заблокировано. | Robin.Internal.SequenceId | Нет | |
| Тело цикла | Loop body | Последовательности действий, которая должна выполняться на каждом шаге цикла. Заполняется добавлением действий в соответствующий блок в рабочую область. !! Данный параметр не отображается в панели параметров, но отображается в блоке Тело цикла на рабочей области (флоу). | Robin.Internal.SequenceId | Да | |
Особые условия использования
Так как это логическое выражение оценивается после каждого выполнения цикла, цикл "Пока" выполняется один или несколько раз.
Цикл Для /For-Loop
...
Данное действие предназначено для обеспечения заданной итерации по счетчику шагов.
Для добавления в тело цикла последовательности действий необходимо переместить их на контур действия "Цикл Для".
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Начальное значение | Initial value | Первоначальное значение счетчика. | Robin.Numeric | 0 | Да |
| Конечное значение | End value | Конечное значение счетчика. | Robin.Numeric | 10 | Да |
| Инкремент | Increment | Увеличение шага цикла. | Robin.Numeric | 1 | Да |
| Идентификатор | Sequence Id | Идентификатор последовательности действий, которая должна выполняться на каждом шаге цикла. !! Данный параметр не отображается и назначается системой автоматически. | Robin.Internal.SequenceId | Да Действия внутри последовательности должны быть | |
| Результаты | |||||
| Состояние итератора | Iteration actual state | Значение счетчика для использования в текущей итерации цикла. | Robin.Numeric | ITERATION_ACTUAL_STATE | |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Необходимо завершить работу цикла, если состояние итератора будет равно значению "2".
...
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие "Цикл Для".
Настройка действия:- Параметр "Начальное значение". Задаем начальное значение счетчика для цикла.
- Параметр "Конечное значение". Задаем конечное значение счетчика для цикла.
- Параметр "Инкремент". Задаем значение, на которое будет увеличиваться счетчик.
- Результат "Состояние итератора". Выбираем переменную "ITERATION_ACTUAL_STATE", в которую будет помещено значение счетчика для каждого шага цикла.
- Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0Если").
- Задаем условие "ITERATION_ACTUAL_STATE == 2"
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0Прервать цикл")
- Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Запускаем робота по кнопке "Запуск" в верхней панели.
...
Алгоритм прошел по циклу и был прерван после установки состояния итератора в значение "2".
Цикл "Для каждого" / Loop For Each
...
Данное действие предназначено для обеспечения заданной итерации по элементам коллекции. Для добавления в тело цикла последовательности действий необходимо переместить их на контур действия "Цикл "Для каждого".
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Коллекция | Collection | Коллекция объектов, проход по которым будет осуществляться в цикле. | Robin.Collection | Коллекция_значений | Да |
| Идентификатор | Sequence Id | Идентификатор последовательности действий, которая должна выполняться на каждом шаге цикла. !! Данный параметр не отображается и назначается системой автоматически. | Robin.Internal.SequenceId | Да Действия в последовательности должны быть | |
| Результаты | |||||
| Объект | Object | Объект, в который будет помещен каждый элемент коллекции. | Robin.Object | ITERATION_ACTUAL_STATE | |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Существует коллекция переменных с типом "Массив чисел" и "Число", содержащие соответственно значение "(1988, 8, 2, 4)" и "0".
...
- Создаем и добавляем в коллекцию "Коллекция_значений" переменную с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
- Создаем и добавляем в коллекцию "Коллекция_значений" переменную с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле.
- Открываем группу действий "Базовые действия".
- Помещаем в рабочее пространство студии действие "Цикл "Для каждого".
Настройка действия:- Параметр "Коллекция". Выбираем коллекцию "Коллекция_значений", проход по объектам которой будет осуществляться в цикле.
- Параметр "Объект". Выбираем переменную "ITERATION_ACTUAL_STATE", в которую будет помещен каждый элемент коллекции.
- Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0Если").
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0Прервать цикл").
- Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0Сообщение в лог").
- Запускаем робота по кнопке "Запуск" в верхней панели.
...
Алгоритм прошел по циклу и был прерван после установки переменной значения "2".
Пока/ Loop while
...
Данное действие предназначено для создания цикла действий, который выполняется до тех пор, пока результат условия равен "True". Для добавления условия используется инструмент построения выражений в параметре "Условие. Для добавление в тело цикла последовательности действий необходимо переместить их на контур блока "Тело цикла".
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Условие | Condition | Логическое выражение или переменная/значение логического типа, определяющее продолжение или прерывание цикла. Условие проверяется до выполнения тела цикла. Для задания логического выражения используется инструмент построителя выражений. !! Если пользователь удаляет из параметра значение, заданное инструментом построения выражений, блок "Условие" на флоу очищается. | Robin.Boolean | True | Да |
| Условие | Condition | Последовательность действий в выражении в условии. Заполняется в случае, когда условие задается через построитель выражений. !! Данный параметр не отображается в панели параметров, но отображается в блоке Условие на рабочей области (флоу). !! Параметр заполняется/редактируется через инструмент построения выражений и только через него. Любое редактирование данного блока на флоу для пользователя заблокировано. | Robin.Internal.SequenceId | Да Действия в последовательности должны быть | |
| Тело цикла | Loop body | Последовательности действий, которая должна выполняться на каждом шаге цикла. Заполняется добавлением действий в соответствующий блок в рабочую область. !! Данный параметр не отображается в панели параметров, но отображается в блоке Тело цикла на рабочей области (флоу). | Robin.Internal.SequenceId | Да Действия в последовательности должны быть | |
Особые условия использования
Так как это логическое выражение оценивается перед каждым выполнением цикла, цикл "Пока" выполняется ноль или несколько раз.
Получить координаты центра области/Get area center coordinates
...
Действие возвращает координаты центра переданной области.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Область | Area | Расположение и размер области | Robin.RectangleLocation | Нет | |
| Результаты | |||||
| Результат | Result | Координаты центра области | Robin.LocationPoint | ||
Особые условия использования
Отсутствуют
Округлить число / Round number
...
Действие округляет заданное число.
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Число | Число, над которым будет производиться округление. | Robin.Numeric | Да | |
| Номер цифры | Порядковый номер цифры числа, которая будет округляться. Нумерация начинается с 1. Счет начинается слева направо. | Robin.Numeric | Да | |
| Способ округления | Параметр задает способ, по которому будет произведено округление числа. Элементы: Округление к ближайшему, Округление к большему, Округление к меньшему. | Robin.String | Да | |
| Результаты | ||||
Округленное число | Число после округления. | Robin.Numeric | ||
Особые условия использования
- Действие работает со следующими способами округления : округление к ближайшему целому, округление к большему, округление к меньшему.
- Для работы действия необходимо ввести порядковый номер цифры числа, который будет округляться.
- Если номер цифры указан больше того, что есть в числе - действие возвращает неизмененное число.
- Если значение порядкового номера цифры указано "0" или отрицательное число, то робот вернет ошибку.
- После округления указанной цифры, все нули после него удаляются, но только если они находятся после запятой. Пример: 2.486 → 2.49
- Если округляемая цифра находится после запятой и округляется до значения "0", то "0" не будет указан в выходном числе, а значение цифры перед ним увеличиться на 1. Пример: 2.99 → 3
- Если у числа после округления целое - 0 и после запятой идут нулевые значения, то действие вернет "0".Пример: На входе число "0.0012". Номер цифры для округления - 3. Число округляется до "0.00". Действие возвращает "0".
...
Обзор
Инструменты контента