Основные действия, не связанные с используемыми программами.

Поддерживает синтаксис С# (Подробнее об операторах и синтаксисе языка C# см. https://docs.microsoft.com/ru-ru/dotnet/csharp/language-reference/operators/index):

Тип оператора	Оператор	Значение	Типы	Пример использования	Комментарий
Операторы равенства	==	Равенство	Строка, Число, Логический	x==y	Оператор равенства "==" возвращает значение "true", если его операнды равны. В противном случае возвращается значение "false".
Операторы равенства	!=	Неравенство	Строка, Число, Логический	x!=y	Оператор неравенства "!=" возвращает значение "true", если его операнды не равны. В противном случае возвращается значение "false".
Операторы сравнения	>	Больше чем	Число	x>y	Оператор "<" возвращает "true", если его левый операнд меньше правого. В противном случае возвращается "false"
Операторы сравнения	<	Меньше чем	Число	x<y	Оператор ">" возвращает "true", если его левый операнд больше правого. В противном случае возвращается "false".
Операторы сравнения	>=	Больше или равно	Число	x>=y	Оператор "<=" возвращает "true", если его левый операнд меньше правого или равен ему. В противном случае возвращается "false".
Операторы сравнения	<=	Меньше или равно	Число	x<=y	Оператор ">=" возвращает "true", если его левый операнд больше правого или равен ему. В противном случае возвращается "false"
Логические операторы	&	Логическое И	Строка, Число, Логический	x&y	Оператор "&" вычисляет оба операнда, даже если левый операнд имеет значение "false". При этом операция должна вернуть значение "false", независимо от значения правого операнда. Результат операции "x&y" принимает значение "true", если оба оператора "x" и "y" имеют значение "true". В противном случае результат будет "false".
Логические операторы	&&	Условное (Укороченное) логическое И	Строка, Число, Логический	x&&y	Оператор "&&" вычисляет логическое И для своих операндов, но не вычисляет правый операнд, если левый операнд имеет значение "false". Результат операции "x&&y" принимает значение "true", если оба оператора "x" и "y" имеют значение "true". В противном случае результат будет "false".
Логические операторы	\|	Логическое ИЛИ	Строка, Число, Логический	x\|y	Оператор "\|" вычисляет логическое ИЛИ для всех своих операндов, даже если левый операнд имеет значение "true". При этом операция должна вернуть значение "true", независимо от значения правого операнда. Результат операции "x \| y" принимает значение "true", если хотя бы один из операторов "x" или "y" имеет значение "true". В противном случае результат будет "false".
Логические операторы	\|\|	Условное (Укороченное) логическое ИЛИ	Строка, Число, Логический	x\|\|y	Оператор "\|\|" вычисляет логическое ИЛИ для всех своих операндов, но не вычисляет правый операнд, если левый операнд имеет значение "`true"`. Результат операции "x \| y" принимает значение "true", если хотя бы один из операторов "x" или "y" имеет значение "true". В противном случае результат будет "false".
Логические операторы	!	Логическое отрицание НЕ	Логический	!x	Оператор логического отрицания "!" выполняет логическое отрицание операнда, возвращая "true", если операнд имеет значение "false", и "false", если операнд имеет значение "true".
Логические операторы	^	Логическое исключающее ИЛИ	Логический	x^y	Оператор "^" вычисляет логическое исключение ИЛИ для всех своих операндов, возвращая "true" для "x ^ y", если "x" имеет значение "true" и "y" имеет значение "false" или "x" имеет значение "false" и "y" имеет значение "true". В противном случае результат будет "false", т.е. оператор "^" возвращает тот же результат, что и оператор неравенства "!=".

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

Данное действие предназначено для группировки элементов/действий.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Имя	Name	Отображаемое имя группы.	Строка	Действия с Exel	Нет

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

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

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

Задача:

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

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

Решение:

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

Реализация:

Создаем переменную "Числовая_переменная" с типом "Число", которая будет являться результатом действия Получить количество строк и содержать значение "0".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Группа действий" и настраиваем его параметры.
Открываем группу действий "Exel".
Помещаем в контур действия "Группа действий "действие "Открыть " и настраиваем его параметры (см. описание действия "Открыть") .
Помещаем в контур действия "Группа действий "действие "Получить количество строк" и настраиваем его параметры (см. описание действия "Получить количество строк").
Помещаем в контур действия "Группа действий "действие "Закрыть " и настраиваем его параметры (см. описание действия "Закрыть").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

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

Вычислить выражение / Expression

Данное действие предназначено для вычисления результата выражения.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Имя выражения	Expression Name	Переменная , значение которой будет выводиться в лог при выполнении действия. Если значение не указано, то Система выведет сообщение: "Не задана переменная".	Строка	Group	Нет
Результаты
Результат выражения	Expression Result	Переменная, в которую будет записан результат действия. Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена".	Один из возможных. Зависит от использованных в выражении действий.	Expression_Result	Да

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

Действия в выражение отбираются пользователем.

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

Задача:

Сложить два числа, умножить на третье и посчитать количество символов в результирующем.

Решение:

Добавить действие "Сложение".
Добавить действие "Умножение".
Добавить действие "Получить длину строки".

Реализация:

Помещаем в рабочее пространство студии действие "Выражение".
Помещаем в контур действия "Выражение" действие "Сложение" и настраиваем его параметры.
Помещаем в контур действия "Выражение" действие "Умножение" и настраиваем его параметры.
Помещаем в контур действия "Выражение" действие "Получить длину строки" и настраиваем его параметры.
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Действия сгруппированы в контуре действия "Выражение". Алгоритм прошел по всем действиям и записал значение в переменную "Expression_Result".

Конвертировать в строку / Convert to string

Данное действие предназначено для конвертирования переменной другого типа данных в строку.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Источник	Source	Переменная с типом "Число" или "Дата.Время", значение которой будет конвертироваться для присваивания переменной поля "Результат". Если значение не указано, то Система выведет сообщение: "Не задана переменная".	Выпадающий список	Числовая_переменная	Да
Результаты
Результат	Result	Переменная с типом "Строка", в которую будет записано конвертированное значение из поля "Источник". Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена".	Строка	Строковая_переменная	Да

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

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

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

Задача:

Сложить два числа, умножить на третье и преобразовать результат в строку.

Решение:

Добавить действие "Сложение".
Добавить действие "Умножение".
Добавить действие "Конвертировать в строку".

Реализация:

Создаем переменную "Числовая_переменная" с типом "Число", которая будет являться результатом арифметических операций.
Создаем переменную "Result" с типом "Строка", которая будет являться результатом действия "Конвертировать в строку".
Помещаем в рабочее пространство студии действие "Сложение" и настраиваем его параметры.
Помещаем в рабочее пространство студии действие "Умножение" и настраиваем его параметры.
Помещаем в рабочее пространство студии действие "Конвертировать в строку" и настраиваем его параметры.
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

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

Длина строки / Get Length

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Строка	String	Переменная, длину которой необходимо получить. Если значение не указано, то Система выведет сообщение: "Не задана переменная".	Строка	{Text}	Да
Результаты
Результат	Result	Переменная, в которую будет записана длина введенной строки из поля "Строка". Если значение не указано, то Система выведет сообщение: "Такая переменная не найдена".	Число	Длина	Да

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

При выполнении действия, пробелы учитываются как символ.

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

Задача:

Существует текст: "Клик левой кнопкой мыши".

Необходимо подсчитать общее количество символов в тексте.

Решение:

Создать строковую переменную "Text" со значением "Клик левой кнопкой мыши".
Подсчитать длину текста.

Реализация:

Открываем группу действий "Базовые".
Помещаем в рабочее пространство студии действие "Получить длину".
Настройка действия:
1. Параметр "Строка". Указываем текст, в котором будет произведен подсчет длины текста.
2. Параметр "Результат". Выбираем из выпадающего списка переменную, в которую будет записан результат подсчета длины текста
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Переменная "Result" содержит значение "23".

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

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Папка	Folder	Папка, где необходимо сохранить скриншот. Доступен ввод вручную, либо выбор папки в модальном окне.	Строка	C:\Users\RLABUTIN\Documents\RobinStudio\1.1) Base action (RUS)\Base action (RUS)	Да
Имя файла	File name	Имя файла сохранения для скриншота.	Строка	Скрин1	Да
Формат	Format	Формат, в котором скриншот будет сохранен. Доступны значения: JPEG JPG BMP PNG GIF TIF TIFF	Выпадающий список	JPG	Да
Тип	Type	Типы скриншота области. Справочник содержит следующие значения: FullScreen - Весь экран. Window - Активное окно. Coordinates - Координаты. По умолчанию значение равно "FullScreen".	Выпадающий список	Координаты	Да
Высота	Height	Высота, обозначенной области для скриншота (отсчет идет сверху вниз от начальной координаты области скриншота). По умолчанию значение равно "0". Если значение в поле "Type" заполнено значением "FullScreen" или "Windows", то значение поля "Height" игнорируется.	Число	1+X	Нет
Ширина	Width	Ширина, обозначенной области для скриншота (отсчет идет слева направо от начальной координаты области скриншота). По умолчанию значение равно "0". Если значение в поле "Type" заполнено значением "FullScreen" или "Window", то значение поля "Width" игнорируется.	Число	400	Нет
X	X	Положение начальной координаты (координата левого верхнего угла области для скриншота) определяется двумя координатами Х и Y. Начальная координата, обозначенной области для скриншота, по горизонтали. По умолчанию поле пусто и значение равно "0".. Если значение в поле "Type" заполнено значением "FullScreen" или "Window", то значение поля "X" игнорируется.	Число	500	Нет
Y	Y	Положение начальной координаты (координата левого верхнего угла области для скриншота) определяется двумя координатами Х и Y. Начальная координата, обозначенной области для скриншота, по вертикали. По умолчанию поле пусто и значение равно "0". Если значение в поле "Type" заполнено значением "FullScreen" или "Windows", то значение поля "Y" игнорируется.	Число	300	Нет
Результаты
Результат	Result	Путь до сохраненного скриншота. Будет сохранен в выбранной папке в формате "<<Имя файла>>.<<Формат>>"	Число	Строка	Да

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

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

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

Задача:

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

Решение:

Добавить действие "Открыть" для файла Exel.
Добавить действие "Сделать скриншот".

Реализация:

Открываем группу действий "Exel".
Помещаем в рабочее пространство студии действие "Открыть" и настраиваем его параметры (см. описание действия "Открыть").
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Сделать скриншот".
Настройка действия:
1. 1. 1. Параметр "Папка": указываем путь к папке, где будет сохранен файл.
    2. Параметр "Имя": указываем имя для файла скриншота.
    3. Параметр "Формат": указываем тип, в котором хотим сохранить файл.
    4. Параметр "Тип". Выбираем значение "Весь экран" для скриншота всего экрана.
    5. Остальные параметры задаем нулями или оставляем по умолчанию.
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм открыл указанный файл Exel и сделан скриншот экрана.

Путь к скриншоту был сохранен в переменную Result.

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

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Сообщение	Message	Текст, который будет выведен в лог-файл сообщения	Строка	Возникла ошибка!	Нет

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

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

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

Задача:

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

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

Решение:

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

Реализация:

Открываем группу действий "Диалоговые окна".
Помещаем в рабочее пространство студии действие "Вопрос" и настраиваем его параметры.
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Если" (см. описание действия).
В параметр "Сообщение" указываем текст: "Пользователь запросил остановку программы", который будет выведен в лог-файл сообщения.
Запускаем робота по кнопке "Запуск" в верхней панели.
Отвечаем "Да" на вопрос в диалоговом окне.

Результат:

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

Перехват ошибок / Try-catch

Данное действие предназначено для обработки исключений в выбранных действиях.

Настройки

Свойство	Англ. наименование	Описание	Обязательность заполнения поля
Параметры
Исключения	Exceptions	Список исключений, для обработки которых предназначена соответствующая последовательность Catch. Таких последовательностей может быть несколько, тогда будет создано несколько параметров "Исключения для CATCH" для каждой из последовательностей.	Да
Результаты
Ошибка	Error	Ошибка возникшая в ходе выполнения блока Try	Да

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

...

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

Задача:

..

Решение:

...
...

Реализация:

...
....
Настройка действия:
1. ...
2. ...
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

...

Если / If

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Условие	Condition	Логическое выражение. Результатом выполнения оператора отношения или логического оператора является логическое значение типа "Логический".	Логическое выражение	Числовая_переменная<=2	Да

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

Условие "Если" может иметь только две ветви. На каждой ветви уже указан результат выражения ("Да"/ "true") и "Нет"/ "false"), по которому будет осуществлять переход на данную ветвь. Для добавления в тело ветви последовательности действий необходимо переместить их на контур соответствующего действия.

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

Задача:

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

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

Решение:

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

Реализация:

Создаем переменную "Числовая_переменная2" с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
Создаем переменную "Массив_чисел" с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле.
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Цикл "Для каждого" (см. описание действия "Цикл "Для каждого"").
Помещаем в рабочее пространство студии действие "Если".
Настройка действия:
1. Параметр "Условие". Указываем логическое выражение "Числовая_переменная2!=2", частью которого является переменная "Числовая_переменная2".
2. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
3. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0").
Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

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

Сообщение в лог / Message in log

Данное действие предназначено для отправки в лог-файл сообщения.

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Сообщение	Message	Текст, который будет выведен в лог-файл сообщения	Текстовое поле	Текстовое собщение	Нет

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

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

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

Задача:

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

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

Решение:

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

Реализация:

Создаем переменную "Строковая_переменная1" с типом "Строка", которая будет являться выражением и содержать текст "Red".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Ветвление" и настраиваем его параметры (см. описание действия "Базовые действия 2.0").
Нажимаем три раза на кнопку "" на действии "Ветвление".
Помещаем действие "Сообщение в лог" с сообщением "Ветвь №1", "Ветвь №2" и "Ветвь №3" в соответствующую номеру ветвь.
Настройка действия:
1. Параметр "Сообщение" для первой ветви. Указываем текст "Ветвь №1", который будет выведен в лог-файл сообщения.
2. Параметр "Сообщение" для второй ветви. Указываем текст "Ветвь №2", который будет выведен в лог-файл сообщения.
3. Параметр "Сообщение" для третьей ветви. Указываем текст "Ветвь №3", который будет выведен в лог-файл сообщения.
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм, согласно логам, прошел по ветви№2.

Ожидание / Sleep

Данное действие предназначено для установки ожидания на заданное время в момент выполнения сценария.

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры

Время ожидания

Sleep time

Время ожидания перехода алгоритма на следующий шаг. Указывается в миллисекундах.

По умолчанию значение равно "0"

Число

1000

Да

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

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

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

Задача:

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

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

При переходе на ветвь "Да" необходимо установить время ожидание перехода алгоритма на следующий шаг, равное 1 секунду.

Решение:

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

Реализация:

Создаем переменную "Числовая_переменная2" с типом "Число", которая будет являться частью условия "Если" и содержать значение "0".
Создаем переменную "Массив_чисел" с типом "Массив чисел" и элементами"(1988, 8, 2, 4)", проход по которым будет осуществляться в цикле..
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Цикл "Для каждого" (см. описание действия "Цикл "Для каждого"").
Помещаем в рабочее пространство студии действие "Если" (см. описание действия "Базовые действия 2.0").
1. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
2. Помещаем в рабочее пространство действия "Если" ветви "Нет" действие "Прервать цикл" (см. описание действия "Базовые действия 2.0").
3. Помещаем в рабочее пространство действия "Если" ветви "Да" действие "Ожидать".
  Настройки действия:
  1. Параметр "Время ожидание". Вводим в поле значение "1000"
Помещаем в рабочее пространство студии действие "Сообщение в лог" (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм, согласно логам, прошел по циклу и был прерван после установки переменной значения "2". При переходе на ветвь "Да" время ожидания перехода алгоритма на следующий шаг составило 1 секунду.

Ветвление / Switch

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

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры

Условие

Condition

Выражение, которое будет проверяться на соответствие условиям (несколькими константными значениями).

Если значение не указано, то Система выведет сообщение "Такая переменная не найдена".

Число, строка

Числовая_переменная

Да

Условие для Ветки

Branch condition

Заполняется для каждой созданной ветви ветвления, кроме ветви по умолчанию.

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

Если указана переменная с типом "Число", то по умолчанию устанавливается значение "0". Допустимы значения в формате "Число" (Целое/дробное), в противном случае Система выведет сообщение:

"incorrect characters are used", если поле содержит недопустимые символы (например "-").
"Cannot implicitly convert type "<<Тип>>" to "decimal", если поле содержит недопустимый тип (например, "false").
"Not found variables: <Новое значение>", если поле содержит строковые символы.

Если две ветви содержат одинаковое условие, то действие завершится ошибкой: The switch statement contains multiple cases with the label value '<<Условие>>' in line...'"

Число, строка

10

Строковый текст

Да

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

При добавления ветки перехода по умолчанию, ветвление будей пройдено без б.

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

Задача:

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

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

Решение:

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

Реализация:

Создаем переменную "Строковая_переменная1" с типом "Строка", которая будет являться выражением и содержать текст "Red".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Ветвление".
Нажимаем три раза на кнопку "" на действии.
Настройка действия:
1. Параметр "Условие". Выбираем переменную "Строковая_переменная1", значение которой будет проверяться на соответствие условиям.
2. Параметр "Условие для Ветки 1". Выбираем результат выражение "Blue", который будет сравниваться со значением в поле "Условия" действия "Ветвление".
3. Параметр "Условие для Ветки 2". Выбираем результат выражение "Red", который будет сравниваться со значением в поле "Условия" действия "Ветвление".
4. Параметр "Условие для Ветки 3". Выбираем результат выражение "Black", который будет сравниваться со значением в поле "Условия" действия "Ветвление".
Помещаем действие "Сообщение в лог" с сообщением "Ветвь №1", "Ветвь №2" и "Ветвь №3" соответствующую номеру ветвь (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Алгоритм, согласно логам, прошел по ветви№2.

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

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

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры

Текст

Text

Переменная с типом "Строка", которая будет сохранена в буфер.

Если значение не указано, то Система выведет сообщение "Такая переменная не найдена".

Строка

Строковая_переменная или текст

Да

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

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

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

Задача:

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

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

Решение:

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

Реализация:

Создаем переменную "Строковая_переменная1" с типом "Строка".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Копировать текст в буфер".
Настройка действия:
1. Параметр "Текст". Выбираем переменную "Строковая_переменная1", текст из которой будет сохранен в буфера.
Запускаем робота по кнопке "Запуск" в верхней панели*.

Результат:

Согласно логам, текст из переменной записан в буфер

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

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

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Результаты

Результат

Result

Переменная, в которую будет сохранен текст из буфера.

Если значение не указано, то Система выведет сообщение "Такая переменная не найдена".

Строка

Строковая_переменная

Да

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

С версии ROBIN 1.3.1 добавлена обработка блокировки буфера обмена. В случаях, когда при обращении к буферу возникает ошибка из-за того, что буфер уже используется каким-то приложением, действие автоматически будет с периодичностью раз в 10 секунд обращаться к буферу и пытаться получить данные из него.

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

Задача:

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

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

Решение:

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

Реализация:

Создаем переменную "Result" с типом "Строка".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Получить текст из буфера".
Настройка действия:
1. Параметр "Результат". Выбираем переменную "Result", в которую будет сохранен текст из буфера.
Помещаем в рабочее пространство студии действие "Ветвление" (см. описание действия "Базовые действия 2.0").
Нажимаем три раза на кнопку "" на действии "Ветвление".
Помещаем действие "Сообщение в лог" с сообщением "Ветвь №1", "Ветвь №2" и "Ветвь №3" соответствующую номеру ветвь (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели*.

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

Результат:

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

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

Данное действие предназначено для прерывания текущей итерации цикла/ветвления и выхода из цикла/ветвления. Действия в цикле, установленные после действия "Продолжение цикла", завершены не будут.

Настройки

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

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

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

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

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

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

Данное действие предназначено для прерывания текущей итерации цикла и начала следующей итерации. Действия в цикле, установленные после действия "Продолжение цикла", завершены не будут.

Настройки

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

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

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

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

Задача:

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

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

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

Решение:

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

Реализация:

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

Результат:

Алгоритм, согласно логам, прошел по циклу и был прерван после установки переменной значения "2" при этом, если элемент массива был не равен значению "2", то текущая итерация прерывалась и переходила на следующую.

Цикл с постусловием /Postcondition loop

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

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры

Условие

Condition

Логическое выражение, описывающее последовательность действий до тех пор, пока условие равно значению true. Так как это логическое выражение оценивается после каждого выполнения цикла, цикл "Пока" выполняется один или несколько раз.

Допустимы значения типа "Логический", в противном случае Система выведет сообщение:

"Используются некорректные символы", если поле содержит недопустимые символы (например "-") или не заполнено.
"Cannot implicity convert type "<<Тип>>" to "decimal", если поле содержит недопустимый тип (например, "1988").
"Не найдены переменные: <Новое значение>", если поле содержит строковые символы.

Число, строка

i < 5

true

false

Да

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

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

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

Задача:

Существует переменная с типом "Число", содержащая значение "1".

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

Решение:

Добавить "Цикл с постусловием".
Присвоить значение переменной.

Реализация:

Создаем переменную "Числовая_переменная1" с типом "Число", которая будет являться частью условия и содержать значение "1".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Цикл с постусловием".
Настройка действия:
1. Параметр "Условие". Указываем логическое выражение "Числовая_переменная1<3", частью которого является переменная "Числовая_переменная1".
Помещаем в рабочее пространство студии действие "Присвоить значение переменной" (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

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

Цикл Для /For-loop

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Начальное значение	Initial value	Первоначальное значение счетчика.	Число	0	Да
Конечное значение	End value	Конечное значение счетчика.	Число	10	Да
Инкремент	Increment	Увеличение шага цикла.	Число	1	Да
Результаты
Состояние итератора	Iteration actual state	Значение счетчика для использования в текущей итерации цикла.	Число	ITERATION_ACTUAL_STATE	Да

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

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

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

Задача:

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

Решение:

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

Реализация:

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

Результат:

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

Цикл "Для каждого" / Loop foreach

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

Настройки

Свойство	Англ. наименование	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Коллекция	Collection	Коллекция объектов с типом "Число", "Строка", "Общий", "Логический", "Дата/время", "Массив чисел", "Массив строк", "Массив общий", "Массив логический" или "Массив дата/время", проход по которым будет осуществляться в цикле. Если значение не указано, то Система выведет сообщение "Не задана переменная".	Коллекция	Коллекция_значений	Да
Результаты
Объект	Object	Объект, в который будет помещен каждый элемент коллекции. Если значение не указано, то Система выведет сообщение "Не задана переменная".	Выпадающий список	ITERATION_ACTUAL_STATE	Да

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

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

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

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

Цикл "Пока"/ Loop while

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

Настройки

Свойство

Англ. наименование

Описание

Тип

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

Обязательность заполнения поля

Параметры

Условие

Condition

Логическое выражение, описывающее последовательность действий до тех пор, пока условие равно значению true. Так как это логическое выражение оценивается перед каждым выполнением цикла, цикл "Пока" выполняется ноль или несколько раз.

Допустимы значения типа "Логический", в противном случае Система выведет сообщение:

"Используются некорректные символы", если поле содержит недопустимые символы (например "-") или не заполнено.
"Cannot implicity convert type "<<Тип>>" to "decimal", если поле содержит недопустимый тип (например, "1988").
"Не найдены переменные: <Новое значение>", если поле содержит строковые символы.

Число, строка

i < 5

true

false

Да

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

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

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

Задача:

Существует переменная с типом "Число", содержащая значение "1".

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

Решение:

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

Реализация:

Создаем переменную "Числовая_переменная1" с типом "Число", которая будет являться частью условия и содержать значение "1".
Открываем группу действий "Базовые действия".
Помещаем в рабочее пространство студии действие "Цикл "Пока".
Настройка действия:
1. Параметр "Условие". Указываем логическое выражение "Числовая_переменная1<3", частью которого является переменная "Числовая_переменная1".
Помещаем в рабочее пространство студии действие "Присвоить значение переменной" (см. описание действия "Базовые действия 2.0").
Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

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

Дерево страниц

Базовые действия 2.0

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

Настройки

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

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

Вычислить выражение / Expression

Настройки

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

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

Конвертировать в строку / Convert to string

Настройки

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

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

Длина строки / Get Length

Настройки

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

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

Настройки

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

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

Настройки

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

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

Перехват ошибок / Try-catch

Настройки

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

Если / If

Настройки

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

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

Сообщение в лог / Message in log

Настройки

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

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

Ожидание / Sleep

Настройки

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

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

Ветвление / Switch

Настройки

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

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

Настройки

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

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

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

Настройки

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

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

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

Настройки

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

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

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

Настройки

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

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

Цикл с постусловием /Postcondition loop

Настройки

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

Цикл Для /For-loop

Настройки

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

Цикл "Для каждого" / Loop foreach

Настройки

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

Цикл "Пока"/ Loop while

Настройки

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