Окно модуля очень простое и состоит всего лишь из поля для ввода и кнопок «Сохранить» и «Отмена».
Поле «Выражение». В поле построчно вводятся операции, которые необходимо провести с переменными. Это может быть сложение, вычитание, умножение или вычисление функции. -
Поддерживаемые операции -
• + (сложение); -
• - (вычитание); -
• * (умножение); -
• / (деление); -
• % (остаток от деления); -
• \ (целое от деления); -
• ^ (возведение в степень). -
Все строки должны быть вида «Переменная = Операция;», операция в свою очередь может состоять как из одиночного числа или строки, так и из нескольких операндов, связанных вышеуказанными операторами, либо быть функцией. -
Каждая строка должна быть отделена от следующей символом «;». +
Поле «Выражение». В поле вводится код на языке программирования JavaScript. Возможно использование локальных переменных модуля (с объявлением их через let, var или const, но они не будут видны в других модулях скрипта робота), либо переменных студии, которые должны начинаться с символов «v.». +
Модуль полностью подчиняется правилам языка JS, то есть поддерживаются все стандартные функции JS, разделение строк производится посредством ввода символа «;» или переходом строки (клавиша Enter). ## Пример работы с модулем
Предположим, необходимо получить последний день предыдущего месяца. Сделаем это с помощью ввода следующего кода:
Что делает написанный выше код? А вот что – получаем сегодняшний день, например, сегодня 25 марта, вычитаем из полученной даты на один день больше, чем на самом деле есть, то есть 26 дней и оказываемся в последнем дне предыдущего месяца – 29 февраля (если год високосный). Более подробно: -
1 строка – использование функции GetDate, которая возвращает сегодняшнюю дату, и сохранение её результата в переменную @now (@now = 25.03.2020); -
2 строка – использование функции GetDay, которая принимает один параметр – дату, и возвращает из поданной в неё даты только день. Подадим в функцию в качестве параметра сегодняшнюю дату, которая лежит в переменной @now. После этого запишем результат работы функции в переменную @day (@day = 25); -
3 строка – увеличиваем переменную @day на единицу (@day = 26); -
4 строка – использование функции DateAdd. Функция принимает три параметра: 1) day, month или year – компонент даты, с которым работаем, 2) – количество, которое прибавляется к выбранному компоненту даты, 3) – дата, с которой проводятся манипуляции. Вычтем из сегодняшней даты 26 дней – используем DateAdd с параметрами: -
1. day – вычитаем дни; -
2. –@day – так как функция по умолчанию складывает, добавим знак минус; -
3. @now – сегодняшняя дата. -
В итоге получается, что мы вычитаем из 25.03.2020 26 дней и оказываемся в 29.02.2020. +
Что делает написанный выше код? А вот что – получаем сегодняшний день, например, сегодня 25 марта, из этой даты мы берем информацию о текущем годе и месяце, затем создаем новый экземпляр даты, устанавливая в качестве года и месяца текущие, а в качестве дня – нулевой, в следствие чего язык JS создаст дату с последним днем предыдущего месяца. Более подробно: +
1 строка – создание нового экземпляра даты без передачи параметров, в следствиии чего создастся сегодняшняя дата (date = 25.03.2020); +
2 строка – использование метода getFullYear, который возвращает полный год даты, к которой он применен (year = 2020); +
3 строка – использование метода getMonth, который возвращает месяц даты, к которой он применен (month = 2, так как месяца в JS считаются с 0); +
4 строка – создание нового экземпляра даты, в качестве параметров подаются текущий год, текущий месяц и 0 в качестве дня (v.lastDay = 29.02.2020); +
5 строка – получение числа последнего дня предыдущего месяца (v.lastDay = 29). +
В качестве знакомства с языком программирования JavaScript рекомендуем к изучению интернет-ресурс «Современный учебник JavaScript», доступный по ссылке. + diff --git a/docs/FROCR.md b/docs/FROCR.md index 02ef254..25bc853 100644 --- a/docs/FROCR.md +++ b/docs/FROCR.md @@ -8,11 +8,12 @@
Поле «Путь к PDF файлу». В поле указывается путь до распознаваемого файла/картинки.
Поле «Переменная». В поле вводится имя переменной, начиная с символа «@», в которую будет занесен результат распознавания. -
PDF файл может состоять из нескольких страниц, поэтому переменная будет являться списком страниц. Например, @text[0] – первая распознанная страница файла. +
PDF файл может состоять из нескольких страниц, поэтому переменная будет являться списком страниц. Например, v.text[0] – первая распознанная страница файла.
Весь распознанный текст делится на две части – основной текст и табличная часть. ## Основной текст -
Для обращения к тексту, необходимо обращаться к полю rows_word[0] (в данной записи [0] означает, что идет обращение к первой текстовой части, в других версиях ABBYY возможно использование большего разбиения текста). Затем указывается, как отдельное поле, номер строки и, через точку, номер слова в строке - @text[0].rows_word[0].2.4. Затем, после выбора нужного слова, можно получить его значение, обратившись к полю value - @text[0].rows_word[0].2.4.value – такая строка выдаст значение слова, находящегося на первой странице распознанного документа, во второй строке и является четвертой слева. +
Для обращения к тексту, необходимо обращаться к полю rows_word[0] (в данной записи [0] означает, что идет обращение к первой текстовой части, в других версиях ABBYY возможно использование большего разбиения текста). Затем указывается, как отдельное поле, номер строки и, через точку, номер слова в строке – v.text[0].rows_word[0].2.4. Затем, после выбора нужного слова, можно получить его значение, обратившись к полю value – v.text[0].rows_word[0].2.4.value – такая строка выдаст значение слова, находящегося на первой странице распознанного документа, во второй строке и является четвертой слева. ## Табличная часть -
Для обращения к таблице, необходимо обращаться к полю tables[0] ([0] нужен для корректной работы, его смысловая часть заложена в продукте ABBYY). Затем отдельным полем вводится номер таблицы, так как на странице их может быть несколько - @text[0].tables[0].0. После этого вводится номер ячейки в таблице в виде одного числа. Если вы хотите найти ячейку и знаете её номер колонки и строки, то можно получить индекс рассматриваемой ячейки переменной в виде «строка,колонка», обратившись к полю index - @text[0].tables[0].0.5.index (5 – пятая ячейка в массиве распознанных ячеек). Для получения значения из ячейки нужно обратиться к её значению, а затем либо собрать всю строку, записанную в ячейку, либо обратиться к конкретному слову по его порядковому номеру - @text[0].tables[0].0.5.value.1.value – значение второго слова из пятой ячейки первой таблицы с первой страницы распознанного текста. -
Для получения количества ячеек в таблице используйте следующую конструкцию - @text[0].tables[0].0[%], то есть указывайте набор символов «[%]» после того поля, после которого идет поле, количество элементов которого необходимо узнать. -
Для получения количества слов в ячейке используйте @text[0].tables[0].0.5[%]. +
Для обращения к таблице, необходимо обращаться к полю tables[0] ([0] нужен для корректной работы, его смысловая часть заложена в продукте ABBYY). Затем отдельным полем вводится номер таблицы, так как на странице их может быть несколько – v.text[0].tables[0].0. После этого вводится номер ячейки в таблице в виде одного числа. Если вы хотите найти ячейку и знаете её номер колонки и строки, то можно получить индекс рассматриваемой ячейки переменной в виде «строка,колонка», обратившись к полю index – v.text[0].tables[0].0.5.index (5 – пятая ячейка в массиве распознанных ячеек). Для получения значения из ячейки нужно обратиться к её значению, а затем либо собрать всю строку, записанную в ячейку, либо обратиться к конкретному слову по его порядковому номеру – v.text[0].tables[0].0.5.value.1.value – значение второго слова из пятой ячейки первой таблицы с первой страницы распознанного текста. +
Для получения количества ячеек в таблице используйте следующую конструкцию – v.text[0].tables[0].0.length, то есть используйся метод «length» после того поля, после которого идет поле, количество элементов которого необходимо узнать. +
Для получения количества слов в ячейке используйте v.text[0].tables[0].0.5.length. + diff --git a/docs/FTP.md b/docs/FTP.md new file mode 100644 index 0000000..1229095 --- /dev/null +++ b/docs/FTP.md @@ -0,0 +1,12 @@ +#
Модуль позволяет отправлять запросы по FTP протоколу.
+ +## Интерфейс модуля +Модуль состоит из нескольких полей для подключения к серверу, ввода названия переменной и выпадающего списка с выбором действия. +
Поле «Ссылка» предназначено для ввода ссылки для подключения к FTP серверу. +
Поле «Логин» заполняется логином подключающегося к серверу пользователя. +
Поле «Пароль» заполняется паролем пользователя для доступа к серверу. +
Поле «Переменная» предназначено для ввода названия переменной, в которую будет помещен результат выполнения модуля. +
Пол «Действие» предоставляет перечень доступных действий с FTP сервером. diff --git a/docs/FileModule.md b/docs/FileModule.md index f4d261a..5b32b6e 100644 --- a/docs/FileModule.md +++ b/docs/FileModule.md @@ -6,6 +6,7 @@
Окно модуля объединяет три группы элементов.
Первая группа элементов – это набор полей и кнопок для создания команды. Вторая – непосредственно список команд. И третья – это область предварительного просмотра текстовых файлов.
Набор доступных полей для заполнения меняется в зависимости от выбранного действия, подробное описание всех полей будет дано позже. ## Функциональность модуля ### Создание команды
Команда создается следующим образом – выбирается необходимое действие, заполняются остальные поля – нажимается кнопка «Добавить», по которой команда добавляется в «Список команд». @@ -25,6 +26,7 @@ ### Действие «Считать файл»
Действие считывает весь текст из выбранного файла и записывает его в указанную переменную.
Поле «Начальная кодировка» отвечает за выбор кодировки, которая будет использоваться при чтении из файла. ### Действие «Получить список файлов в папке»
Действие создает переменную-список, в которой лежат пути до каждого файла в папке.
Действие перемещает выбранный файл в указанную папку.
Действие перемещает папку, указанную во втором поле, в директорию, указанную в третьем поле. -
Действие создает ZIP-архив с указанным именем, добавляя в него содержимое выбранной папки. -
Действие распаковывает ZIP-архив в указанную папку. -
Действие создает папку с указанным названием в выбранной директории. -
Действие удаляет выбранную папку. -
Действие меняет имя выбранного файла на указанное в поле «Имя файла». +
Действие создает новый файл с расширением .txt.
Действие проверяет существование указанного файла и записывает результат в переменную.
«True» - если существует, и иначе «False».
Действие перемещает папку, указанную во втором поле, в директорию, указанную в третьем поле. +
Действие создает папку с указанным названием в выбранной директории. +
Действие удаляет выбранную папку. +
Действие проверяет существование указанной папки и записывает результат в переменную.
«True» - если существует, и иначе «False».
Действие создает переменную-список, в которой лежат пути до каждого файла в папке. +
Действие создает ZIP-архив с указанным именем, добавляя в него содержимое выбранной папки. +
Действие распаковывает ZIP-архив в указанную папку. +
Http-запросы – запросы для передачи информации между сайтами (или серверами) и клиентами (например, нами).
+Модуль «HTTP запрос» предназначен для отправки запросов по протоколу http. + +## Интерфейс модуля +
Данный модуль состоит из полей: «Ссылка», «Переменная», «Тип запроса» и вкладок Headers и Body с одинаковыми полями Name и Value. Внизу модуля расположена таблица с добавленными значениями аргументов. +
Поле «Ссылка». В поле вводится необходимый URL-адрес. +
Поле «Переменная». В поле вводится название переменной, в которую будет помещен ответ. +
Поле «Тип запроса». Позволяет выбрать необходимый тип запроса. Доступны методы «GET» и «POST». +
Поля «Name» и «Value» вкладок «Headers» и «Body» предназначены для составления http-запроса. diff --git a/docs/HTTPGET.md b/docs/HTTPGET.md deleted file mode 100644 index 565062b..0000000 --- a/docs/HTTPGET.md +++ /dev/null @@ -1,12 +0,0 @@ -#
Http-запросы – запросы для передачи информации между сайтами (или серверами) и клиентами (например, нами).
-Модуль «HTTP_GET» предназначен для отправки Get-запросов по протоколу http.
-Для работы с полученными ответами можно использовать модуль «Парсинг JSON» (если, конечно, запрашиваемый формат данных был таковым).
- -## Интерфейс модуля -Данный модуль состоит из полей: «Ссылка», «Логин», «Пароль» и «Переменная». -
Поле «Ссылка». В поле вводится необходимый URL-адрес. -
Поле «Переменная». В поле вводится название переменной, в которую будет помещен ответ. -
Поля «Логин» и Пароль». Предназначены для ввода логина и пароля, так как некоторые сайты используют защиту своей информации и запрашивают авторизацию. diff --git a/docs/HTTPOData.md b/docs/HTTPOData.md new file mode 100644 index 0000000..6340a25 --- /dev/null +++ b/docs/HTTPOData.md @@ -0,0 +1,13 @@ +#
Http-запросы – запросы для передачи информации между сайтами (или серверами) и клиентами (например, нами).
+Модуль «HTTP OData» предназначен для отправки запросов по протоколу http к интеграционному сервису 1С – OData.
+ +## Интерфейс модуля +Данный модуль состоит из полей: «Ссылка», «Логин», «Пароль», «Переменная» и «Тип запроса». +
Поле «Ссылка». В поле вводится необходимый URL-адрес. +
Поле «Переменная». В поле вводится название переменной, в которую будет помещен ответ. +
Поля «Логин» и Пароль». Предназначены для ввода логина и пароля при авторизации. +
Поле «Тип запроса». Позволяет выбрать необходимый тип запроса. Доступны методы «GET», «PUT», «POST» и «PUTCH». +
Поле «Запрос». В поле вводится HTTP-сообщение, согласно общим правилам его структуры. Доступно к заполнению только при выборе типов запроса «PUT», «POST» и «PUTCH». diff --git a/docs/HTTPPOST.md b/docs/HTTPPOST.md deleted file mode 100644 index 286c202..0000000 --- a/docs/HTTPPOST.md +++ /dev/null @@ -1,11 +0,0 @@ -#
Модуль «HTTP_POST» предназначен для отправки Post-запросов по протоколу http.
- -## Интерфейс модуля -Форма для отправки Post-запроса аналогична форме для отправки Get-запроса, с одним лишь отличием - присутствует поле для ввода самого запроса. -
Поле «Ссылка». В поле вводится необходимый URL-адрес. -
Поле «Переменная». В поле вводится название переменной, в которую будет помещен ответ. -
Поля «Логин» и Пароль». Предназначены для ввода логина и пароля, так как некоторые сайты используют защиту своей информации и запрашивают авторизацию. -
Поле «Запрос». В поле вводится HTTP-сообщение, согласно общим правилам его структуры. diff --git a/docs/HelloStudio.md b/docs/HelloStudio.md index 45526c1..a8bce59 100644 --- a/docs/HelloStudio.md +++ b/docs/HelloStudio.md @@ -19,7 +19,7 @@ #### Создать
Нажатие на кнопку «Создать» вызывает окно создания нового проекта.
В открывшемся окне необходимо ввести имя нового проекта, дополнительно можно указать его описание. Нажатие на кнопку «Создать» в указанном окне завершит процесс создания проекта. Новый проект будет открыт в главном окне студии. +
В открывшемся окне необходимо ввести имя нового проекта, дополнительно можно указать его описание. Нажатие на кнопку «Создать» в указанном окне завершит процесс создания проекта. Новый проект будет открыт в главном окне студии. Ключ проекта – уникальный идентификатор проекта, который необходим для загрузки проекта в оркестратор. По этому ключу происходит обновление проекта, который уже загружен в оркестратор, при его повторной загрузке. Если необходимо загрузить в оркестратор проект, основанный на проекте с ключом, который уже загружен в оркестратор, необходимо изменить его ключ.
Кнопка «Сохранить» вызывает стандартный диалог сохранения файла. @@ -84,40 +84,49 @@
• Описание — общее описание функции.
Lexema-RPA Studio позволяет хранить конфиденциальную информацию, например, пароли, логины или почтовые адреса, в переменных, которые будут зашифрованы и сохранены на вашем компьютере. Обзор ваших локальных переменных доступен по кнопке «Локальное хранилище»  в панели управления переменными и функциями. Окно аналогично окну обзора общих переменных студии. +
Lexema-RPA Studio позволяет хранить конфиденциальную информацию, например, пароли, логины или почтовые адреса, в переменных, которые будут зашифрованы и сохранены на вашем компьютере. Обзор ваших локальных переменных доступен по кнопке «Локальное хранилище»  в панели управления переменными и функциями. Окно состоит из трех столбцов: +
• Имя – название переменной; +
• Значение; +
• Описание – ваш комментарий относительно переменной. +
При двойном нажатии по переменной откроется окно её редактирования, аналогичное окну создания локальной переменной. +
В раздел «Отладочный вывод» главного окна студии выводятся все сообщения, возникающие в ходе выполнения настроенных действий проекта после нажатия на кнопку «Проиграть». Сообщения выводятся для всех действий по порядку их выполнения в проекте.
В отладочном выводе выводится информация о времени начала робота, общее время работы. Для каждого модуля выводится информация о начале времени его выполнения и затраченное время.
В случае возникновения исключения в работе модуля, робот приостановит выполнение, и в отладочном выводе, в последней строке, будет содержаться информация об ошибке. Текст первой и последней строки отладочного вывода будет написан красным цветом.
Переменные предназначены для хранения данных, которые должны быть доступны для всех действий проекта. Большинство модулей поддерживает чтение и запись данных в переменные. -
К наименованию переменных предъявляется следующее требование: название переменной должно всегда начинаться с символа @. +
К наименованию переменных предъявляется следующее требование: название переменной должно всегда начинаться с символов ‘v.’.
Обращаться к переменным можно в полях окон настройки модулей приложения. При обращении необходимо указывать полное название переменной согласно описанному выше требованию. -
В проекте можно создавать переменные трёх типов: +
В проекте можно создавать переменные четырех типов:
• Элемент – переменная, имеющая одно значение. Это может быть строка или число;
• Список – переменная, состоящая из нескольких элементов;
• Таблица – переменная в виде таблицы, в ячейках которой содержатся элементы. +
• Объект – переменная, имеющая именованные поля - ключи и их значения-элементы.
Для создания переменной нажмите на кнопку «Создать переменную» в обозревателе решений, предварительно выбрав нужный проект (сделав его активным). Для создания локально хранимой и зашифрованной переменной необходимо нажать кнопку «Создать локальную переменную». После выполнения действия откроется окно создания переменной, это окно аналогично окну редактирования свойств переменной. Локальные переменные могут создаваться только с типом «Элемент», поэтому окно их настройки немного отличается от настройки обычных переменных. -
В окне создания переменной укажите название переменной согласно требованиям приложения (в начале наименования обязательно должен быть символ @) и выберите тип переменной из списка. При изменении типа переменной изменяются доступные настройки. +
В окне создания переменной укажите название переменной согласно требованиям приложения (в начале наименования обязательно должны быть символы v.) и выберите тип переменной из списка. При изменении типа переменной изменяются доступные настройки.
Для переменных с типом «Элемент» доступны следующие настройки:
• поле для ввода значения; -
• признак «Константа» (для констант обязательно указывать значение); -
• шифрование переменной. -
Переменные с типом «Список» хранят набор (массив) переменных. Обращение к каждому элементу списка осуществляется по его индексу, индекс начинается с 0. Индекс указывается в квадратных скобках, следующих сразу за названием переменной. Например, для обращения ко второму элементу - @array[1]. -
Для создания переменных-списков становится доступной таблица, в которой можно заполнить требуемые значения. Значения вводятся в ячейки. Добавление следующего элемента осуществляется по нажатию клавиши «Enter». -
Переменные с типом «Таблица» представляют собой таблицу (двумерный массив), т.е. это список, элементами которого являются списки. Другими словами, это набор однотипных данных, имеющий общее имя, доступ, к элементам которого осуществляется по двум индексам. Наглядно двумерный массив удобно представлять в виде таблицы, в которой n строк и m столбцов, а под ячейкой таблицы, стоящей в i-й строке и j-м столбце понимают некоторый элемент массива a[i-1,j-1] (так как индекс начинается с нуля). Это означает, что для обращения к элементу в 3 строке и 5 столбце, отвечающему за ячейку таблицы, необходимо указывать два индекса: @table[2, 4]. -
Для заполнения значений переменных с типом «Таблица» становится доступной таблица, набор столбцов которой можно расширять с помощью кнопки «Добавить столбец». Добавление строк производится по нажатию клавиши «Enter». Вводить значения можно для каждой ячейки. Незаполненные столбцы не будут использоваться при создании переменной. -
При нажатии в обозревателе решений на кнопку «Узнать значение переменной» открывается окно, с помощью которого можно проверить значение переменной активного проекта. Для проверки значения необходимо ввести полное наименование переменной (включая символ @). -
Переменные с типом «Список» хранят набор (массив) переменных. Обращение к каждому элементу списка осуществляется по его индексу, индекс начинается с 0. Индекс указывается в квадратных скобках, следующих сразу за названием переменной. Например, для обращения ко второму элементу – v.array[1]. +
Заполнение переменных-списков производится посредством ввода значения в поле «Значение», затем нажатием кнопки «Добавить», после чего введенный элемент добавится в список элементов в нижней части окна. +
Переменные с типом «Таблица» представляют собой таблицу (двумерный массив), т.е. это список, элементами которого являются списки. Другими словами, это набор простых элементов, доступ к которым осуществляется по двум индексам. Наглядно двумерный массив удобно представлять в виде таблицы, в которой n строк и m столбцов, а под ячейкой таблицы, стоящей в i-й строке и j-м столбце, понимают некоторый элемент массива a[i-1,j-1] (так как индекс начинается с нуля). Это означает, что для обращения к элементу в 3 строке и 5 столбце, отвечающему за ячейку таблицы, необходимо указывать два индекса: v.table[2, 4]. +
Для заполнения значений переменных с типом «Таблица» становится доступной таблица, набор столбцов которой можно расширять с помощью кнопки «Добавить столбец». Добавление новых строк производится по нажатию клавиши «Enter». Вводить значения можно для каждой ячейки. Незаполненные столбцы не будут использоваться при создании переменной. +
И последний возможный тип переменных в программе – переменные-объекты. Для создания переменной необходимо заполнять поля «Ключ» и «Значение» указанного ключа. В примере показана переменная v.person, которая состоит из двух полей – name и age, значения которых John и 18 соответственно. Для обращения к полям такой переменной в программе необходимо указать название переменной с символов «v.» и через точку поле, к которому хотите обратиться: v.person.name (результатом будет строка John). +
При нажатии в обозревателе решений на кнопку «Узнать значение переменной» открывается окно, с помощью которого можно проверить значение переменной активного проекта. Для проверки значения необходимо ввести полное наименование переменной (включая символы v.). +
Предустановленный набор вспомогательных функций позволяет выполнять различные вычисления в действиях проекта.
Для вызова встроенной функции необходимо перед её названием ввести знак #, например, #OperationPlus(1, 1). Аргументы функции, над которыми должна производится операция, перечисляются в круглых скобках через запятую (если функция работает с несколькими аргументами). Между наименованием вызываемой функции и скобками с её аргументами не должно быть пробела. @@ -141,12 +150,11 @@
Пункт «Снять/поставить точку остановки» создаёт или отключает точку остановки выполнения проекта. Точки остановки упрощают процесс наладки последовательности действий.
Пункт «Копировать» копирует в буфер обмена выбранное действие для последующей вставки.
Пункт «Вставить» вставляет скопированное действие после выделенного действия. Данный пункт доступен также при вызове контекстного меню в рабочей области главного окна студии. +
Пункт «Удалить» удаляет данный модуль из списка модулей (аналогичен нажатию крестика в правой части модуля).
Точка остановки – это инструмент, который помогает отлаживаться при написании робота. Такой инструмент позволяет остановить работу робота после выполнения выбранного модуля, при этом появляется окно с указанием всех переменных, доступных на данный момент выполнения, для ознакомления с их содержанием. +
Точка остановки – это инструмент, который помогает отлаживаться при написании робота. Такой инструмент позволяет остановить работу робота перед выполнением выбранного модуля, при этом в панели отладочного вывода отображаются текущие переменные и их значения, модуль, который должен будет выполняться после продолжения подсвечивается красной рамкой, а в панели инструментов появляются две новые кнопки, позволяющие управлять пошаговой отладкой.
Редактировать переменные в данном окне нельзя. Для определения значения сложных переменных (переменные типов «Таблица» и «Список» или объекты) можно воспользоваться кнопкой «Узнать значение». -
После ознакомления с переменными можно продолжить работу робота, а можно завершить, в любом из случаев это окно будет закрыто. +
Пошаговая отладка позволяет выполнять каждый модуль робота друг за другом, при этом можно следить за значениями всех переменных. Для выполнения подсвечиваемого модуля и остановки робота после его выполнения, то есть, для перехода к следующему модулю (шагу), необходимо нажать кнопку «Следующий шаг отладки» . Для прекращения выполнения работы робота необходимо нажать кнопку «Остановить» . Если требуется остановить робота в другом месте, через несколько модулей, то во время отладки можно поставить новую точку остановки на модуле, перед выполнением которого необходимо остановить работу робота, и нажать «Продолжить выполнение» . Изменения, внесенные в модули во время отладки, в текущем выполнении применены не будут. #### Настройка добавленных действий
Окно настройки свойств действия, добавленного в структуру проекта, открывается с помощью двойного щелчка левой кнопкой мыши по указанному действию. Набор свойств, доступных в этом окне, зависит от выбранного действия. Подробнее о доступных свойствах каждого действия будет описано далее в руководстве. diff --git a/docs/History.md b/docs/History.md new file mode 100644 index 0000000..713ca32 --- /dev/null +++ b/docs/History.md @@ -0,0 +1,11 @@ +#
При нажатии правой кнопкой мыши по задаче в списке задач появляется контекстное меню, позволяющее перейти к статистике выполнений или логам задачи.
+ +## +Статистика выполнения открывается так же при двойном клике по задаче. +
В данном окне отображаются состояния задачи – время запуска, время окончания и статус работы – Success (успешно) или Failed (провалено). Если строка пустая, значит робот по каким-то причинам был приостановлен, например был остановлен клиент или убит процесс в «Диспетчере задач». +
В окне логов отображается более детальная информация – начало и окончание работы модуля робота. +
• Выбор файла – поле с иконкой в виде трех точек, по нажатию на которую пользователю будет предложено выбрать файл. Путь до выбранного файла запишется в это поле;
Для фильтрации отображаемых пользователю файлов можно воспользоваться полем «Фильтр по файлам», в которое вводится строка вида: «Название типа файлов (доступные расширения)|доступные расширения». Можно задать несколько настроек фильтрации, разделителем для этого является символ «|». Пример: +
В данном случае отображается две настройки фильтрации: +
1. All files (*.*), в которой отображаются файлы с любым расширением; +
2. Microsoft Excel Worksheet (*.xl*; *.csv), в которой отображаются файлы с расширениями .csv и начинающимися на .xl (то есть .xlsx, xls и другие). +
• Выбор папки – поле с иконкой в виде трех точек, по нажатию на которую пользователю будет предложено выбрать папку. Путь до выбранной папки запишется в это поле. Выглядит так же, как и «Выбор файла». ## Поле «Источник данных»
В это поле вводится название переменной или строка, на основе которой контрол будет заполнен. Немного поподробнее о поле при выборе различных элементов интерфейса: diff --git a/docs/JSON.md b/docs/JSON.md index 9c800d7..3802658 100644 --- a/docs/JSON.md +++ b/docs/JSON.md @@ -1,4 +1,4 @@ -#
Данный модуль предназначен для обработки данных в формате JSON – парсинга JSON-объектов.
@@ -8,8 +8,8 @@Поле «Переменная». В поле «Переменная» вводится название переменной, которая будет преобразована в объектную переменную с полями, имеющимися в JSON-объекте.
Поле «JSON». В поле необходимо описать объект в формате JSON, в виде пар «ключ»: «значение», обрамлённых в фигурные скобки. JSON-объект может быть описан непосредственно текстом в поле «JSON» либо быть созданным в процессе выполнения других модулей. В случае формирования JSON-объекта в других модулях, в поле необходимо ввести название переменной, в которой лежит необходимый объект. ## ПРИМЕР -
Пусть у нас есть текст в формате JSON. Введем его в поле JSON модуля, а результат пусть запишется в переменную @a. +
Пусть у нас есть текст в формате JSON. Введем его в поле JSON модуля, а результат пусть запишется в переменную v.a.
В результате переменная @a станет объектом с полями «name» и «age». К полям объекта можно обратиться, написав название поля через точку после переменной. Проверить значение переменной можно с помощью функционала «Узнать значение переменной», доступного по кнопке в обозревателе решений. +
В результате переменная v.a станет объектом с полями «name» и «age». К полям объекта можно обратиться, написав название поля через точку после переменной. Проверить значение переменной можно с помощью функционала «Узнать значение переменной», доступного по кнопке  в обозревателе решений.
Видно, что на основе текста формата JSON создалась переменная с указанными в нем полями и заполненными значениями. \ No newline at end of file diff --git a/docs/KS.md b/docs/KS.md new file mode 100644 index 0000000..c159477 --- /dev/null +++ b/docs/KS.md @@ -0,0 +1,6 @@ +#
Данный модуль позволяет делать скриншот экрана во время работы робота, что удобно для проведения отладки кликерных роботов (роботов, преимущественно работающих на модуле Кликер).
+ +## +Lexema-RPA Studio содержит некоторые настройки, которые подходят большинству пользователей, но в некоторых случаях они должны быть изменены. Такие настройки вынесены в файл конфигурации, который находится в папке с программой и называется «Lexema-RPA Studio.exe.condig». Открыть данный файл можно любым текстовым редактором, например Блокнотом.
+Настройки, которые можно изменять, находятся в блоке appSettings. Приведенные ниже можно изменять пользователям, остальные не рекомендуется. Доступные для изменения настройки: +
1. AbbyyFreDllPath - путь до папки с драйвером ABBYY (для пользователей, приобрётших лицензию ABBYY); +
2. useFileLog - использовать логирование в текстовый файл, по умолчанию значение true, запись ведется во временную директорию системы, в папку Lexema-RPA; +
3. useEmail – использовать логирование с отправкой письма с ошибкой на почту. Настройки почты вводятся в поля emailHost, emailPort, emailUseSSL, emailName и emailPass. В поле emailAdmin вводится адрес, на который должно прийти письмо; +
4. ChromePath – путь до браузера Chrome для модуля «Работа с браузером». diff --git a/docs/MoveLetter.md b/docs/MoveLetter.md new file mode 100644 index 0000000..affa1fb --- /dev/null +++ b/docs/MoveLetter.md @@ -0,0 +1,16 @@ +#
С помощью данного модуля можно переносить уже считанные письма в другие папки в почте, удалять письма с сервера и догружать информацию. С помощью данного модуля можно переносить уже считанные письма в другие папки в почте. Для использования модуля предварительно необходимо получить письма с помощью модуля «Считать письма».
+ +## Интерфейс модуля +Интерфейс модуля состоит из двух вкладок – «Настройки» и «Параметры перемещения» и «Действие». +### Вкладка «Настройки» +
Вкладка настроек не отличается от аналогичной вкладки в модуле «Считать письма», но доступен только один протокол – IMAP. При выборе в поле «Настройки» необходимой почтовой службы, поля «Хост», «Порт» и «SSL» заполнятся автоматически, при пользовательских настройках их необходимо заполнять вручную. +
На данной вкладке производится настройка действия, совершаемого над сообщением. +
Поле «Действие» позволяет выбрать одно из трёх доступных действий – «Переместить письмо», «Удалить письмо» и «Загрузить всю информацию из письма». +
В поле «Id письма» вносится id письма, над которым производится действие, который может быть получен с помощью модуля «Считать письма». Может быть передано несколько идентификаторов через запятую, либо переменная-список, содержащая их. +
Поле «Папка» доступно только для действия «Переместить письмо». В него указывается название папки на почте, в которую должно быть перемещено письмо. +
Поле «Переменная» доступно только для действия «Загрузить всю информацию из письма», в которое вводится название переменной, которая будет являться результирующей для выполнения действия. diff --git a/docs/OCR.md b/docs/OCR.md index 68e2a7a..eb293b7 100644 --- a/docs/OCR.md +++ b/docs/OCR.md @@ -14,3 +14,5 @@
Результат, записанный в переменную при распознавании изображения:
Результат содержит информацию о страницах, координате и значении каждого слова изображения. +
Пример получения некоторого слова со второго листа документа: v.text[1].words[100].value, где v.text – переменная, в которую записан результат работы модуля, [1] – номер листа в документе (нумерация по переменным-спискам начинается с 0), [100] – 101-ое слово в файле, value – само значение слова. + diff --git a/docs/Orkestrator.md b/docs/Orkestrator.md index da35b60..0426982 100644 --- a/docs/Orkestrator.md +++ b/docs/Orkestrator.md @@ -11,7 +11,7 @@
После создания всех задач необходимо просто закрыть окно оркестратора.
Для работы оркестратора необходимо установить программу Lexema-RPA Client, которая, находясь в фоновом режиме работы на компьютере, просматривает созданные вами задачи и запускает роботов в соответствии с их расписанием. Для её скачивания необходимо посетить сайт и выбрать там «Скачать Lexema-RPA Client». Инструкция по использованию находится там же. ## Создание новой задачи -
Для создания расписания запуска одного робота нужно создать задачу. Для настройки задачи необходимо заполнить 5 полей – это наименование задачи, выбор робота из опубликованных, время первого запуска робота, количество повторов и интервал запуска. +
Для создания расписания запуска одного робота нужно создать задачу. Для настройки задачи необходимо заполнить 6 полей – это наименование задачи, выбор робота из опубликованных, время первого запуска робота, количество повторов и интервал запуска, машина для запуска, на которой запущен RPA Client.
Наименование задачи. Название задачи для запуска конкретного робота, идентификатор, по которому вам будет удобнее ориентироваться среди всех ваших задач.
Робот. Выбор робота, для которого составляется задача запуска. Поле представлено выпадающим списком, в котором предложены все ваши опубликованные роботы. @@ -25,6 +25,8 @@
Если необходимо, чтобы робот запускался 25 числа каждого месяца, необходимо в первом запуске установить дату ближайшего 25 числа месяца, а настройке интервала ввести значение «1» в строке «Месяц», то есть, осуществлять повторы каждый месяц.
Между каждым повтором будет установлен одинаковый интервал. Если необходимо запускать робота с разными временными интервалами, то необходимо создать несколько задач его запуска, например, если требуется запуск в 10:00 и в 13:00 одного дня на протяжении недели, то необходимо создать две задачи, количество повторений которых равно 6 (каждый день, не считая первого запуска), интервал запуска – 24 часа или 1 день, отличаться у этих задач будут только время первого запуска – у одной в 10:00 дня, когда нужно начать, у другой – в 13:00.
После заполнения нужных строк в окне интервала и нажатию на кнопку «Сохранить», в поле «Интервал» отобразится строка вида «год:месяц:день:час:минуты:секунды», например, при установке интервала в 12 часов, строка будет иметь вид «0:0:0:12:0:0». Поле «Интервал» является обязательным, если количество повторов отличное от 0. +
После заполнения нужных строк в окне интервала и нажатию на кнопку «Сохранить», в поле «Интервал» отобразится строка вида «год:месяц:день:час:минуты:секунды», например, при установке интервала в 12 часов, строка будет иметь вид «0:0:0:12:0:0». Поле «Интервал» является обязательным, если количество повторов отличное от 0. +
RPA-Client. Если существует несколько разных машин (компьютеров), на которых авторизован один и тот же пользователь и запущены программы Lexema RPA-Client, то данное поле позволяет выбрать, на какой из этих машин необходимо запускать выбранного робота. Если неважно, на какой конкретно машине должен запускаться робот, то поле можно оставить пустым, тогда робот будет запускаться на одной из свободных машин.
Пример заполненной задачи:
По нажатию кнопки «Добавить», расположенной под полями для настройки задач, задача будет добавлена в список задач. diff --git a/docs/PDF.md b/docs/PDF.md new file mode 100644 index 0000000..93b4faa --- /dev/null +++ b/docs/PDF.md @@ -0,0 +1,21 @@ +#
Данный модуль позволяет работать с PDF файлами. В его возможности входит получение текста из документа, изображений, и объединение нескольких PDF файлов.
+ +## Интерфейс модуля +Модуль состоит из 4-х полей, доступность которых определяется выбранным действием, кнопок управления создаваемым действием и таблицей-списком созданных действий. +
Поле «Действие». Представляет собой выпадающий список из доступных в модуле действий. +
Поле «Документ 1». Поле, в которое вводится путь до рабочего файла. По кнопке в поле открывается диалог выбора файла. +
Поле «Документ 2». Поле, в которое вводится путь до второго рабочего файла, используется для действий, требующих несколько файлов (например, объединение 2-х PDF). По кнопке в поле открывается диалог выбора файла. +
Поле «Переменная». Поле, для ввода названия переменной, в которую будет возвращен результат работы модуля. +## Перечень и описание действий +### Получить text +
Действие позволяет получить текст из файла PDF, если тот является непосредственно текстом, а не изображением. Полученный текст будет записан в указанную переменную. +
Действие получает все изображения из PDF файла и сохраняет их в формате .jpg в указанную в поле «Папка» директорию. В указанную переменную будет записан список путей до выделенных изображений. +
Действие объединяет два указанных PDF файла и сохраняет их в файле, который необходимо указать в поле «Значение». +
Модуль «Считать письма» предназначен для получения списка писем с почты для дальнейшей их обработки или просто для скачивания вложений.
## Интерфейс модуля -Модуль состоит из двух вкладок: «Настройки» и «Настройки чтения». +
Модуль состоит из трех вкладок: «Настройки», «Настройки чтения» и «Параметры загрузки».
Вкладка «Настройки» аналогична одноименной вкладке в модуле «Отправить письмо», с одним лишь отличием - в данном модуле предоставляется выбор протокола отправки: IMAP или POP3. При выборе соответствующего протокола и его настроек, поля «Хост», «Порт» и «Использовать SSL» заполняются автоматически (кроме режима «Пользовательские настройки»).
1) Subject – тема письма;
2) Body – тело письма, его основной текст;
3) Sender – отправитель; -
4) Attachments – список путей до скачанных вложений. +
4) Receivers – получатели, перечисленные через запятую; +
5) Attachments – список путей до скачанных вложений; +
6) Date – дата получения письма; +
7) Id – уникальный идентификатор письма.
Примеры работы с переменными -
• @mail[1].Attachments[0] – получение пути первого вложения второго считанного письма: +
• v.mail[2].Attachments[0] – получение пути первого вложения третьего считанного письма:
• @mail[0].Subject – получение темы первого скачанного сообщения: +
• v.mail[3].Subject – получение темы четвертого скачанного сообщения:
Поле «Скачивать вложения в папку» предназначено для ввода пути до папки, в которую загрузятся все вложения считанных писем. Если оставить поле пустым, то файлы будут загружаться во временную директорию компьютера.
Флажок «Только непрочитанные» позволяет настроить считывание только новых писем. Доступно только для протокола IMAP.
Флажок «Отмечать как прочитанные» позволяет после считывания устанавливать пометку о прочтении письма. Доступно только для протокола IMAP.
Поле «Читать из папки» предназначено для настройки конкретной папки в почтовом ящике, из которой следует считывать письма. По умолчанию, письма считываются из папки «Входящие». Доступно только для протокола IMAP. +
Поле «Фильтр по отправителям» позволяет искать сообщения, отправленные от одного из указанных отправителей. Перечислить всех можно через запятую, либо подав в это поле переменную-список, содержащую отправителей. +
Поле «Фильтр по получателям» позволяет искать сообщения, в которых присутствуют указанные получатели. Перечислить всех можно через запятую, либо подав в это поле переменную-список, содержащую получателей.
Поле «Фильтр по теме сообщений» предназначено для настройки фильтра по теме сообщений. Если необходимо скачать письма с темой, содержащей или не содержащей определенную строку, то следует выбрать одноименную операцию в выпадающем списке и вписать нужную строку в появившемся поле:
Поле «Фильтр по дате» предназначено для настройки фильтрации считывания писем по дате. При указании значения в данном поле, робот будет считывать только те сообщения, которые удовлетворяют заданному условию. @@ -32,3 +37,31 @@
• все письма, до какой-либо даты, включая её – «До даты»;
• «Между датами».
После выбора метода фильтрации под полем «Фильтр по дате» появится одно или два поля для внесения в них нужных значений в формате ДД.ММ.ГГГГ. +### Вкладка «Параметры загрузки» +
С помощью данной вкладки можно ограничить информацию, скачиваемую с почтового сервера, для уменьшения затрачиваемых ресурсов. По умолчанию скачивается вся доступная информация. +
Доступно следующее разграничение для скачивания: +
• Загрузка информации об отправителе, получателях, теме и дате сообщения (шапка письма); +
• Загрузка только текста сообщения; +
• Загрузка вложений (по умолчанию так же скачивается текст сообщения); +
• Загрузка только даты сообщения. +
С помощью данной функции можно загрузить только, например, «шапки» писем, отобрать из них необходимые, и догрузить по ним всю информацию с помощью модуля «Действия над письмами», который будет описан в следующей главе. +### Включение IMAP и POP3 протоколов +
1. Яндекс +
1.1. IMAP +
Для использования протокола IMAP в почтовой службе Яндекс необходимо перейти в настройки почты (1), затем «Почтовые программы» (2) и разрешить доступ к почтовому ящику с помощью почтовых клиентов с сервера imap.yandex.ru (3), способы авторизации – по портальному паролю (4). +
Если настройки «Портальный пароль» нет, значит в вашем аккаунте предусмотрено использование паролей приложений, которые для работы Lexema-RPA Studio необходимо выключить. Для этого перейдите в управление аккаунтом - «Пароли и авторизация» - «Пароли приложений» - «Выключить пароли приложений». +
Затем вернитесь на страницу с включением настроек почтовых программ и установите галочку напротив «Портального пароля». +
1.2. POP3 +
Для включения протокола POP3 необходимо войти в те же настройки, что и при включении протокола IMAP: «Настройки» (1) – «Почтовые программы» (2) - разрешить доступ к почтовому ящику с помощью почтовых клиентов с свервера pop.yandex.ru (3). +
2. GMail +
2.1. IMAP +
Для включения IMAP протокола в почтовой службе GMail необходимо перейти в настройки почты (1), затем выбрать пункт «Пересылка и POP/IMAP» (2) - «Доступ по IMAP» и затем в «Состоянии» включить IMAP (3): +
2.2. POP3 +
Аналогично проводится включение протокола POP3: настройки (1) – «Пересылка и POP/IMAP» (2) - «Доступ по протоколу POP» - «Включить POP для всех писем» (3): +
Окно состоит из следующих полей: «СУБД», «Источник данных», «База данных», «Логин», «Пароль», «SQL-скрипт» и «Переменная».
Поля «СУБД», «Источник данных», «База данных», «Логин» и «Пароль» обеспечивают подключение к БД. -
Поле «SQL-скрипт». В данное поле вводится скрипт на языке SQL, поддерживается ввод переменных студии. +
Поле «Время ожидания». В данное поле вводится значение времени в секундах, которое должно хватить запросу на выполнение. Без этого поля робот может работать бесконечно долго из-за исключительных ситуаций, поэтому заполнение этого поля является обязательным. Для небольших запросов значение может быть равно 20 секунд, для больших – минута и более. +
Поле «SQL-скрипт». В данное поле вводится скрипт на языке SQL, поддерживается ввод переменных студии. При использовании переменных студии необходимо подать в это поле строку в следующем виде: весь скрипт должен быть взят в кавычки, за исключением переменных студии (как показано на рис. 11.34.1).
Поле «Переменная». В поле вводится название переменной, в которую будет записан ответ от базы данных в виде таблицы. В одном SQL-модуле может возвращаться только одна таблица, последующие будут проигнорированы. diff --git a/docs/StartProcess.md b/docs/StartProcess.md index dca8447..f936974 100644 --- a/docs/StartProcess.md +++ b/docs/StartProcess.md @@ -11,3 +11,5 @@
Флажок «От имени администратора» запускает процесс с правами, позволяющими запускаемому процессу вносить изменения в системные файлы компьютера. Если вы не доверяете приложению, то не стоит ставить этот флажок.
Поле «Пауза» устанавливает время ожидания после начала запуска процесса.
Поле «Переменная с именем/id процесса». В данное поле вводятся переменные, в которые будут помещены имя и идентификатор (id) запускаемого процесса соответственно. Данные параметры нужны, чтобы в дальнейшем можно было завершить (закрыть) указанные процессы. Если у вас задача только запустить процессы, то можете оставить эти поля пустыми. +
Флажок «Скрыто» запускает процесс со свойством hide (скрытый), то есть запускает фоновый процесс. +
Флажок «Ожидать завершения» позволяет данному модулю дождаться окончания работы процесса и только затем продолжить работу робота. diff --git a/docs/WHILE.md b/docs/WHILE.md index 02cc8a0..9a06c2b 100644 --- a/docs/WHILE.md +++ b/docs/WHILE.md @@ -9,4 +9,5 @@
Добавление действий в модуль происходит с помощью перетаскивания из меню модулей или из рабочей области проекта.
При нажатии на кнопку «Свернуть» действия, описанные в цикле, сворачиваются для более компактного отображения команды. -
С помощью действия можно записать имеющийся текст, например, считанный из другого текстового файла, в текущий загруженный файл. Для настройки обязательно заполнение поля «Значение», куда вводится либо переменная (с символа «@»), содержащая текст, либо сам текст. Обратите внимание, что текст, введенный данным действием, полностью затрет существующий текст в файле.
Данное действие позволяет добавлять текст к существующему с применением необходимого форматирования. Для редактирования открываются все поля модуля. Далее будет подробно описано каждое поле, отличное от основных трёх. +
«После символа №» - данное поле ожидает ввод целого числа, обозначающего, после какого по счету символа необходимо вставить текст (с учетом пробелом и символов переноса строки или разрыва страницы).
«Размер текста» - аналогичен полю «Размер шрифта» в Microsoft Word – устанавливает размер добавляемого текста. Ожидается ввод целого или десятичного числа.
«Шрифт» - выпадающий список, содержащий в себе набор стандартных шрифтов пакета Micrisift Office – устанавливает шрифт добавляемого текста. diff --git a/docs/WorkBrowser.md b/docs/WorkBrowser.md index 022e708..b42562c 100644 --- a/docs/WorkBrowser.md +++ b/docs/WorkBrowser.md @@ -9,8 +9,9 @@
Для удаления ненужных команд необходимо выбрать команду в таблице и нажать «Удалить».
Робот будет выполнять все указанные команды последовательно, поэтому для изменения порядка команд в таблице можно воспользоваться стрелочками в правом верхнем углу таблицы. Делается это следующим образом – выбирается строка, положение которой необходимо изменить, а затем нажимаются стрелочки вверх или вниз, в зависимости от того, где эта строка должна находиться.
Для всех действий три первых поля остаются неизменными, это «Драйвер», «Действие» и «Примечание». +
Для всех действий некоторые поля остаются неизменными, это все поля для настройки прокси, «Драйвер», «Действие» и «Примечание».
Поле «Драйвер» на данный момент недоступно для редактирования и в нем по умолчанию выбран драйвер для браузера Chrome, но в обозримом будущем этот список планируется дополнять другими браузерами. +
Поля «Proxy Server» - «Proxy Password» предназначены для ввода настроек прокси браузера, если это необходимо.
Поле «Действие» — это выпадающий список с перечнем возможных действий этого модуля. Подробнее о них будет рассказываться в следующей главе.
Поле «Примечание» — строка с примечанием к команде. ## Перечень и описание действий @@ -56,6 +57,8 @@
• GetElementsByXPath – поиск элементов по языку запросов HTML – xpath.
«Строка поиска» для нахождения элемента div - //div[@class='main']. +
Чтобы получить строку xpath для необходимого вам элемента в консоли разработчика в браузере, нужно нажать по этому элементу правой кнопкой мыши в коде – копировать – XPath: +
Поле «Действие на странице» предлагает выбор действия из выпадающего списка, которое необходимо произвести над найденными элементами. Доступны следующие действия:
• Записать – вводит заданный в поле «Переменная» текст (например, после нажатия на определенный элемент для ввода текста);
• Получить text – получает значение свойства «text» всех найденных или только выбранного элемента и возвращает результат в виде списка в переменную; @@ -65,6 +68,9 @@
• Получить Property – при выборе действия появляется поле «Название Property» - возвращает значение указанного в поле «Название Property» свойства всех найденных элементов или конкретно заданного. Результатом будет являться список;
• Получить CSS свойство – при выборе действия появляется поле «Свойство CSS» - возвращает значение указанного в поле «Свойство CSS» свойства всех найденных элементов или конкретно заданного. Результатом будет являться список;
• Получить Attribute – при выборе действия появляется поле «Свойство Attribute» - возвращает значение указанного в поле «Свойство Attribute» свойства всех найденных элементов или конкретно заданного. Результатом будет являться список; +
• Получить элементы – возвращает список указанных элементов для дальнейшей работы с ними; +
• Выполнить JavaScript – данное действие позволяет выполнить JavaScript код в браузере для получения некоторой информации. Для записи результата выполнения кода в переменную, необходимо в начале кода добавлять «return», например «return document.querySelectorAll("[height='24']").length» (такой запрос вернет количество элементов на странице, высота которых равна 24); +
• Нажать кнопку на клавиатуре – позволяет нажать кнопку на клавиатуре внутри браузера.
В поле «Переменная» вводится название переменной, начиная с символа «@», в которую будет помещен результат выполнения команды или, наоборот, из которой будут браться значения для её выполнения.
Поле «Ожидание (сек)». В поле вводится количество секунд, которые необходимо подождать после выполнения команды.
Поле «Номер элемента» предназначено для указания индекса найденного элемента, к которому необходимо применить действие. diff --git a/docs/XML.md b/docs/XML.md new file mode 100644 index 0000000..b0d2af3 --- /dev/null +++ b/docs/XML.md @@ -0,0 +1,11 @@ +#
Модуль «XML» предназначен для парсинга текста формата XML. Результатом работы модуля будет объект с полями и свойствами, указанными в исходном тексте.
+ +## Интерфейс модуля +Окно модуля состоит из двух полей – поля «Переменная» и «XML». +
Поле «Переменная» заполняется названием переменной, в которую будет возвращен объект – результат работы модуля. +
Поле «XML» заполняется текстом в формате XML или переменной, содержащей этот текст. +
Результат работы модуля при его настройке, указанной на рисунке: +
2) выбрать фрагмент снимка окна, в котором будет воспроизводиться действие, с помощью кнопки «Выделить изображение». После нажатия на кнопку студия сделает снимок экрана и предложит вам выбрать фрагмент получившегося изображения.
При использовании клика по изображению, обратите внимание на то, что, если на экране таких изображений будет несколько, действие будет применено к первому найденному!
Поле «Процент совпадения» необходимо для случаев, когда искомое изображение может немного отличаться от того, что может быть в реальности (например, наличие выделения вокруг кнопки, если она выбиралась ранее, и отсутствие такого выделения). В подобных случаях уменьшайте процент совпадения до тех пор, пока изображение не будет находиться и в том, и в другом случае. Однако если процент совпадения уменьшить слишком сильно, модуль может найти то, что не планировали искать. -Поля «Количество попыток» и «Пауза между ошибками» предназначены для случаев, когда программа не смогла найти заданное ей изображение. Вы можете указать, сколько раз следует пытаться искать требуемое изображение и сколько секунд ждать между попытками. Например, после запуска браузера нужно нажать на кнопку с иконкой «Плюсик» – создание новой вкладки. Если браузер будет загружаться слишком долго, больше 5-ти секунд (это время указано в паузе команды открытия браузера), тогда программа начнёт искать «плюсик», которого еще нет. Затем программа подождет указанное ей количество секунд между попытками и попробует снова. Как только изображение будет найдено, программа подождет то количество секунд, которое указано в поле «Пауза» данной команды, и перейдет к следующей. +
Поля «Количество попыток» и «Пауза между ошибками» предназначены для случаев, когда программа не смогла найти заданное ей изображение. Вы можете указать, сколько раз следует пытаться искать требуемое изображение и сколько секунд ждать между попытками. Например, после запуска браузера нужно нажать на кнопку с иконкой «Плюсик» – создание новой вкладки. Если браузер будет загружаться слишком долго, больше 5-ти секунд (это время указано в паузе команды открытия браузера), тогда программа начнёт искать «плюсик», которого еще нет. Затем программа подождет указанное ей количество секунд между попытками и попробует снова. Как только изображение будет найдено, программа подождет то количество секунд, которое указано в поле «Пауза» данной команды, и перейдет к следующей. +
Последний вариант поиска места для наведения мыши – «Селекторы». Этот вариант считается самым надежным, но поддерживается узким кругом программ. Селекторы Windows позволяют находить путь к элементу на экране используя не просто координаты или изображение, а путь относительно родительского компонента экрана с использованием специальной разметки. Они работают с системой компьютера, некоторыми desktop-приложениями. Использование подобно работе с координатами – необходимо навестить на искомый элемент и вызвать окно настройки действия по кнопке «TAB». При переключении настроек на «Селекторы», путь до элемента уже будет введен. +
Данное поле появляется при действии «Прокрутка мыши». В него вводится значение в пикселях, на сколько необходимо прокрутить колесико мыши. Если прокрутка вверх, то значение должно быть положительным, если вниз, то отрицательным. +
Во всех полях окна создания команды возможно использование переменных. ## Описание действий, доступных в модуле ### Действие «Кликнуть мышкой» Основное действие модуля – нажатие левой кнопкой мыши по указанным координатам или изображению. @@ -63,7 +65,9 @@
Имитирует нажатие сочетания двух клавиш клавиатуры, например CTRL+A – выделение всего текста в поле. Необходимые кнопки выбираются в двух выпадающих списках «Кнопка». Список кнопок тот же, что и в действии «Нажать кнопку».
Имитирует нажатие сочетания клавиш клавиатуры CTRL+C. Копирует выделенное заранее значение в буфер обмена и записывает его, при необходимости, в переменную, указанную в поле «Записать в». Данное поле не обязательно к заполнению. Ввод переменной начинается с символа «@». +
Имитирует нажатие сочетания клавиш клавиатуры CTRL+C. Копирует выделенное заранее значение в буфер обмена и записывает его, при необходимости, в переменную, указанную в поле «Записать в». Данное поле не обязательно к заполнению. Ввод переменной начинается с символа «v.».
Имитирует нажатие сочетания клавиш клавиатуры CTRL+V. Вставляет в выбранное поле значение из буфера обмена. +
Имитирует нажатие сочетания клавиш клавиатуры CTRL+V. Вставляет в выбранное поле значение из буфера обмена. +### Действие «Пока не пропадет изображение» +
Ожидает отсутствия заданного изображения на экране в течение времени, дающегося на обнаружение ошибки (значение поля «Кол-во попыток» умноженное на значение поля «Пауза между ошибками»). diff --git a/docs/excel.md b/docs/excel.md index fd63314..5173690 100644 --- a/docs/excel.md +++ b/docs/excel.md @@ -72,6 +72,19 @@ #### Действие «Получить количество отфильтрованных строк»
Действие возвращает количество видимых строк при примененном фильтре в указанную переменную.
Действие помещает указанную в поле «Перемещаемая строка» строку на листе из поля «Лист» вместо указанной в поле «Номер строки для вставки» листа «Лист для вставки». +
В данном примере строка 14 с листа Лист1 будет перемещена на место 16 строки листа Лист2. +#### Действие «Сгруппировать строки» +
С помощь данного действия создаются группы строк в Excel. На вход подается название листа, на котором происходит группировка, и перечень номеров строк. Перечислить строки можно просто через запятую, либо, если диапазон не разрывный, через двоеточие, например – «1,2,3,7,8,9» или «1:5», что равносильно «1,2,3,4,5». +
Действие предназначено для удаления 1-го уровня существующей группировки по строкам. Входные данные аналогичны действию «Сгруппировать строки». +
Действие позволяет получить уровень группировки выбранной строки и записать результат в указанную переменную. +
Действие добавляет новый столбец в указанное место. @@ -82,6 +95,15 @@ #### Действие «Получить количество столбцов»
Действие возвращает номер самого последнего используемого столбца.
Действие объединяет указанные столбцы в группу. Входными данными являются лист и перечень столбцов через запятую или в виде диапазона через двоеточие («A,B,C,D,E» или «A:E»). В качестве столбца можно указывать как его название, так и его порядковый номер, начиная с единицы. +
Действие позволяет удалить один уровень группировки у указанных столбцов. +
Данное действие позволяет получить уровень группы указанного столбца и записать его в переменную. +
Действие создает новый лист с указанным именем. @@ -95,6 +117,9 @@ #### Действие «Получить список листов»
Возвращает переменную-список, содержащую названия всех листов файла.
Изменение ориентации страницы Excel. Доступные ориентации – книжная и альбомная. +
Действие создает в указанной папке новый файл с названием и указанным расширением (если расширение не указано, создается файл .xlsx). Если поле «Лист» заполнено, то первый лист файла будет назван так, как указано в поле, иначе - по умолчанию (Лист 1, Sheet 1, в зависимости от языка системы).
Ищет заданную строку в указанном листе и возвращает адрес первой найденной ячейки.
Данное действие ищет и возвращает номер первой найденной строки, в заданных колонках которой записаны указанные значения. +
Данное действие ищет и возвращает номера строк, в заданных колонках которых записаны указанные значения. Флажок «Строгое сравнение» ставится в том случае, если текст в ячейках должен полностью совпадать с текстом, введенном в поле «Значения». Флажок «Массив» вернет массив всех найденных строк, результирующая переменная будет являться массивом чисел, если флажок не установлен, то в результирующую переменную будет записан номер первой найденной строки или «Строка не найдена», если таких строк нет.
В данном случае будет искаться строка, в колонке A которой 23.03.2020, а в колонке B – Уфа. #### Действие «Найти лист» -
Ищет лист, в котором есть ячейка с указанным в поле «Строка» значением и возвращает его название в указанную переменную. +
Ищет лист, в котором есть ячейка с указанным в поле «Строка» значением и возвращает его название в указанную переменную. Флажок «Строгое сравнение» ставится в том случае, если текст в ячейке должен полностью совпадать с текстом, введенном в поле «Строка».
Последнее поле меняется в зависимости от типа данных – для типа «Список» это будет «Источник данных», для всех остальных – «Критерии (ч/з ;)». Поле «Источник данных» заполняется диапазоном значений (внутри одного столбца или одной строки), в которой будет указан в списке (если список статичный, то указывайте абсолютную ссылку). Поле «Критерии (ч/з ;)» заполняется значениями, относительно которых будет применяться правило проверки.
Поле «Сообщение об ошибке» заполняется текстом ошибки, которая будет отображаться, если в ячейку введено значение, не удовлетворяющее заданному для неё правилу. Является необязательным полем. Если оставить его пустым, то будет отображаться ошибка «Введенное значение неверно. Набор значений, которые могут быть введены в ячейку, ограничен».
Действие добавляет выбранное изображение в текущий Excel-файл. Если изображение имеет прозрачный фон, то оно также сохранит прозрачность при его добавлении в файл Excel. В поле «Ячейки» указывается левый верхний угол расположения изображения. +
Действие форматирует указанные ячейки на выбранном листе в зависимости от того, удовлетворяют ли они указанному условию. В поле «Лист, диапазон» через запятую вводятся лист и диапазон или одна ячейка из этого листа, к которым будет применяться условное форматирование. В полях «Цвет заливки» и «Цвет текста» указываются цвета, которыми будет залита ячейка и окрашен текст в ней, если она будет удовлетворять условию. Условие составляется из выбора функции и указания значения для сравнения. Доступные функции – равно, не равно, больше, меньше, больно или равно, меньше или равно, формула. Если выбрана функция «формула», то в поле «Значение для сравнение» следует вписать формулу в формате Excel, начиная со знака «=». @@ -192,7 +220,7 @@
Действие отображает число по определенным правилам числового формата Excel. -
Примеры форматов можно посмотреть в программе Excel, кликнув правой кнопкой левой кнопкой мыши по ячейке – «Формат ячейки» – вкладка «Число» - (все форматы):
Наиболее часто используемые форматы числа предлагаются в студии при наведении на поле для ввода формата. @@ -200,6 +228,9 @@ #### Действие «Выравнивание»
Действие применяет заданное выравнивание в указанных ячейках. В поле «Общее положение» предлагается выбрать одно из двух – по вертикали или по горизонтали применять выравнивание, выбранное в поле «Выравнивание содержимого», которое, в свою очередь, предлагает выбрать выравнивание содержимого по левому/правому краю, либо по верхнему/нижнему краю, либо по центру.
Действие добавляет в указанный диапазон надстройку ячеек «Перенос текста», функция которой – отображение текста ячейки в несколько строк, если он не помещается в одну. +
Действие меняет шрифт, стиль или размер выбранных ячеек на указанном листе. Модуль предоставляет выбор всех стандартных шрифтов, доступных в пакете Microsoft Office.
Модуль «Лог» предназначен для вывода некоторых сообщений или значений переменных в «Отладочный вывод» во время работы робота.
+ +## +