5.14.1.0

docs/browser.md

@@ -2,10 +2,11 @@
 
 ##  Основные моменты модуля
 
-Модуль «Работа с браузером» построен на базе Selenium WebDriver и
-позволяет реализовывать основные методы работы со страницей браузера –
-открыть вкладку, перейти на вкладку, найти элемент на странице по её
-ключу и как-то его обработать.
+Модуль «Работа с браузером» позволяет работать на данный момент с двумя 
+веб-браузерами – Google Chrome и Mozilla Firefox. Он построен на базе 
+Selenium WebDriver  и позволяет реализовывать основные методы работы со 
+страницей браузера – открыть вкладку, перейти на вкладку, найти элемент на 
+странице по её ключу и как-то его обработать.
 
 ### Интерфейс модуля
 
@@ -17,7 +18,7 @@
 поле «Действие». Группа кнопок состоит из трех кнопок – «Добавить»,
 «Редактировать» и «Удалить».
 
-<center><img src="../media/image268.png" style="width:5.08322in;height:4.21578in" /></center>
+<center><img src="../media/image268.png" /></center>
 
 <center>Рис. 1. Окно модуля «Работа с браузером»</center>
 
@@ -83,6 +84,37 @@
 «C:\\Users\\ИмяПользователя\\AppData\\Local\\Google\\Chrome\\User
 Data»).
 
+**Поле «Путь до браузера»** необходимо в случаях особого использования 
+браузера (другой экземпляр, нестандартный Chrome) или браузеров на основе 
+chromium (например, chromium-gost). Если данное поле не заполнено, то берется 
+адрес Google Chrome из реестра Windows. Если по каким-то причинам получить 
+значение не удалось, берется значение из конфига Lexema RPA Studio.
+
+### Драйвера для работы с браузерами
+При работе с ***Google Chrome*** модуль работает на драйвере chromedriver, 
+который требует обновления при каждом повышении версии браузера, с которым 
+работает. При запуске модуля, если драйвер устарел, программа выдаст одну из ошибок:
+
+- «Версия chromedriver отличалась от версии браузера. Было выполнено обновление, 
+запустите скрипт еще раз» - программе удалось самостоятельно обновить драйвер, 
+в этом случае необходимо запустить робота еще раз;
+
+- «Версия драйвера не соответствует версии браузера. Обновите chromedriver в папке 
+с программой, скачав его по ссылке - https://chromedriver.storage.googleapis.com/{номер версии}/chromedriver_win32.zip» - 
+программе не удалось самостоятельно обновить драйвер, но удалось определить необходимую 
+для вашего браузера версию, необходимо следовать инструкции в описании ошибки;
+
+- «Версия драйвера не соответствует версии браузера. Обновите chromedriver в 
+папке с программой, скачав его по ссылке - https://chromedriver.chromium.org/» - 
+программе не удалось самостоятельно обновить драйвер, необходимо самостоятельно 
+определить версию вашего браузера и найти на указанной сылке соответствующую версию 
+драйвера, затем скачать chromedriver_win32.zip и распаковать в папку с Lexema-RPA Studio.
+
+При работе с ***Mozilla Firefox*** модуль работает на драйвере geckodriver, который так же 
+зависит от версии используемого драйвера. Данный драйвер необходимо обновлять самостоятельно, 
+для этого нужно перейти по ссылке https://github.com/mozilla/geckodriver/releases, найти 
+интересующую версию, найти в ней раздел Assets, скачать geckodriver-номер_версии-win32.zip и 
+распаковать в папку с Lexema-RPA Studio.
 
 ##  Описание действий
 
@@ -102,6 +134,11 @@ Data»).
 действий этого модуля. Подробнее о них будет рассказываться в следующей
 главе.
 
+**Поле «Пауза»** — ожидает указанное количество миллисекунд после выполнения действия. 
+
+**Поле «Скриншот»** — при установленной галочке делает скриншот после выполнения 
+команды и сохраняет его в папку screen, находящуюся в папке с программой. 
+
 **Поле «Примечание»** — строка с примечанием к команде.
 
 ### Перечень и описание действий
@@ -112,7 +149,7 @@ Data»).
 области создания команды откроется поле – «URL». URL необходимо вводить
 с протоколом, т.е. с http/https.
 
-<center><img src="../media/image270.png" style="width:6.40121in;height:1.9375in" /></center>
+<center><img src="../media/image270.png"/></center>
 
 <center>Рис. 3. Пример настройки действия «Перейти»</center>
 
@@ -147,7 +184,7 @@ Data»).
 элемента». Еще два поля – «Свойство» и «Переменная» становятся
 доступными в зависимости от выбора действия на странице.
 
-<center><img src="../media/image271.png" style="width:6.87071in;height:2.07738in" /></center>
+<center><img src="../media/image271.png"/></center>
 
 <center>Рис. 4. Поля для настройки действия «Работа со страницей»</center>
 
@@ -312,7 +349,7 @@ Data»).
 
 Пример заполненного действия:
 
-<center><img src="../media/image273.png" style="width:6.59203in;height:1.97917in" /></center>
+<center><img src="../media/image273.png" /></center>
 
 <center>Рис. 6. Пример настройки действия «Работа со страницей»</center>
 
@@ -326,7 +363,7 @@ Data»).
 настройки действия открывается как минимум одно поле – «Действие»,
 остальные открываются в зависимости от выбранного в нем действия.
 
-<center><img src="../media/image274.png" style="width:6.6522in;height:1.97917in" /></center>
+<center><img src="../media/image274.png"/></center>
 
 <center>Рис. 7. Поля для настройки действия «Работа со вкладками»</center>
 

docs/excel.md

@@ -1446,6 +1446,16 @@ A1:A5 только действительные числа, находящиес
 
 <center>Рис. 87. Пример настройки действия «Получить цвет ячейки»</center>
 
+#### Действие «Сделать гиперссылкой
+
+Действие делает уже заполненную ячейку гиперссылкой. Если поле «Значение» заполнено, 
+то гиперссылка будет иметь название, указанное в ней, иначе оно будет равняться значению в ячейке. 
+Доступно использование диапазона, однако название может лишь одно.
+
+<center><img src="../media/image372.png" /></center>
+
+<center>Рис. 88. Пример настройки действия «Сделать гиперссылкой»</center>
+
 #### Действие «Ширина столбца(-ов)»
 
 Действие изменяет ширину указанных столбцов. Столбцы можно перечислять
@@ -1454,25 +1464,25 @@ A1:A5 только действительные числа, находящиес
 
 <center><img src="../media/image134.png" style="width:6.52778in;height:1.25in" /></center>
 
-<center>Рис. 88. Пример настройки действия «Ширина столбца(-ов)»</center>
+<center>Рис. 89. Пример настройки действия «Ширина столбца(-ов)»</center>
 
 **ПРИМЕР.**
 
-На рисунке 88 представлено, как заполнить действие для установки ширины
+На рисунке 89 представлено, как заполнить действие для установки ширины
 столбцов B и C в 16 пунктов. В поле «Столбцы» можно было бы написать
 «2,3», то есть второй и третий столбцы.
 
-Исходные данные представлены на рисунке 89:
+Исходные данные представлены на рисунке 90:
 
 <center><img src="../media/image135.png" style="width:3.24931in;height:1.10347in" /></center>
 
-<center>Рис. 89. Пример исходных данных</center>
+<center>Рис. 90. Пример исходных данных</center>
 
-Результат работы представлен на рисунке 90:
+Результат работы представлен на рисунке 91:
 
 <center><img src="../media/image136.png" style="width:3.96806in;height:1.16597in" /></center>
 
-<center>Рис. 90. Результат выполнения действия «Ширина столбца(-ов)»</center>
+<center>Рис. 91. Результат выполнения действия «Ширина столбца(-ов)»</center>
 
 #### Действие «Высота строки (-ок)»
 
@@ -1481,24 +1491,24 @@ A1:A5 только действительные числа, находящиес
 
 <center><img src="../media/image137.png" style="width:6.82829in;height:1.33333in" /></center>
 
-<center>Рис. 91. Пример настройки действия «Высота строки(-ок)»</center>
+<center>Рис. 92. Пример настройки действия «Высота строки(-ок)»</center>
 
 **ПРИМЕР.**
 
 Изменим высоту первой строки, сделав её равной 30 пунктам. Для этого
-заполняем действие так, как указано на рисунке 91.
+заполняем действие так, как указано на рисунке 92.
 
-Исходные данные представлены на рисунке 92:
+Исходные данные представлены на рисунке 93:
 
 <center><img src="../media/image138.png" style="width:3.58264in;height:1.06667in" /></center>
 
-<center>Рис. 92. Пример исходных данных</center>
+<center>Рис. 93. Пример исходных данных</center>
 
-Результат работы робота представлен на рисунке 93:
+Результат работы робота представлен на рисунке 94:
 
 <center><img src="../media/image139.png" style="width:3.66667in;height:1.17431in" /></center>
 
-<center>Рис. 93. Результат выполнения действия «Высота строки(-ок)»</center>
+<center>Рис. 94. Результат выполнения действия «Высота строки(-ок)»</center>
 
 #### Действие «Объединить ячейки»
 
@@ -1514,24 +1524,24 @@ A1:A5 только действительные числа, находящиес
 
 <center><img src="../media/image140.png" style="width:6.36458in;height:1.2624in" /></center>
 
-<center>Рис. 94. Пример настройки действия «Объединить ячейки»</center>
+<center>Рис. 95. Пример настройки действия «Объединить ячейки»</center>
 
 **ПРИМЕР.**
 
-На рисунке 94 представлено заполнение действия для объединения
+На рисунке 95 представлено заполнение действия для объединения
 колонок в диапазоне ячеек A2:C4.
 
-Исходные данные представлены на рисунке 95:
+Исходные данные представлены на рисунке 96:
 
 <center><img src="../media/image141.png" style="width:3.30694in;height:1.90903in" /></center>
 
-<center>Рис. 95. Пример исходных данных</center>
+<center>Рис. 96. Пример исходных данных</center>
 
 Результат работы представлен на рисунке 96:
 
 <center><img src="../media/image142.png" style="width:3.6875in;height:1.42153in" /></center>
 
-<center>Рис. 96. Результат выполнения действия «Объединить ячейки»</center>
+<center>Рис. 97. Результат выполнения действия «Объединить ячейки»</center>
 
 ***Действие «Получить объединенные ячейки»***
 
@@ -1541,7 +1551,7 @@ A1:A5 только действительные числа, находящиес
  
 <center><img src="../media/image371.png"/></center>
 
-<center>Рис. 97. Пример настройки действия «Получить объединенные ячейки»</center>
+<center>Рис. 98. Пример настройки действия «Получить объединенные ячейки»</center>
 
 Например, для ячеек «B2», «B3» и «B4» с рисунка 96 результатом будет «B2:B4», а для ячейки B1 – null.
 
@@ -1552,25 +1562,25 @@ A1:A5 только действительные числа, находящиес
 
 <center><img src="../media/image143.png" style="width:3.59375in;height:1.42199in" /></center>
 
-<center>Рис. 98. Пример настройки действия «Очистить форматирование»</center>
+<center>Рис. 99. Пример настройки действия «Очистить форматирование»</center>
 
 **ПРИМЕР.**
 
 Очистим форматирование, которое содержится в диапазоне A17:C19. Для
-этого заполним действие так, как указано на рисунке 98 и запустим
+этого заполним действие так, как указано на рисунке 99 и запустим
 робота.
 
-Исходные данные представлены на рисунке 99:
+Исходные данные представлены на рисунке 100:
 
 <center><img src="../media/image144.png" style="width:4.00972in;height:0.92639in" /></center>
 
-<center>Рис. 99. Пример исходных данных</center>
+<center>Рис. 100. Пример исходных данных</center>
 
-Результат работы представлен на рисунке 100
+Результат работы представлен на рисунке 101
 
 <center><img src="../media/image145.png" style="width:3.99931in;height:1.02014in" /></center>
 
-<center>Рис. 100. Результат выполнения действия «Очистить форматирование»</center>
+<center>Рис. 101. Результат выполнения действия «Очистить форматирование»</center>
 
 ***Действие «Формат ячейки»***
 
@@ -1581,7 +1591,7 @@ A1:A5 только действительные числа, находящиес
 
 <center><img src="../media/image146.png" style="width:6.57242in;height:1.30208in" /></center>
 
-<center>Рис. 101. Пример настройки действия «Формат ячейки»</center>
+<center>Рис. 102. Пример настройки действия «Формат ячейки»</center>
 
 #### Действие «Формат числа»
 
@@ -1590,7 +1600,7 @@ Excel.
 
 <center><img src="../media/image147.png" style="width:6.61719in;height:1.3125in" /></center>
 
-<center>Рис. 102. Пример настройки действия «Формат числа»</center>
+<center>Рис. 103. Пример настройки действия «Формат числа»</center>
 
 Примеры форматов можно посмотреть в программе Excel, кликнув правой
 кнопкой левой кнопкой мыши по ячейке – «Формат ячейки» – вкладка «Число»
@@ -1598,31 +1608,31 @@ Excel.
 
 <center><img src="../media/image148.png" style="width:6.15069in;height:4.44792in" /></center>
 
-<center>Рис. 103. Просмотр примеров форматов числа в Excel</center>
+<center>Рис. 104. Просмотр примеров форматов числа в Excel</center>
 
 Наиболее часто используемые форматы числа предлагаются в студии при
 наведении на поле для ввода формата.
 
 <center><img src="../media/image149.png" style="width:6.87263in;height:2.07292in" /></center>
 
-<center>Рис. 104. Просмотр примеров форматов числа в студии</center>
+<center>Рис. 105. Просмотр примеров форматов числа в студии</center>
 
 **ПРИМЕР.**
 
 Отформатируем число, содержащееся в ячейке A1 в денежный долларовый
-формат. Для этого заполним действие так, как указано на рисунке 104.
+формат. Для этого заполним действие так, как указано на рисунке 105.
 
-Исходные данные представлены на рисунке 105:
+Исходные данные представлены на рисунке 106:
 
 <center><img src="../media/image150.png" style="width:1.59444in;height:1.36181in" /></center>
 
-<center>Рис. 105. Пример исходных данных</center>
+<center>Рис. 106. Пример исходных данных</center>
 
 Результат работы представлен на рисунке ниже:
 
 <center><img src="../media/image151.png" style="width:1.31181in;height:1.19722in" /></center>
 
-<center>Рис. 106. Результат выполнения действия «Формат числа»</center>
+<center>Рис. 107. Результат выполнения действия «Формат числа»</center>
 
 #### Действие «Получить тип ячейки»
 
@@ -1634,7 +1644,7 @@ Excel.
  
 <center><img src="../media/image370.png"/></center>
 
-<center>Рис. 107. Пример заполнения действия «Получить тип ячейки»</center>
+<center>Рис. 108. Пример заполнения действия «Получить тип ячейки»</center>
 
 
 #### Действие «Выравнивание»
@@ -1648,24 +1658,24 @@ Excel.
 
 <center><img src="../media/image152.png" style="width:6.92359in;height:1.34375in" /></center>
 
-<center>Рис. 108. Пример настройки действия «Выравнивание»</center>
+<center>Рис. 109. Пример настройки действия «Выравнивание»</center>
 
 **ПРИМЕР.**
 
-В заполненном на рисунке 108 действии настраивается выравнивание
+В заполненном на рисунке 109 действии настраивается выравнивание
 ячейки А1 по центру относительно вертикали.
 
-Исходное положение текста в ячейке представлено на рисунке 109:
+Исходное положение текста в ячейке представлено на рисунке 110:
 
 <center><img src="../media/image153.png" style="width:3.51181in;height:1.03889in" /></center>
 
-<center>Рис. 109. Пример исходных данных</center>
+<center>Рис. 110. Пример исходных данных</center>
 
-Результат работы представлен на рисунке 110:
+Результат работы представлен на рисунке 111:
 
 <center><img src="../media/image154.png" style="width:3.925in;height:0.85417in" /></center>
 
-<center>Рис. 110. Результат выполнения действия «Выравнивание»</center>
+<center>Рис. 111. Результат выполнения действия «Выравнивание»</center>
 
 #### Действие «Перенос текста»
 
@@ -1675,7 +1685,7 @@ Excel.
 
 <center><img src="../media/image155.png" style="width:3.72727in;height:1.46941in" /></center>
 
-<center>Рис. 111. Пример настройки действия «Перенос текста»</center>
+<center>Рис. 112. Пример настройки действия «Перенос текста»</center>
 
 #### Действие «Шрифт»
 
@@ -1685,25 +1695,25 @@ Excel.
 
 <center><img src="../media/image156.png" style="width:7.02838in;height:1.35417in" /></center>
 
-<center>Рис. 112. Пример настройки действия «Изменение шрифта»</center>
+<center>Рис. 113. Пример настройки действия «Изменение шрифта»</center>
 
 **ПРИМЕР.**
 
 Изменим шрифт текста, находящегося в ячейке B1 так, как указано в
-действии на рисунке 112 – сам шрифт изменим на Batang, зададим стиль
+действии на рисунке 113 – сам шрифт изменим на Batang, зададим стиль
 текста – полужирный курсив, а размер текста 16.
 
-Исходное форматирование текста представлен на рисунке 113:
+Исходное форматирование текста представлен на рисунке 114:
 
 <center><img src="../media/image157.png" style="width:3.85347in;height:0.81181in" /></center>
 
-<center>Рис. 113. Пример исходных данных</center>
+<center>Рис. 114. Пример исходных данных</center>
 
-Результат работы представлен на рисунке 114:
+Результат работы представлен на рисунке 115:
 
 <center><img src="../media/image158.png" style="width:3.81181in;height:0.80139in" /></center>
 
-<center>Рис. 114. Результат выполнения действия «Шрифт»</center>
+<center>Рис. 115. Результат выполнения действия «Шрифт»</center>
 
 #### Действие «Границы»
 
@@ -1714,25 +1724,25 @@ Excel.
 
 <center><img src="../media/image159.png" style="width:6.69306in;height:1.35556in" /></center>
 
-<center>Рис. 115. Пример настройки действия «Границы»</center>
+<center>Рис. 116. Пример настройки действия «Границы»</center>
 
 **ПРИМЕР.**
 
 Добавим штрихпунктирную внешнюю границу для блока текста, находящегося в
 диапазоне A2:A6. Для этого необходимо заполнить действие так, как
-указано на рисунке 115.
+указано на рисунке 116.
 
-Исходный вид блока текста представлен на рисунке 116:
+Исходный вид блока текста представлен на рисунке 117:
 
 <center><img src="../media/image160.png" style="width:2.64514in;height:1.70764in" /></center>
 
-<center>Рис. 116. Пример исходных данных</center>
+<center>Рис. 117. Пример исходных данных</center>
 
-Результат работы представлен на рисунке 116:
+Результат работы представлен на рисунке 117:
 
 <center><img src="../media/image161.png" style="width:2.15556in;height:1.74931in" /></center>
 
-<center>Рис. 117. Результат выполнения действия «Границы»</center>
+<center>Рис. 118. Результат выполнения действия «Границы»</center>
 
 ##  Модуль «Закрыть Excel-файл»
 
@@ -1758,7 +1768,7 @@ Excel-модуль работает с файлами следующим обр
 
 <center><img src="../media/image162.png" style="width:4.1348in;height:2.98387in" /></center>
 
-<center>Рис. 118. Окно «Закрыть Excel-файл»</center>
+<center>Рис. 119. Окно «Закрыть Excel-файл»</center>
 
 **Поле «Путь к файлу»** заполняется путем до файла, который необходимо
 закрыть. Он может содержаться в переменной, или можно выбрать его

docs/file_module.md

@@ -152,15 +152,16 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
 
 <center>Рис. 10. Пример настройки действия «Переименовать файл»</center>
 
-#### Действие «Создать файл txt»
+#### Действие «Создать файл»
 
-Действие создает новый файл с расширением .txt. Если поле «Переменная»
-будет заполнено, то в указанную в нем переменную будет возвращено
+Действие создает новый текстовый файл с расширением по умолчанию .txt. 
+Если указано другое расширение, то будет создан файл с соответствующим расширением. 
+Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено 
 расположение созданного файла.
 
-<center><img src="../media/image205.png" style="width:4.1039in;height:1.51423in" /></center>
+<center><img src="../media/image205.png" /></center>
 
-<center>Рис. 11. Пример настройки действия «Создать файл txt»</center>
+<center>Рис. 11. Пример настройки действия «Создать файл»</center>
 
 #### Действие «Удалить файл»
 
@@ -256,9 +257,9 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
 
 #### Действие «Распаковать архив»
 
-Действие распаковывает архив в указанную папку. Поддерживаются 
-типы архивов 7z, zip.
+Действие распаковывает архив в указанную папку. Поддерживаются типы архивов 7z, zip. 
+При наличии пароля он вводится в соответствующее поле «Пароль».
 
-<center><img src="../media/image215.png" style="width:4.42748in;height:1.20833in" /></center>
+<center><img src="../media/image215.png" /></center>
 
 <center>Рис. 21. Пример настройки действия «Распаковать архив»</center>

docs/other.md

@@ -592,3 +592,60 @@ n1 и n2, должна принимать на вход переменную-о
 В поле **«Название переменной»** вводится переменная, в которую будет возвращен результат 
 получения учетной записи или создания новой. Переменная будет являться объектом из 
 двух полей – Username и Password.
+
+##  Модули RuCaptcha
+Lexema-RPA Studio содержит набор модулей, позволяющих вводить капчу на страницах браузера. 
+Данный функционал работает с помощью платного сервиса RuCaptcha - https://rucaptcha.com/.
+
+###  Модуль RuCaptcha загрузить
+Данный модуль необходим для загрузки скриншота с капчей и запуска процесса распознавания символов. 
+ 
+<center><img src="../media/image373.png"  /></center>
+
+<center>Рис. 24. Интерфейс модуля «RuCaptcha загрузка»</center>
+
+Описание полей модуля:
+
+**Ключ API** – вводится ключ, который выдается на сайте сервиса при его покупке;
+
+**Путь к файлу** – путь до скриншота с капчей;
+
+**Id капчи** – необходимо указать переменную для идентификации капчи – по этому идентификатору в последующем будет получен результат;
+
+**Левый верхний угол**, **правый нижний угол** – если вы загрузили скриншот, где не только капча, то необходимо заранее рассчитать координаты левого верхнего и правого нижнего углов капчи. Если же была загружена только капча, то эти поля не нужно заполнять. Формат заполнения – x;y.
+
+###  Модуль RuCaptcha получить ответ
+Данный модуль позволяет получить ответ от сервиса, который был запущен ранее.
+ 
+<center><img src="../media/image374.png"  /></center>
+
+<center>Рис. 25. Интерфейс модуля «RuCaptcha получить ответ»</center>
+
+Описание полей модуля:
+
+**Ключ API** – вводится ключ, который выдается на сайте сервиса при его покупке;
+
+**Результат** – вводится переменная, в которую будет помещен результат распознавания капчи;
+
+**Id капчи** – необходимо указать переменную для идентификации капчи, ту, которая была указана в модуле загрузки капчи.
+
+##  Модуль «Вырезать изображение»
+Данный модуль позволяет изменять размер изображения, задавая координаты левого верхнего и правого нижнего углов интересующего фрагмента.
+ 
+<center><img src="../media/image375.png"  /></center>
+
+<center>Рис. 25. Интерфейс «Вырезать изображение»</center>
+
+Описание полей модуля:
+
+**Путь к файлу** – путь до основного изображения;
+
+**Левый верхний угол** – координаты левого верхнего угла необходимого фрагмента изображения, формат - x;y;
+
+**Правый нижний угол** – координаты правого нижнего угла необходимого фрагмента изображения, формат - x;y;
+
+**Путь сохранения** – путь до папки, куда должен быть сохранен получившийся фрагмент изображения. 
+Может быть указан вместе с итоговым названием файла (должен иметь расширение);
+
+**Название** – название итогового фрагмента изображения, если оно не указано в пути выше. 
+Если расширение не указано, будет сохранен в формате bmp.