diff --git a/docs/.vs/docs/v17/.suo b/docs/.vs/docs/v17/.suo
new file mode 100644
index 0000000..60850b5
Binary files /dev/null and b/docs/.vs/docs/v17/.suo differ
diff --git a/docs/.vs/slnx.sqlite b/docs/.vs/slnx.sqlite
new file mode 100644
index 0000000..99ac532
Binary files /dev/null and b/docs/.vs/slnx.sqlite differ
diff --git a/docs/.vs/slnx.sqlite-journal b/docs/.vs/slnx.sqlite-journal
new file mode 100644
index 0000000..d932181
Binary files /dev/null and b/docs/.vs/slnx.sqlite-journal differ
diff --git a/docs/browser.md b/docs/browser.md
index 033914b..c76d1ea 100644
--- a/docs/browser.md
+++ b/docs/browser.md
@@ -294,6 +294,11 @@ chromium (например, chromium-gost). Если данное поле не
Рис. 5. Получение строки xpath из консоли браузера
+Так же с помощью XPath можно писать свои запросы для поиска элемента
+на странице по некоторым полям, их части или другим свойствам элемента.
+В интернете много ресурсов по описанию языка XPath, как пример, один из
+них: https://msiter.ru/tutorials/xpath/syntax.
+
**Поле** **«Действие на странице»** предлагает выбор действия из
выпадающего списка, которое необходимо произвести над найденными
элементами. Доступны следующие действия:
@@ -344,8 +349,29 @@ chromium (например, chromium-gost). Если данное поле не
его по пути, указанном в поле «Переменная». Путь должен быть указан
полностью – с названием и расширением сохраняемого изображения;
-- Нажать кнопку на клавиатуре – позволяет нажать кнопку на клавиатуре
- внутри браузера.
+- Нажать кнопку на клавиатуре – позволяет нажать кнопку на клавиатуре
+ внутри браузера. Кнопки нажимаются по отношению к заданному элементу,
+ а не просто к странице браузера;
+
+- Нажать несколько кнопок на клавиатуре – позволяет нажать сочетания
+ кнопок на клавиатуре внутри браузера. Кнопки нажимаются по отношению к
+ заданному элементу, а не просто к странице браузера. Для заполнения
+ данного действия необходимо в поле «Клавиши» нажать на стрелочку в углу,
+ вследствие чего откроется окно, в котором необходимо в табличную часть
+ добавить последовательно те кнопки, которые участвуют в необходимом
+ сочетании. Само поле «Клавиши» недоступно для редактирования.
+
+
+
+Рис. 6. Кнопка для перехода в окно выбора клавиш для сочетания
+
+
+
+Рис. 7. Окно выбора клавиш для сочетания
+
+
+
+Рис. 8. Результат выбора клавиш в поле «Клавиши»
**В поле «Переменная»** вводится название переменной, начиная с символов
«v.», в которую будет помещен результат выполнения команды или,
@@ -361,9 +387,9 @@ chromium (например, chromium-gost). Если данное поле не
-Рис. 6. Пример настройки действия «Работа со страницей»
+Рис. 9. Пример настройки действия «Работа со страницей»
-На рисунке 6 представлен пример действия, настроенного для поиска
+На рисунке 9 представлен пример действия, настроенного для поиска
элемента, имя которого равно «q». После того как элемент найден, в него
будет вставлен текст «Lexema-RPA».
@@ -375,7 +401,7 @@ chromium (например, chromium-gost). Если данное поле не
-Рис. 7. Поля для настройки действия «Работа со вкладками»
+Рис. 10. Поля для настройки действия «Работа со вкладками»
Доступные действия для работы с вкладками:
diff --git a/docs/clicker.md b/docs/clicker.md
index aed7fc7..36b963c 100644
--- a/docs/clicker.md
+++ b/docs/clicker.md
@@ -273,12 +273,19 @@
Рис. 9. Действие «Нажать кнопку»
-#### Действие «Нажать две кнопки»
+#### Действие «Нажать несколько кнопок»
-Имитирует нажатие сочетания двух клавиш клавиатуры, например CTRL+A –
-выделение всего текста в поле. Необходимые кнопки выбираются в двух
-выпадающих списках «Кнопка». Список кнопок тот же, что и в действии
-«Нажать кнопку».
+Имитирует нажатие сочетания клавиш клавиатуры, например CTRL+A –
+выделение всего текста в поле. Необходимые кнопки выбираются
+выпадающем списке «Кнопка» и добавляются в табличную часть под
+ним. Список кнопок тот же, что и в действии «Нажать кнопку».
+
+
+
+Рис. 10. Действие «Нажать несколько кнопок»
+
+По кнопке «Добавить» под списком выбранных кнопок действие
+добавится в общий список действий.
#### Действие «Скопировать»
@@ -298,6 +305,12 @@
дающегося на обнаружение ошибки (значение поля «Кол-во попыток»
умноженное на значение поля «Пауза между ошибками»).
+
+#### Действие «Получить текст из поля»
+Получает текст из поля на экране, которое ищется по XPath и записывает
+в указанную переменную.
+
+
## Модуль «Поиск изображения»
Модуль «Поиск изображения», в основном, используется в связке с модулем
diff --git a/docs/excel.md b/docs/excel.md
index 8314f09..00b5dc2 100644
--- a/docs/excel.md
+++ b/docs/excel.md
@@ -179,6 +179,14 @@ Excel-модуль работает с файлами следующим обр
вводить его в поле «Действие», и программа постарается подсказать вам то
действие, которое вы ищите.
+Общие правила по заполнению полей:
+
+1. При указании листа для работы можно указать его порядковый номер в книге, начиная с 0;
+
+2. При указании диапазона необходимо разделять левую верхнюю ячейку и правую нижнюю двоеточием (A1:C3 включает в себя диапазон из 9 ячеек в колонках с A по C и строках с 1 по 3);
+
+3. Во многих действиях поддерживается указание ячейки в виде «к,с», где к – номер колонки, с – номер строки. Данное выражение может применяться в случаях, когда не известно название колонки, но есть её номер. Счет для колонок и строк в выражении ведется с 1. Диапазон A1:C3 будет указываться как 1,1:3,3. Не работает в формулах.
+
### Группа «Работа с данными»
#### Действие «Считать данные»
@@ -336,7 +344,8 @@ Excel. Начните с создания действия «Формула» д
#### Действие «Добавить столбец»
-Действие добавляет новый столбец в указанное место.
+Действие добавляет новый столбец в указанное место. Столбец может быть указан
+числом (с 1-цы) или названием.
@@ -344,7 +353,8 @@ Excel. Начните с создания действия «Формула» д
#### Действие «Удалить столбец»
-Действие удаляет указанный столбец.
+Действие удаляет указанный столбец. Столбец может быть указан числом (с 1-цы)
+или названием.
@@ -397,6 +407,9 @@ Excel. Начните с создания действия «Формула» д
массивом чисел, где индекс массива будет соответствовать индексу
указанной колонки.
+В качестве столбцов можно указывать их название или порядковый номер
+с 1-цы.
+
Рис. 30. Пример настройки действия «Уровень группировки столбца»
@@ -754,7 +767,8 @@ PDF будет производиться по стандартным настр
фильтрации, указано в поле «Значение».
Если необходимо просто включить фильтр в таблице, но без определенной
-фильтрации, то нужно оставить поле «Функция» пустым.
+фильтрации, то нужно оставить поле «Функция» пустым. Если нужно отфильтровать
+по пустым значениям, необходимо в поле «Значение» вписать «null» или «(пусто)».
@@ -774,6 +788,10 @@ PDF будет производиться по стандартным настр
столбцу. В зависимости от флажка определяется, сортируется столбец по
убыванию или по возрастанию. Столбец для сортировки должен быть один.
+Если необходимо отсортировать по нескольким колонкам – добавьте несколько
+действий сортировки по всем необходимым столбцам внутри одного модуля Excel
+и они все будут одновременно применены.
+
Рис. 50. Пример настройки действия «Добавление сортировки»
diff --git a/docs/file_module.md b/docs/file_module.md
index 234408e..a34be8f 100644
--- a/docs/file_module.md
+++ b/docs/file_module.md
@@ -140,6 +140,8 @@
представленном примере –
C:\\Users\\user\\Desktop\\Документы\\text.docx).
+Если файл в конечной директории уже существует – он будет перезаписан.
+
Рис. 9. Пример настройки действия «Перемещение файла»
@@ -148,6 +150,8 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
Действие меняет имя выбранного файла на указанное в поле «Имя файла».
+Если файл с таким же именем уже существует – он будет перезаписан.
+
Рис. 10. Пример настройки действия «Переименовать файл»
@@ -159,6 +163,8 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено
расположение созданного файла.
+Если файл с таким именем уже существует – он будет перезаписан.
+
Рис. 11. Пример настройки действия «Создать файл»
@@ -182,6 +188,8 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
Если поле «Переменная» будет заполнено, то в указанную в нем переменную
будет возвращено расположение нового файла.
+Если файл с таким именем уже существует – он будет перезаписан.
+
Рис. 13. Пример настройки действия «Скопировать файл»
@@ -203,6 +211,9 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
заполнено, то в указанную в нем переменную будет возвращено новое
расположение перемещаемой папки.
+Если папка с таким именем в конечной папке уже существует – программа выдаст
+ошибку и не переместит папку.
+
Рис. 15. Пример настройки действия «Перемещение папки»
@@ -213,6 +224,10 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
Если поле «Переменная» будет заполнено, то в указанную в нем переменную
будет возвращено расположение новой папки.
+Если создаваемая папка уже существует – программа не создаст новую папку
+и не выдаст ошибку. Перед созданием папки проверяйте её наличие другими
+действиями модуля.
+
Рис. 16. Пример настройки действия «Создание папки»
@@ -251,6 +266,8 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
указанную в нем переменную будет возвращено расположение созданного
архива.
+Если архив с таким именем уже существует – программа выдаст ошибку.
+
Рис. 20. Пример настройки действия «Заархивировать папку»
diff --git a/docs/index.md b/docs/index.md
index c33b177..89ba944 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -84,12 +84,7 @@ Lexema-RPA Studio, далее именуемая просто студия, пр
## С чего начать
Для начала работы скачайте студию Lexema-RPA Studio ***на сайте**
-*. Перед началом
-скачивания вам будет предложена регистрация. Регистрация на сайте
-обязательна, так как доступ в студию осуществляется после авторизации
-пользователя. После окончания регистрации начнется скачивание
-установщика.
-
+*.
После этого запустите установщик и в открывшемся диалоговом окне нажмите
на кнопку «Next».
@@ -121,8 +116,12 @@ Lexema-RPA Studio, далее именуемая просто студия, пр
[ссылке](https://dotnet.microsoft.com/download/dotnet-framework/net472)
(Центр загрузки Windows).
-После запуска программы появится окно авторизации, в которое следует
-ввести логин и пароль, указанные при регистрации.
+После запуска программы появится окно авторизации, в которое следует
+ввести логин и пароль, указанные при регистрации. Если вы не зарегистрированы,
+то это можно сделать при запуске программы, нажав на кнопку «Регистрация»
+внизу окна. Регистрация пользователя является обязательной. После окончания
+регистрации необходимо ввести зарегистрированные логин и пароль в
+соответствующие поля и войти в студию для работы.
diff --git a/docs/media/image11.png b/docs/media/image11.png
index b896ee6..4b4f82c 100644
Binary files a/docs/media/image11.png and b/docs/media/image11.png differ
diff --git a/docs/media/image163.png b/docs/media/image163.png
index 654155f..b083271 100644
Binary files a/docs/media/image163.png and b/docs/media/image163.png differ
diff --git a/docs/media/image164.png b/docs/media/image164.png
index 97e4321..8c000a6 100644
Binary files a/docs/media/image164.png and b/docs/media/image164.png differ
diff --git a/docs/media/image165.png b/docs/media/image165.png
index bbf02d5..e3d1e5f 100644
Binary files a/docs/media/image165.png and b/docs/media/image165.png differ
diff --git a/docs/media/image166.png b/docs/media/image166.png
index 5493fc7..b192bfc 100644
Binary files a/docs/media/image166.png and b/docs/media/image166.png differ
diff --git a/docs/media/image167.png b/docs/media/image167.png
index c8fee35..4db1f17 100644
Binary files a/docs/media/image167.png and b/docs/media/image167.png differ
diff --git a/docs/media/image168.png b/docs/media/image168.png
index d3adffa..27786af 100644
Binary files a/docs/media/image168.png and b/docs/media/image168.png differ
diff --git a/docs/media/image169.png b/docs/media/image169.png
index 9ef7b88..21de46d 100644
Binary files a/docs/media/image169.png and b/docs/media/image169.png differ
diff --git a/docs/media/image170.png b/docs/media/image170.png
index 5cd2dd1..2c8aa55 100644
Binary files a/docs/media/image170.png and b/docs/media/image170.png differ
diff --git a/docs/media/image171.png b/docs/media/image171.png
index 883f1db..cffdd8f 100644
Binary files a/docs/media/image171.png and b/docs/media/image171.png differ
diff --git a/docs/media/image172.png b/docs/media/image172.png
index cc4c40f..a3834b9 100644
Binary files a/docs/media/image172.png and b/docs/media/image172.png differ
diff --git a/docs/media/image173.png b/docs/media/image173.png
index 58ce326..dc49871 100644
Binary files a/docs/media/image173.png and b/docs/media/image173.png differ
diff --git a/docs/media/image18.png b/docs/media/image18.png
index ceafd01..7ebaccc 100644
Binary files a/docs/media/image18.png and b/docs/media/image18.png differ
diff --git a/docs/media/image26.png b/docs/media/image26.png
index 512547b..9638f4a 100644
Binary files a/docs/media/image26.png and b/docs/media/image26.png differ
diff --git a/docs/media/image27.png b/docs/media/image27.png
index 83d831b..cc3be88 100644
Binary files a/docs/media/image27.png and b/docs/media/image27.png differ
diff --git a/docs/media/image386.png b/docs/media/image386.png
new file mode 100644
index 0000000..9caec25
Binary files /dev/null and b/docs/media/image386.png differ
diff --git a/docs/media/image387.png b/docs/media/image387.png
new file mode 100644
index 0000000..d8b92ec
Binary files /dev/null and b/docs/media/image387.png differ
diff --git a/docs/media/image388.png b/docs/media/image388.png
new file mode 100644
index 0000000..3fac4d5
Binary files /dev/null and b/docs/media/image388.png differ
diff --git a/docs/media/image389.png b/docs/media/image389.png
new file mode 100644
index 0000000..52557c1
Binary files /dev/null and b/docs/media/image389.png differ
diff --git a/docs/media/image390.png b/docs/media/image390.png
new file mode 100644
index 0000000..986218e
Binary files /dev/null and b/docs/media/image390.png differ
diff --git a/docs/media/image391.png b/docs/media/image391.png
new file mode 100644
index 0000000..d5e3496
Binary files /dev/null and b/docs/media/image391.png differ
diff --git a/docs/media/image9.png b/docs/media/image9.png
index dc95117..f8f6791 100644
Binary files a/docs/media/image9.png and b/docs/media/image9.png differ
diff --git a/docs/operators.md b/docs/operators.md
index 8155a81..a53e8c5 100644
--- a/docs/operators.md
+++ b/docs/operators.md
@@ -1,4 +1,4 @@
-# МОДУЛИ-ОПЕРАТОРЫ: «ЦИКЛ», «УСЛОВИЕ», «WHILE», «TRY-CATCH», «BREAK», «RETURN», «SWITCH»
+# МОДУЛИ-ОПЕРАТОРЫ: «ЦИКЛ FOR», «УСЛОВИЕ», «ЦИКЛ WHILE», «TRY-CATCH», «BREAK», «RETURN», «SWITCH»
## Модуль «Условие»
@@ -121,9 +121,9 @@
Рис. 12. Свернутые THEN и ELSE
-## Модуль «Цикл»
+## Модуль «Цикл FOR»
-Модуль «Цикл» применяется для неоднократного (цикличного) выполнения
+Модуль «Цикл FOR» применяется для неоднократного (цикличного) выполнения
набора действий. Действия, добавленные в модуль, будут выполняться до
тех пор, пока не пройдёт указанное в настройках количество итераций.
@@ -256,9 +256,9 @@ Excel-файл. Но что, если этих писем нет? Для это
есть, без модуля Continue пришлось бы все действия над файлом делать
внутри ветки ELSE модуля «Условие»).
-## Модуль «While»
+## Модуль «Цикл While»
-Модуль «While» (цикл с условием) выполняет добавленные в него действия
+Модуль «Цикл While» (цикл с условием) выполняет добавленные в него действия
до тех пор, пока указанное условие возвращает значение «True».
### Интерфейс модуля
diff --git a/docs/word.md b/docs/word.md
index dfbdd74..08ed65e 100644
--- a/docs/word.md
+++ b/docs/word.md
@@ -15,7 +15,7 @@ Microsoft Office. С помощью модуля можно создавать
действия для работы с файлом, и третья – окно с предварительным
просмотром загруженного файла.
-
+
Рис. 1. Интерфейс окна
@@ -36,7 +36,7 @@ Microsoft Office. С помощью модуля можно создавать
применить к загруженному файлу или создать новый с указанным путем в
поле «Путь к файлу». Обязательное поле;
-
+
Рис. 2. Перечень доступных действий модуля
@@ -49,7 +49,7 @@ Microsoft Office. С помощью модуля можно создавать
Для добавления действия в таблицу «Список команд» необходимо
воспользоваться кнопкой «Добавить» под полями настройки действия.
-
+
Рис. 3. Расположение кнопки «Добавить»
@@ -63,7 +63,7 @@ Microsoft Office. С помощью модуля можно создавать
выбрать одно действие и нажать на необходимые кнопки «Поднять» или
«Опустить», которые расположены в правом углу над таблицей с командами.
-
+
Рис. 4. Кнопки «Поднять/Опустить» и выбор строки в таблице
@@ -76,7 +76,7 @@ Microsoft Office. С помощью модуля можно создавать
типа «*Путь до файла*/*Название файла*.*Требуемое расширение*»,
например, «C:/Reports/Documents/Test.docx».
-
+
Рис. 5. Пример заполнения действия «Создать файл»
@@ -87,7 +87,7 @@ Microsoft Office. С помощью модуля можно создавать
помимо стандартных трёх – «Переменная», в которую записывается название
переменной (с символов «v.»), в которую будет записан считанный текст.
-
+
Рис. 6. Пример настройки действия «Получить текст»
@@ -100,7 +100,7 @@ Microsoft Office. С помощью модуля можно создавать
текст, введенный данным действием, полностью затрет существующий текст в
файле.
-
+
Рис. 7. Пример настройки действия «Записать текст»
@@ -115,7 +115,7 @@ Microsoft Office. С помощью модуля можно создавать
обозначающего, после какого по счету символа необходимо вставить текст
(с учетом пробелом и символов переноса строки или разрыва страницы).
-
+
Рис. 8. Пример настройки действия «Добавить текст»
@@ -139,7 +139,7 @@ HEX – шестнадцатеричное представление RGB.
Данное действие добавляет символ переноса строки в файл. Не требует
заполнения дополнительных полей.
-
+
Рис. 9. Пример настройки действия добавление перехода на новую строку
@@ -151,7 +151,7 @@ HEX – шестнадцатеричное представление RGB.
номер символа, после которого необходимо удалить текст, а второе –
количество символов в удаляемом тексте.
-
+
Рис. 10. Пример настройки действия «Удалить текст»
@@ -162,6 +162,30 @@ HEX – шестнадцатеричное представление RGB.
файла, в который нужно экспортировать, и указать путь с названием и
расширением будущего файла в поле «Путь выходного файла».
-
+
-Рис. 11. Пример настройки действия «Экспорт»
\ No newline at end of file
+Рис. 11. Пример настройки действия «Экспорт»
+
+#### Найти слово
+
+Данное действие ищет слово или словосочетание (его точное совпадение)
+в тексте и возвращает все его вхождения в тексте в виде массива
+объектов (или таблицы с именованными колонками). Возвращаемые поля:
+
+- start – начальный символ слова или словосочетания;
+
+- end – конечный символ слова или словосочетания;
+
+- text – искомое слово или словосочетание вместе с прилегающими к нему символами;
+
+- pageNum – номер страницы, на которой было найдено слово или словосочетание.
+
+
+
+Рис. 12. Пример настройки действия Найти слово
+
+Результат поиска будет выглядеть следующим образом:
+
+
+
+Рис. 13. Пример результирующей переменной
diff --git a/mkdocs.yml b/mkdocs.yml
index 4516a09..92de2b8 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -8,7 +8,7 @@ nav:
- 'МОДУЛЬ «КЛИКЕР» И МОДУЛИ, РАБОТАЮЩИЕ С ЭКРАНОМ': 'clicker.md'
- 'МОДУЛЬ «РАБОТА С ФАЙЛАМИ»': 'file_module.md'
- 'МОДУЛИ «ПОЧТОВЫЕ АГЕНТЫ»': 'email.md'
- - 'МОДУЛИ-ОПЕРАТОРЫ: «ЦИКЛ», «УСЛОВИЕ», «WHILE», «TRY-CATCH», «BREAK», «RETURN», «SWITCH»': 'operators.md'
+ - 'МОДУЛИ-ОПЕРАТОРЫ: «ЦИКЛ FOR», «УСЛОВИЕ», «ЦИКЛ WHILE», «TRY-CATCH», «BREAK», «RETURN», «SWITCH»': 'operators.md'
- 'МОДУЛЬ «РАБОТА С БРАУЗЕРОМ»': 'browser.md'
- 'МОДУЛЬ «ИНТЕРФЕЙС»': 'interface.md'
- 'МОДУЛИ ДЛЯ РАБОТЫ С ТЕКСТОМ': 'text_analysis.md'