5.14.11

docs/browser.md

@@ -294,6 +294,11 @@ chromium (например, chromium-gost). Если данное поле не
 
 <center>Рис. 5. Получение строки xpath из консоли браузера</center>
 
+Так же с помощью XPath можно писать свои запросы для поиска элемента 
+на странице по некоторым полям, их части или другим свойствам элемента. 
+В интернете много ресурсов по описанию языка XPath, как пример, один из 
+них: https://msiter.ru/tutorials/xpath/syntax.
+
 **Поле** **«Действие на странице»** предлагает выбор действия из
 выпадающего списка, которое необходимо произвести над найденными
 элементами. Доступны следующие действия:
@@ -344,8 +349,29 @@ chromium (например, chromium-gost). Если данное поле не
     его по пути, указанном в поле «Переменная». Путь должен быть указан 
     полностью – с названием и расширением сохраняемого изображения;
 
--   Нажать кнопку на клавиатуре – позволяет нажать кнопку на клавиатуре
-    внутри браузера.
+-   Нажать кнопку на клавиатуре – позволяет нажать кнопку на клавиатуре 
+    внутри браузера. Кнопки нажимаются по отношению к заданному элементу, 
+    а не просто к странице браузера;
+
+-   Нажать несколько кнопок на клавиатуре – позволяет нажать сочетания 
+    кнопок на клавиатуре внутри браузера. Кнопки нажимаются по отношению к 
+    заданному элементу, а не просто к странице браузера. Для заполнения 
+    данного действия необходимо в поле «Клавиши» нажать на стрелочку в углу, 
+    вследствие чего откроется окно, в котором необходимо в табличную часть 
+    добавить последовательно те кнопки, которые участвуют в необходимом 
+    сочетании. Само поле «Клавиши» недоступно для редактирования.
+
+<center><img src="../media/image389.png" /></center>
+
+<center>Рис. 6. Кнопка для перехода в окно выбора клавиш для сочетания</center>
+
+<center><img src="../media/image390.png" /></center>
+
+<center>Рис. 7. Окно выбора клавиш для сочетания</center>
+
+<center><img src="../media/image391.png" /></center>
+
+<center>Рис. 8. Результат выбора клавиш в поле «Клавиши»</center>
 
 **В поле «Переменная»** вводится название переменной, начиная с символов
 «v.», в которую будет помещен результат выполнения команды или,
@@ -361,9 +387,9 @@ chromium (например, chromium-gost). Если данное поле не
 
 <center><img src="../media/image273.png" /></center>
 
-<center>Рис. 6. Пример настройки действия «Работа со страницей»</center>
+<center>Рис. 9. Пример настройки действия «Работа со страницей»</center>
 
-На рисунке 6 представлен пример действия, настроенного для поиска
+На рисунке 9 представлен пример действия, настроенного для поиска
 элемента, имя которого равно «q». После того как элемент найден, в него
 будет вставлен текст «Lexema-RPA».
 
@@ -375,7 +401,7 @@ chromium (например, chromium-gost). Если данное поле не
 
 <center><img src="../media/image274.png"/></center>
 
-<center>Рис. 7. Поля для настройки действия «Работа со вкладками»</center>
+<center>Рис. 10. Поля для настройки действия «Работа со вкладками»</center>
 
 Доступные действия для работы с вкладками:
 

docs/clicker.md

@@ -273,12 +273,19 @@
 
 <center>Рис. 9. Действие «Нажать кнопку»</center>
 
-#### Действие «Нажать две кнопки»
+#### Действие «Нажать несколько кнопок»
 
-Имитирует нажатие сочетания двух клавиш клавиатуры, например CTRL+A –
-выделение всего текста в поле. Необходимые кнопки выбираются в двух
-выпадающих списках «Кнопка». Список кнопок тот же, что и в действии
-«Нажать кнопку».
+Имитирует нажатие сочетания клавиш клавиатуры, например CTRL+A – 
+выделение всего текста в поле. Необходимые кнопки выбираются 
+выпадающем списке «Кнопка» и добавляются в табличную часть под 
+ним. Список кнопок тот же, что и в действии «Нажать кнопку».
+
+<center><img src="../media/image386.png"/></center>
+
+<center>Рис. 10. Действие «Нажать несколько кнопок»</center>
+
+По кнопке «Добавить» под списком выбранных кнопок действие 
+добавится в общий список действий.
 
 #### Действие «Скопировать»
 
@@ -298,6 +305,12 @@
 дающегося на обнаружение ошибки (значение поля «Кол-во попыток»
 умноженное на значение поля «Пауза между ошибками»).
 
+
+#### Действие «Получить текст из поля»
+Получает текст из поля на экране, которое ищется по XPath и записывает 
+в указанную переменную.
+
+
 ##  Модуль «Поиск изображения»
 
 Модуль «Поиск изображения», в основном, используется в связке с модулем

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-цы) или названием.
 
 <center><img src="../media/image87.png"/></center>
 
@@ -344,7 +353,8 @@ Excel. Начните с создания действия «Формула» д
 
 #### Действие «Удалить столбец»
 
-Действие удаляет указанный столбец.
+Действие удаляет указанный столбец. Столбец может быть указан числом (с 1-цы) 
+или названием.
 
 <center><img src="../media/image88.png"/></center>
 
@@ -397,6 +407,9 @@ Excel. Начните с создания действия «Формула» д
 массивом чисел, где индекс массива будет соответствовать индексу 
 указанной колонки. 
 
+В качестве столбцов можно указывать их название или порядковый номер 
+с 1-цы.
+
 <center><img src="../media/image92.png"/></center>
 
 <center>Рис. 30. Пример настройки действия «Уровень группировки столбца»</center>
@@ -754,7 +767,8 @@ PDF будет производиться по стандартным настр
 фильтрации, указано в поле «Значение».
 
 Если необходимо просто включить фильтр в таблице, но без определенной
-фильтрации, то нужно оставить поле «Функция» пустым.
+фильтрации, то нужно оставить поле «Функция» пустым. Если нужно отфильтровать 
+по пустым значениям, необходимо в поле «Значение» вписать «null» или «(пусто)».
 
 <center><img src="../media/image106.png" /></center>
 
@@ -774,6 +788,10 @@ PDF будет производиться по стандартным настр
 столбцу. В зависимости от флажка определяется, сортируется столбец по
 убыванию или по возрастанию. Столбец для сортировки должен быть один.
 
+Если необходимо отсортировать по нескольким колонкам – добавьте несколько 
+действий сортировки по всем необходимым столбцам внутри одного модуля Excel 
+и они все будут одновременно применены.
+
 <center><img src="../media/image108.png"/></center>
 
 <center>Рис. 50. Пример настройки действия «Добавление сортировки»</center>

docs/file_module.md

@@ -140,6 +140,8 @@
 представленном примере –
 C:\\Users\\user\\Desktop\\Документы\\text.docx).
 
+Если файл в конечной директории уже существует – он будет перезаписан.
+
 <center><img src="../media/image203.png"/></center>
 
 <center>Рис. 9. Пример настройки действия «Перемещение файла»</center>
@@ -148,6 +150,8 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
 
 Действие меняет имя выбранного файла на указанное в поле «Имя файла».
 
+Если файл с таким же именем уже существует – он будет перезаписан.
+
 <center><img src="../media/image204.png"/></center>
 
 <center>Рис. 10. Пример настройки действия «Переименовать файл»</center>
@@ -159,6 +163,8 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
 Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено 
 расположение созданного файла.
 
+Если файл с таким именем уже существует – он будет перезаписан.
+
 <center><img src="../media/image205.png" /></center>
 
 <center>Рис. 11. Пример настройки действия «Создать файл»</center>
@@ -182,6 +188,8 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
 Если поле «Переменная» будет заполнено, то в указанную в нем переменную
 будет возвращено расположение нового файла.
 
+Если файл с таким именем уже существует – он будет перезаписан.
+
 <center><img src="../media/image207.png"/></center>
 
 <center>Рис. 13. Пример настройки действия «Скопировать файл»</center>
@@ -203,6 +211,9 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
 заполнено, то в указанную в нем переменную будет возвращено новое
 расположение перемещаемой папки.
 
+Если папка с таким именем в конечной папке уже существует – программа выдаст 
+ошибку и не переместит папку.
+
 <center><img src="../media/image209.png"/></center>
 
 <center>Рис. 15. Пример настройки действия «Перемещение папки»</center>
@@ -213,6 +224,10 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
 Если поле «Переменная» будет заполнено, то в указанную в нем переменную
 будет возвращено расположение новой папки.
 
+Если создаваемая папка уже существует – программа не создаст новую папку 
+и не выдаст ошибку. Перед созданием папки проверяйте её наличие другими 
+действиями модуля.
+
 <center><img src="../media/image210.png"/></center>
 
 <center>Рис. 16. Пример настройки действия «Создание папки»</center>
@@ -251,6 +266,8 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
 указанную в нем переменную будет возвращено расположение созданного
 архива.
 
+Если архив с таким именем уже существует – программа выдаст ошибку.
+
 <center><img src="../media/image214.png"/></center>
 
 <center>Рис. 20. Пример настройки действия «Заархивировать папку»</center>

docs/index.md

@@ -84,12 +84,7 @@ Lexema-RPA Studio, далее именуемая просто студия, пр
 ## С чего начать
 
 Для начала работы скачайте студию Lexema-RPA Studio ***на сайте**
-<http://lexema.ru/lexemarpastudio/registratsiya/>*. Перед началом
-скачивания вам будет предложена регистрация. Регистрация на сайте
-обязательна, так как доступ в студию осуществляется после авторизации
-пользователя. После окончания регистрации начнется скачивание
-установщика.
-
+<https://www.lexema.ru/solutions/lexema-rpa-programmnye-roboty/lexema-rpa-studio/>*. 
 После этого запустите установщик и в открывшемся диалоговом окне нажмите
 на кнопку «Next».
 
@@ -121,8 +116,12 @@ Lexema-RPA Studio, далее именуемая просто студия, пр
 [ссылке](https://dotnet.microsoft.com/download/dotnet-framework/net472)
 (Центр загрузки Windows).
 
-После запуска программы появится окно авторизации, в которое следует
-ввести логин и пароль, указанные при регистрации.
+После запуска программы появится окно авторизации, в которое следует 
+ввести логин и пароль, указанные при регистрации. Если вы не зарегистрированы, 
+то это можно сделать при запуске программы, нажав на кнопку «Регистрация» 
+внизу окна. Регистрация пользователя является обязательной. После окончания 
+регистрации необходимо ввести зарегистрированные логин и пароль в 
+соответствующие поля и войти в студию для работы.
 
 <img src="media\image8.png" style="width:3.11308in;height:3.90567in" />
 

docs/operators.md

@@ -1,4 +1,4 @@
-#  МОДУЛИ-ОПЕРАТОРЫ: «ЦИКЛ», «УСЛОВИЕ», «WHILE», «TRY-CATCH», «BREAK», «RETURN», «SWITCH»
+#  МОДУЛИ-ОПЕРАТОРЫ: «ЦИКЛ FOR», «УСЛОВИЕ», «ЦИКЛ WHILE», «TRY-CATCH», «BREAK», «RETURN», «SWITCH»
 
 ##  Модуль «Условие»
 
@@ -121,9 +121,9 @@
 
 <center>Рис. 12. Свернутые THEN и ELSE</center>
 
-##  Модуль «Цикл»
+##  Модуль «Цикл FOR»
 
-Модуль «Цикл» применяется для неоднократного (цикличного) выполнения
+Модуль «Цикл FOR» применяется для неоднократного (цикличного) выполнения
 набора действий. Действия, добавленные в модуль, будут выполняться до
 тех пор, пока не пройдёт указанное в настройках количество итераций.
 
@@ -256,9 +256,9 @@ Excel-файл. Но что, если этих писем нет? Для это
 есть, без модуля Continue пришлось бы все действия над файлом делать
 внутри ветки ELSE модуля «Условие»).
 
-##  Модуль «While»
+##  Модуль «Цикл While»
 
-Модуль «While» (цикл с условием) выполняет добавленные в него действия
+Модуль «Цикл While» (цикл с условием) выполняет добавленные в него действия
 до тех пор, пока указанное условие возвращает значение «True».
 
 ### Интерфейс модуля

docs/word.md

@@ -15,7 +15,7 @@ Microsoft Office. С помощью модуля можно создавать
 действия для работы с файлом, и третья – окно с предварительным
 просмотром загруженного файла.
 
-<center><img src="../media/image163.png" style="width:6.69306in;height:3.95486in" /></center>
+<center><img src="../media/image163.png"/></center>
 
 <center>Рис. 1. Интерфейс окна</center>
 
@@ -36,7 +36,7 @@ Microsoft Office. С помощью модуля можно создавать
     применить к загруженному файлу или создать новый с указанным путем в
     поле «Путь к файлу». Обязательное поле;
 
-<center><img src="../media/image164.png" style="width:3.7913in;height:1.43435in" /></center>
+<center><img src="../media/image164.png"/></center>
 
 <center>Рис. 2. Перечень доступных действий модуля</center>
 
@@ -49,7 +49,7 @@ Microsoft Office. С помощью модуля можно создавать
 Для добавления действия в таблицу «Список команд» необходимо
 воспользоваться кнопкой «Добавить» под полями настройки действия.
 
-<center><img src="../media/image165.png" style="width:3.45054in;height:3.72179in" /></center>
+<center><img src="../media/image165.png"/></center>
 
 <center>Рис. 3. Расположение кнопки «Добавить»</center>
 
@@ -63,7 +63,7 @@ Microsoft Office. С помощью модуля можно создавать
 выбрать одно действие и нажать на необходимые кнопки «Поднять» или
 «Опустить», которые расположены в правом углу над таблицей с командами.
 
-<center><img src="../media/image166.png" style="width:4.26957in;height:1.40999in" /></center>
+<center><img src="../media/image166.png"/></center>
 
 <center>Рис. 4. Кнопки «Поднять/Опустить» и выбор строки в таблице</center>
 
@@ -76,7 +76,7 @@ Microsoft Office. С помощью модуля можно создавать
 типа «*Путь до файла*/*Название файла*.*Требуемое расширение*»,
 например, «C:/Reports/Documents/Test.docx».
 
-<center><img src="../media/image167.png" style="width:4.15652in;height:1.03714in" /></center>
+<center><img src="../media/image167.png"/></center>
 
 <center>Рис. 5. Пример заполнения действия «Создать файл»</center>
 
@@ -87,7 +87,7 @@ Microsoft Office. С помощью модуля можно создавать
 помимо стандартных трёх – «Переменная», в которую записывается название
 переменной (с символов «v.»), в которую будет записан считанный текст.
 
-<center><img src="../media/image168.png" style="width:4.44156in;height:2.63482in" /></center>
+<center><img src="../media/image168.png"/></center>
 
 <center>Рис. 6. Пример настройки действия «Получить текст»</center>
 
@@ -100,7 +100,7 @@ Microsoft Office. С помощью модуля можно создавать
 текст, введенный данным действием, полностью затрет существующий текст в
 файле.
 
-<center><img src="../media/image169.png" style="width:3.89565in;height:2.26509in" /></center>
+<center><img src="../media/image169.png"/></center>
 
 <center>Рис. 7. Пример настройки действия «Записать текст»</center>
 
@@ -115,7 +115,7 @@ Microsoft Office. С помощью модуля можно создавать
 обозначающего, после какого по счету символа необходимо вставить текст
 (с учетом пробелом и символов переноса строки или разрыва страницы).
 
-<center><img src="../media/image170.png" style="width:4.79221in;height:2.85141in" /></center>
+<center><img src="../media/image170.png"/></center>
 
 <center>Рис. 8. Пример настройки действия «Добавить текст»</center>
 
@@ -139,7 +139,7 @@ HEX – шестнадцатеричное представление RGB.
 Данное действие добавляет символ переноса строки в файл. Не требует
 заполнения дополнительных полей.
 
-<center><img src="../media/image171.png" style="width:3.65217in;height:2.14382in" /></center>
+<center><img src="../media/image171.png"/></center>
 
 <center>Рис. 9. Пример настройки действия добавление перехода на новую строку</center>
 
@@ -151,7 +151,7 @@ HEX – шестнадцатеричное представление RGB.
 номер символа, после которого необходимо удалить текст, а второе –
 количество символов в удаляемом тексте.
 
-<center><img src="../media/image172.png" style="width:4.05217in;height:1.35332in" /></center>
+<center><img src="../media/image172.png"/></center>
 
 <center>Рис. 10. Пример настройки действия «Удалить текст»</center>
 
@@ -162,6 +162,30 @@ HEX – шестнадцатеричное представление RGB.
 файла, в который нужно экспортировать, и указать путь с названием и
 расширением будущего файла в поле «Путь выходного файла».
 
-<center><img src="../media/image173.png" style="width:3.85217in;height:2.27426in" /></center>
+<center><img src="../media/image173.png"/></center>
 
-<center>Рис. 11. Пример настройки действия «Экспорт»</center>
+<center>Рис. 11. Пример настройки действия «Экспорт»</center>
+
+#### Найти слово
+
+Данное действие ищет слово или словосочетание (его точное совпадение) 
+в тексте и возвращает все его вхождения в тексте в виде массива 
+объектов (или таблицы с именованными колонками). Возвращаемые поля:
+
+-   start – начальный символ слова или словосочетания;
+
+-   end – конечный символ слова или словосочетания;
+
+-   text – искомое слово или словосочетание вместе с прилегающими к нему символами;
+
+-   pageNum – номер страницы, на которой было найдено слово или словосочетание.
+
+<center><img src="../media/image387.png"/></center>
+
+<center>Рис. 12. Пример настройки действия Найти слово</center>
+
+Результат поиска будет выглядеть следующим образом: 
+
+<center><img src="../media/image388.png"/></center>
+
+<center>Рис. 13. Пример результирующей переменной </center>

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'