diff --git a/docs/browser.md b/docs/browser.md index d39cf46..4aa986a 100644 --- a/docs/browser.md +++ b/docs/browser.md @@ -2,10 +2,11 @@ ## Основные моменты модуля -Модуль «Работа с браузером» построен на базе Selenium WebDriver и -позволяет реализовывать основные методы работы со страницей браузера – -открыть вкладку, перейти на вкладку, найти элемент на странице по её -ключу и как-то его обработать. +Модуль «Работа с браузером» позволяет работать на данный момент с двумя +веб-браузерами – Google Chrome и Mozilla Firefox. Он построен на базе +Selenium WebDriver и позволяет реализовывать основные методы работы со +страницей браузера – открыть вкладку, перейти на вкладку, найти элемент на +странице по её ключу и как-то его обработать. ### Интерфейс модуля @@ -17,7 +18,7 @@ поле «Действие». Группа кнопок состоит из трех кнопок – «Добавить», «Редактировать» и «Удалить». -
+
Рис. 1. Окно модуля «Работа с браузером»
@@ -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. -
+
Рис. 3. Пример настройки действия «Перейти»
@@ -147,7 +184,7 @@ Data»). элемента». Еще два поля – «Свойство» и «Переменная» становятся доступными в зависимости от выбора действия на странице. -
+
Рис. 4. Поля для настройки действия «Работа со страницей»
@@ -312,7 +349,7 @@ Data»). Пример заполненного действия: -
+
Рис. 6. Пример настройки действия «Работа со страницей»
@@ -326,7 +363,7 @@ Data»). настройки действия открывается как минимум одно поле – «Действие», остальные открываются в зависимости от выбранного в нем действия. -
+
Рис. 7. Поля для настройки действия «Работа со вкладками»
diff --git a/docs/excel.md b/docs/excel.md index ee6ceec..de16b5b 100644 --- a/docs/excel.md +++ b/docs/excel.md @@ -1446,6 +1446,16 @@ A1:A5 только действительные числа, находящиес
Рис. 87. Пример настройки действия «Получить цвет ячейки»
+#### Действие «Сделать гиперссылкой + +Действие делает уже заполненную ячейку гиперссылкой. Если поле «Значение» заполнено, +то гиперссылка будет иметь название, указанное в ней, иначе оно будет равняться значению в ячейке. +Доступно использование диапазона, однако название может лишь одно. + +
+ +
Рис. 88. Пример настройки действия «Сделать гиперссылкой»
+ #### Действие «Ширина столбца(-ов)» Действие изменяет ширину указанных столбцов. Столбцы можно перечислять @@ -1454,25 +1464,25 @@ A1:A5 только действительные числа, находящиес
-
Рис. 88. Пример настройки действия «Ширина столбца(-ов)»
+
Рис. 89. Пример настройки действия «Ширина столбца(-ов)»
**ПРИМЕР.** -На рисунке 88 представлено, как заполнить действие для установки ширины +На рисунке 89 представлено, как заполнить действие для установки ширины столбцов B и C в 16 пунктов. В поле «Столбцы» можно было бы написать «2,3», то есть второй и третий столбцы. -Исходные данные представлены на рисунке 89: +Исходные данные представлены на рисунке 90:
-
Рис. 89. Пример исходных данных
+
Рис. 90. Пример исходных данных
-Результат работы представлен на рисунке 90: +Результат работы представлен на рисунке 91:
-
Рис. 90. Результат выполнения действия «Ширина столбца(-ов)»
+
Рис. 91. Результат выполнения действия «Ширина столбца(-ов)»
#### Действие «Высота строки (-ок)» @@ -1481,24 +1491,24 @@ A1:A5 только действительные числа, находящиес
-
Рис. 91. Пример настройки действия «Высота строки(-ок)»
+
Рис. 92. Пример настройки действия «Высота строки(-ок)»
**ПРИМЕР.** Изменим высоту первой строки, сделав её равной 30 пунктам. Для этого -заполняем действие так, как указано на рисунке 91. +заполняем действие так, как указано на рисунке 92. -Исходные данные представлены на рисунке 92: +Исходные данные представлены на рисунке 93:
-
Рис. 92. Пример исходных данных
+
Рис. 93. Пример исходных данных
-Результат работы робота представлен на рисунке 93: +Результат работы робота представлен на рисунке 94:
-
Рис. 93. Результат выполнения действия «Высота строки(-ок)»
+
Рис. 94. Результат выполнения действия «Высота строки(-ок)»
#### Действие «Объединить ячейки» @@ -1514,24 +1524,24 @@ A1:A5 только действительные числа, находящиес
-
Рис. 94. Пример настройки действия «Объединить ячейки»
+
Рис. 95. Пример настройки действия «Объединить ячейки»
**ПРИМЕР.** -На рисунке 94 представлено заполнение действия для объединения +На рисунке 95 представлено заполнение действия для объединения колонок в диапазоне ячеек A2:C4. -Исходные данные представлены на рисунке 95: +Исходные данные представлены на рисунке 96:
-
Рис. 95. Пример исходных данных
+
Рис. 96. Пример исходных данных
Результат работы представлен на рисунке 96:
-
Рис. 96. Результат выполнения действия «Объединить ячейки»
+
Рис. 97. Результат выполнения действия «Объединить ячейки»
***Действие «Получить объединенные ячейки»*** @@ -1541,7 +1551,7 @@ A1:A5 только действительные числа, находящиес
-
Рис. 97. Пример настройки действия «Получить объединенные ячейки»
+
Рис. 98. Пример настройки действия «Получить объединенные ячейки»
Например, для ячеек «B2», «B3» и «B4» с рисунка 96 результатом будет «B2:B4», а для ячейки B1 – null. @@ -1552,25 +1562,25 @@ A1:A5 только действительные числа, находящиес
-
Рис. 98. Пример настройки действия «Очистить форматирование»
+
Рис. 99. Пример настройки действия «Очистить форматирование»
**ПРИМЕР.** Очистим форматирование, которое содержится в диапазоне A17:C19. Для -этого заполним действие так, как указано на рисунке 98 и запустим +этого заполним действие так, как указано на рисунке 99 и запустим робота. -Исходные данные представлены на рисунке 99: +Исходные данные представлены на рисунке 100:
-
Рис. 99. Пример исходных данных
+
Рис. 100. Пример исходных данных
-Результат работы представлен на рисунке 100 +Результат работы представлен на рисунке 101
-
Рис. 100. Результат выполнения действия «Очистить форматирование»
+
Рис. 101. Результат выполнения действия «Очистить форматирование»
***Действие «Формат ячейки»*** @@ -1581,7 +1591,7 @@ A1:A5 только действительные числа, находящиес
-
Рис. 101. Пример настройки действия «Формат ячейки»
+
Рис. 102. Пример настройки действия «Формат ячейки»
#### Действие «Формат числа» @@ -1590,7 +1600,7 @@ Excel.
-
Рис. 102. Пример настройки действия «Формат числа»
+
Рис. 103. Пример настройки действия «Формат числа»
Примеры форматов можно посмотреть в программе Excel, кликнув правой кнопкой левой кнопкой мыши по ячейке – «Формат ячейки» – вкладка «Число» @@ -1598,31 +1608,31 @@ Excel.
-
Рис. 103. Просмотр примеров форматов числа в Excel
+
Рис. 104. Просмотр примеров форматов числа в Excel
Наиболее часто используемые форматы числа предлагаются в студии при наведении на поле для ввода формата.
-
Рис. 104. Просмотр примеров форматов числа в студии
+
Рис. 105. Просмотр примеров форматов числа в студии
**ПРИМЕР.** Отформатируем число, содержащееся в ячейке A1 в денежный долларовый -формат. Для этого заполним действие так, как указано на рисунке 104. +формат. Для этого заполним действие так, как указано на рисунке 105. -Исходные данные представлены на рисунке 105: +Исходные данные представлены на рисунке 106:
-
Рис. 105. Пример исходных данных
+
Рис. 106. Пример исходных данных
Результат работы представлен на рисунке ниже:
-
Рис. 106. Результат выполнения действия «Формат числа»
+
Рис. 107. Результат выполнения действия «Формат числа»
#### Действие «Получить тип ячейки» @@ -1634,7 +1644,7 @@ Excel.
-
Рис. 107. Пример заполнения действия «Получить тип ячейки»
+
Рис. 108. Пример заполнения действия «Получить тип ячейки»
#### Действие «Выравнивание» @@ -1648,24 +1658,24 @@ Excel.
-
Рис. 108. Пример настройки действия «Выравнивание»
+
Рис. 109. Пример настройки действия «Выравнивание»
**ПРИМЕР.** -В заполненном на рисунке 108 действии настраивается выравнивание +В заполненном на рисунке 109 действии настраивается выравнивание ячейки А1 по центру относительно вертикали. -Исходное положение текста в ячейке представлено на рисунке 109: +Исходное положение текста в ячейке представлено на рисунке 110:
-
Рис. 109. Пример исходных данных
+
Рис. 110. Пример исходных данных
-Результат работы представлен на рисунке 110: +Результат работы представлен на рисунке 111:
-
Рис. 110. Результат выполнения действия «Выравнивание»
+
Рис. 111. Результат выполнения действия «Выравнивание»
#### Действие «Перенос текста» @@ -1675,7 +1685,7 @@ Excel.
-
Рис. 111. Пример настройки действия «Перенос текста»
+
Рис. 112. Пример настройки действия «Перенос текста»
#### Действие «Шрифт» @@ -1685,25 +1695,25 @@ Excel.
-
Рис. 112. Пример настройки действия «Изменение шрифта»
+
Рис. 113. Пример настройки действия «Изменение шрифта»
**ПРИМЕР.** Изменим шрифт текста, находящегося в ячейке B1 так, как указано в -действии на рисунке 112 – сам шрифт изменим на Batang, зададим стиль +действии на рисунке 113 – сам шрифт изменим на Batang, зададим стиль текста – полужирный курсив, а размер текста 16. -Исходное форматирование текста представлен на рисунке 113: +Исходное форматирование текста представлен на рисунке 114:
-
Рис. 113. Пример исходных данных
+
Рис. 114. Пример исходных данных
-Результат работы представлен на рисунке 114: +Результат работы представлен на рисунке 115:
-
Рис. 114. Результат выполнения действия «Шрифт»
+
Рис. 115. Результат выполнения действия «Шрифт»
#### Действие «Границы» @@ -1714,25 +1724,25 @@ Excel.
-
Рис. 115. Пример настройки действия «Границы»
+
Рис. 116. Пример настройки действия «Границы»
**ПРИМЕР.** Добавим штрихпунктирную внешнюю границу для блока текста, находящегося в диапазоне A2:A6. Для этого необходимо заполнить действие так, как -указано на рисунке 115. +указано на рисунке 116. -Исходный вид блока текста представлен на рисунке 116: +Исходный вид блока текста представлен на рисунке 117:
-
Рис. 116. Пример исходных данных
+
Рис. 117. Пример исходных данных
-Результат работы представлен на рисунке 116: +Результат работы представлен на рисунке 117:
-
Рис. 117. Результат выполнения действия «Границы»
+
Рис. 118. Результат выполнения действия «Границы»
## Модуль «Закрыть Excel-файл» @@ -1758,7 +1768,7 @@ Excel-модуль работает с файлами следующим обр
-
Рис. 118. Окно «Закрыть Excel-файл»
+
Рис. 119. Окно «Закрыть Excel-файл»
**Поле «Путь к файлу»** заполняется путем до файла, который необходимо закрыть. Он может содержаться в переменной, или можно выбрать его diff --git a/docs/file_module.md b/docs/file_module.md index f2b9c43..4174135 100644 --- a/docs/file_module.md +++ b/docs/file_module.md @@ -152,15 +152,16 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx).
Рис. 10. Пример настройки действия «Переименовать файл»
-#### Действие «Создать файл txt» +#### Действие «Создать файл» -Действие создает новый файл с расширением .txt. Если поле «Переменная» -будет заполнено, то в указанную в нем переменную будет возвращено +Действие создает новый текстовый файл с расширением по умолчанию .txt. +Если указано другое расширение, то будет создан файл с соответствующим расширением. +Если поле «Переменная» будет заполнено, то в указанную в нем переменную будет возвращено расположение созданного файла. -
+
-
Рис. 11. Пример настройки действия «Создать файл txt»
+
Рис. 11. Пример настройки действия «Создать файл»
#### Действие «Удалить файл» @@ -256,9 +257,9 @@ C:\\Users\\user\\Desktop\\Документы\\text.docx). #### Действие «Распаковать архив» -Действие распаковывает архив в указанную папку. Поддерживаются -типы архивов 7z, zip. +Действие распаковывает архив в указанную папку. Поддерживаются типы архивов 7z, zip. +При наличии пароля он вводится в соответствующее поле «Пароль». -
+
Рис. 21. Пример настройки действия «Распаковать архив»
\ No newline at end of file diff --git a/docs/media/image205.png b/docs/media/image205.png index 999e492..0887592 100644 Binary files a/docs/media/image205.png and b/docs/media/image205.png differ diff --git a/docs/media/image215.png b/docs/media/image215.png index 86004bc..a49e4f8 100644 Binary files a/docs/media/image215.png and b/docs/media/image215.png differ diff --git a/docs/media/image268.png b/docs/media/image268.png index 2354a2a..79737d4 100644 Binary files a/docs/media/image268.png and b/docs/media/image268.png differ diff --git a/docs/media/image270.png b/docs/media/image270.png index 7b2b9f9..01df552 100644 Binary files a/docs/media/image270.png and b/docs/media/image270.png differ diff --git a/docs/media/image271.png b/docs/media/image271.png index dd48129..c03426d 100644 Binary files a/docs/media/image271.png and b/docs/media/image271.png differ diff --git a/docs/media/image273.png b/docs/media/image273.png index 3f455ec..8e656c9 100644 Binary files a/docs/media/image273.png and b/docs/media/image273.png differ diff --git a/docs/media/image274.png b/docs/media/image274.png index e6e3f33..fe93fd5 100644 Binary files a/docs/media/image274.png and b/docs/media/image274.png differ diff --git a/docs/media/image372.png b/docs/media/image372.png new file mode 100644 index 0000000..fdb52c8 Binary files /dev/null and b/docs/media/image372.png differ diff --git a/docs/media/image373.png b/docs/media/image373.png new file mode 100644 index 0000000..2cc6ac0 Binary files /dev/null and b/docs/media/image373.png differ diff --git a/docs/media/image374.png b/docs/media/image374.png new file mode 100644 index 0000000..6a1d1e4 Binary files /dev/null and b/docs/media/image374.png differ diff --git a/docs/media/image375.png b/docs/media/image375.png new file mode 100644 index 0000000..fac2da6 Binary files /dev/null and b/docs/media/image375.png differ diff --git a/docs/other.md b/docs/other.md index 689cd42..197d904 100644 --- a/docs/other.md +++ b/docs/other.md @@ -592,3 +592,60 @@ n1 и n2, должна принимать на вход переменную-о В поле **«Название переменной»** вводится переменная, в которую будет возвращен результат получения учетной записи или создания новой. Переменная будет являться объектом из двух полей – Username и Password. + +## Модули RuCaptcha +Lexema-RPA Studio содержит набор модулей, позволяющих вводить капчу на страницах браузера. +Данный функционал работает с помощью платного сервиса RuCaptcha - https://rucaptcha.com/. + +### Модуль RuCaptcha загрузить +Данный модуль необходим для загрузки скриншота с капчей и запуска процесса распознавания символов. + +
+ +
Рис. 24. Интерфейс модуля «RuCaptcha загрузка»
+ +Описание полей модуля: + +**Ключ API** – вводится ключ, который выдается на сайте сервиса при его покупке; + +**Путь к файлу** – путь до скриншота с капчей; + +**Id капчи** – необходимо указать переменную для идентификации капчи – по этому идентификатору в последующем будет получен результат; + +**Левый верхний угол**, **правый нижний угол** – если вы загрузили скриншот, где не только капча, то необходимо заранее рассчитать координаты левого верхнего и правого нижнего углов капчи. Если же была загружена только капча, то эти поля не нужно заполнять. Формат заполнения – x;y. + +### Модуль RuCaptcha получить ответ +Данный модуль позволяет получить ответ от сервиса, который был запущен ранее. + +
+ +
Рис. 25. Интерфейс модуля «RuCaptcha получить ответ»
+ +Описание полей модуля: + +**Ключ API** – вводится ключ, который выдается на сайте сервиса при его покупке; + +**Результат** – вводится переменная, в которую будет помещен результат распознавания капчи; + +**Id капчи** – необходимо указать переменную для идентификации капчи, ту, которая была указана в модуле загрузки капчи. + +## Модуль «Вырезать изображение» +Данный модуль позволяет изменять размер изображения, задавая координаты левого верхнего и правого нижнего углов интересующего фрагмента. + +
+ +
Рис. 25. Интерфейс «Вырезать изображение»
+ +Описание полей модуля: + +**Путь к файлу** – путь до основного изображения; + +**Левый верхний угол** – координаты левого верхнего угла необходимого фрагмента изображения, формат - x;y; + +**Правый нижний угол** – координаты правого нижнего угла необходимого фрагмента изображения, формат - x;y; + +**Путь сохранения** – путь до папки, куда должен быть сохранен получившийся фрагмент изображения. +Может быть указан вместе с итоговым названием файла (должен иметь расширение); + +**Название** – название итогового фрагмента изображения, если оно не указано в пути выше. +Если расширение не указано, будет сохранен в формате bmp.