diff --git a/docs/browser.md b/docs/browser.md index 1f3964a..899583c 100644 --- a/docs/browser.md +++ b/docs/browser.md @@ -58,6 +58,17 @@ **Поля «Proxy Server» - «Proxy Password»** предназначены для ввода настроек прокси-сервера, если это необходимо. +**Поле «Аргументы»** - если необходим запуск браузера с некоторыми +аргументами, например, открыть с определенным языком или через режим +инкогнито (нужные можно найти на просторах интернета), то эти аргументы +должны вводиться в это поле. + +**Поле «Агент»** предназначено для продвинутых пользователей – оно +отвечает за User Agent (идентификационная строка клиентского приложения, +использующая определённый сетевой протокол), под которых будет запущен +браузер. Если поле пустое, то агент будет считываться из конфига +программы, где указано его значение по умолчанию. + **Поле «Путь до папки с профилями пользователя»** - для того, чтобы запустить не новый экземпляр браузера, а с авторизованным профилем (с сохранением истории браузера, авторизацией на сайтах и другое) @@ -72,11 +83,6 @@ «C:\\Users\\ИмяПользователя\\AppData\\Local\\Google\\Chrome\\User Data»). -**Поле «Агент»** предназначено для продвинутых пользователей – оно -отвечает за User Agent (идентификационная строка клиентского приложения, -использующая определённый сетевой протокол), под которых будет запущен -браузер. Если поле пустое, то агент будет считываться из конфига -программы, где указано его значение по умолчанию. ## Описание действий diff --git a/docs/excel.md b/docs/excel.md index aa69bea..7aec1ba 100644 --- a/docs/excel.md +++ b/docs/excel.md @@ -378,7 +378,6 @@ Действие позволяет записать формулу в указанную ячейку (или в диапазон) и вернуть её результат в указанную переменную. Поле «Переменная» можно оставить пустым, если результат выполнения данной формулы не важен. -Результат будет являться строкой. <center><img src="../media/image75.png" style="width:6.69306in;height:1.32222in" /></center> @@ -560,8 +559,9 @@ Excel. Начните с создания действия «Формула» д #### Действие «Уровень группировки столбца» -Данное действие позволяет получить уровень группы указанного столбца и -записать его в переменную. +Действие позволяет получить уровень группировки выбранной колонки, +перечня столбцов через запятую или диапазона столбцов и записать +результат в указанную переменную. Если выбрана одна колонка, то результат будет являться числом, иначе – массивом чисел, где индекс массива будет соответствовать индексу @@ -624,6 +624,179 @@ Excel. Начните с создания действия «Формула» д <center>Рис. 40. Пример настройки действия «Настройки печати»</center> +#### Действие «Режим просмотра книги» + +Действие позволяет выбрать изменять режим отображения данных в книге Excel. +Доступные режимы просмотра – Обычный, Страничный и Разметка. + +<center><img src="../media/image355.png"/></center> + +<center>Рис. 41. Пример настройки действия «Режим просмотра книги»</center> + +#### Действие «Поля» + +Устанавливает заданные поля на конкретном листе. Для настройки +предоставляется три поля – в поле «Лист» указывается лист, для которого +применяются настройки, в поле «Размеры верхнего и нижнего колонтитулов ч/з ;» +при необходимости указываются размеры верхнего и нижнего колонтитулов +соответственно (в см.), в поле «Поля сверху, слева, снизу и справа ч/з ;» +указываются соответствующие поля для каждой из сторон (в см.). +Все перечисления ведутся через символ «;». + +<center><img src="../media/image356.png"/></center> + +<center>Рис. 42. Пример настройки действия «Поля»</center> + +#### Действие «Настройка колонтитулов» + +С помощью данного действия можно заполнять колонтитулы страниц на листе Excel. +Все поля обязательны к заполнению. В поле «Колонтитул» выбирается, к какому +колонтитулу будет применяться данное действие – к верхнему или нижнему. +«Расположение» – одно из трех расположений текста внутри колонтитула – слева, +справа или по центру. «Применимо к страницам» - есть возможность сделать +первый колонтитул особенным, отличным от остальных, а также сделать разные +колонтитулы для четных и нечетных страниц, либо же выбрать «Все» и у всех +страниц будут одинаковые колонтитулы. + +В поле «Значение» вводится строка, которая должна быть вставлена в +колонтитул в выбранное ранее место. Для подстановки в строку динамических +данных, таких как текущая страница, общее количество страниц, дата и время +и прочее используются специальные обозначения. Полный список обозначений +представлен в таблице 1. + +<center><img src="../media/image357.png"/></center> + +<center>Рис. 43. Пример настройки действия «Настройка колонтитулов»</center> + +Таблица 1. + +<table> + <tbody> + <tr> + <td width="529"> + <p><strong>Значение</strong></p> + </td> + <td width="113"> + <p><strong>Обозначение</strong></p> + </td> + </tr> + <tr> + <td width="529"> + <p>Номер текущей страницы</p> + </td> + <td width="113"> + <p>&P</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Общее число страниц</p> + </td> + <td width="113"> + <p>&N</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Текущая дата</p> + </td> + <td width="113"> + <p>&D</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Текущее время</p> + </td> + <td width="113"> + <p>&T</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Путь до документа</p> + </td> + <td width="113"> + <p>&Z</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Название документа</p> + </td> + <td width="113"> + <p>&F</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Название листа</p> + </td> + <td width="113"> + <p>&A</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Вставка символа «&»</p> + </td> + <td width="113"> + <p>&&</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Включение или выключение полужирного форматирования текста</p> + </td> + <td width="113"> + <p>&B</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Включение или выключение курсива</p> + </td> + <td width="113"> + <p>&I</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Включение или выключение подчеркивания текста</p> + </td> + <td width="113"> + <p>&U</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Включение или выключение двойного подчеркивания текста</p> + </td> + <td width="113"> + <p>&E</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Включение или отключение форматирования подстрочного индекса</p> + </td> + <td width="113"> + <p>&Y</p> + </td> + </tr> + <tr> + <td width="529"> + <p>Включение или отключение форматирования надстрочного индекса</p> + </td> + <td width="113"> + <p>&X</p> + </td> + </tr> + </tbody> +</table> + + + #### Действие «Создать новый файл» Действие создает в указанной папке новый файл с названием и указанным @@ -634,7 +807,7 @@ Excel. Начните с создания действия «Формула» д <center><img src="../media/image99.png" style="width:6.11458in;height:1.29181in" /></center> -<center>Рис. 41. Пример настройки действия «Создание нового файла»</center> +<center>Рис. 44. Пример настройки действия «Создание нового файла»</center> Если после создания файла необходимо выполнить с ним какие-либо действия, то **необходимо создать новый модуль «Excel»**, в котором в поле «Имя файла» @@ -648,7 +821,7 @@ Excel. Начните с создания действия «Формула» д <center><img src="../media/image100.png" style="width:6.28205in;height:1.35417in" /></center> -<center>Рис. 42. Пример настройки действия «Заполнение листа»</center> +<center>Рис. 45. Пример настройки действия «Заполнение листа»</center> #### Действие «Экспортировать в PDF» @@ -660,7 +833,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image101.png" style="width:6.69306in;height:1.45278in" /></center> -<center>Рис. 43. Пример настройки действия «Экспортирование в PDF»</center> +<center>Рис. 46. Пример настройки действия «Экспортирование в PDF»</center> Название файла и его расположение будут совпадать с экспортируемым файлом (расширение файла будет pdf). @@ -677,7 +850,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image102.png"/></center> -<center>Рис. 44. Пример настройки действия «Найти данные»</center> +<center>Рис. 47. Пример настройки действия «Найти данные»</center> #### Действие «Поиск строки по значениям колонок» @@ -692,7 +865,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image103.png" style="width:6.22637in;height:1.21597in" /></center> -<center>Рис. 45. Пример настройки действия «Поиск строки»</center> +<center>Рис. 48. Пример настройки действия «Поиск строки»</center> В данном случае будет искаться одна строка, в колонке A которой 23.03.2020, а в колонке B – Уфа. @@ -706,7 +879,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image104.png" /></center> -<center>Рис. 46. Пример настройки действия «Найти лист»</center> +<center>Рис. 49. Пример настройки действия «Найти лист»</center> ### Группа «Другие функции» @@ -718,7 +891,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image105.png" style="width:6.69306in;height:1.37153in" /></center> -<center>Рис. 47. Пример настройки действия «Сместить ячейку»</center> +<center>Рис. 50. Пример настройки действия «Сместить ячейку»</center> #### Действие «Наложить фильтр» @@ -737,7 +910,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image106.png" style="width:6.46561in;height:1.41667in" /></center> -<center>Рис. 48. Пример настройки действия «Наложить фильтр»</center> +<center>Рис. 51. Пример настройки действия «Наложить фильтр»</center> #### Действие «Удалить фильтр» @@ -745,7 +918,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image107.png" style="width:3.02292in;height:1.31668in" /></center> -<center>Рис. 49. Пример настройки действия «Удаление фильтра»</center> +<center>Рис. 52. Пример настройки действия «Удаление фильтра»</center> #### Действие «Добавить сортировку» @@ -755,7 +928,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image108.png" style="width:6.57741in;height:1.4375in" /></center> -<center>Рис. 50. Пример настройки действия «Добавление сортировки»</center> +<center>Рис. 53. Пример настройки действия «Добавление сортировки»</center> #### Действие «Очистить диапазон» @@ -764,7 +937,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image109.png" style="width:3.29792in;height:1.44391in" /></center> -<center>Рис. 51. Пример настройки действия «Очищение диапазона»</center> +<center>Рис. 54. Пример настройки действия «Очищение диапазона»</center> #### Действие «Получить уникальные значения столбца» @@ -776,7 +949,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image110.png" style="width:6.48361in;height:1.39583in" /></center> -<center>Рис. 52. Пример настройки действия «Получение уникальных значений»</center> +<center>Рис. 55. Пример настройки действия «Получение уникальных значений»</center> #### Действие «Промежуточные итоги» @@ -785,19 +958,19 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image111.png" style="width:6.88597in;height:1.5in" /></center> -<center>Рис. 53. Пример настройки действия «Промежуточные итоги»</center> +<center>Рис. 56. Пример настройки действия «Промежуточные итоги»</center> Поле «Для колонок» соответствует полю в Excel «Добавить итоги по» -(выделено зеленым на рисунке 54), поле «При каждом изменении в +(выделено зеленым на рисунке 57), поле «При каждом изменении в колонке» соответствует аналогичному полю в Excel, но должно быть заполнено названием колонки Excel (A, B, … или 1, 2, …) (выделено -красным на рисунке 54, поле «Функция» заполняется операцией, которая +красным на рисунке 57, поле «Функция» заполняется операцией, которая должна быть применена для выбранных колонок (выделено синим на рисунке -54). +57). <center><img src="../media/image112.png" style="width:2.75417in;height:3.4375in" /></center> -<center>Рис. 54. Настройка действия «Промежуточные итоги» в Excel</center> +<center>Рис. 57. Настройка действия «Промежуточные итоги» в Excel</center> #### Действие «Сводная таблица» @@ -808,7 +981,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image113.png" style="width:6.61615in;height:1.40625in" /></center> -<center>Рис. 55. Пример настройки действия «Сводная таблица»</center> +<center>Рис. 58. Пример настройки действия «Сводная таблица»</center> В поля «Поля в столбцах», «Поля в значениях» и «Поля в строках» вписываются **названия колонок таблицы-источника** (а не Excel-таблицы), @@ -816,19 +989,19 @@ Excel (по умолчанию размер листа А4, с обычными «Поля в столбцах» соответствуют названиям столбцов таблицы, значения которых должны быть расположены в столбцах сводной таблицы (выделено -зеленым на рисунке 56); +зеленым на рисунке 59); «Поля в строках» соответствуют названиям столбцов таблицы, значения которых должны быть расположены в строках сводной таблицы (выделено -синим на рисунке 56); +синим на рисунке 59); «Поля в значениях» соответствуют названиям столбцов таблицы, значения которых должны быть расположены в значениях сводной таблицы (выделено -красным на рисунке 56); +красным на рисунке 59); <center><img src="../media/image114.png" style="width:2.98889in;height:3.92431in" /></center> -<center>Рис. 56. Настройка действия «Сводная таблица» в Excel</center> +<center>Рис. 59. Настройка действия «Сводная таблица» в Excel</center> Для того, чтобы изменить функцию подсчета значений в полях «Значения», необходимо к выбранному полю добавить символ «:» и название функции. @@ -958,7 +1131,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image354.png"/></center> -<center>Рис. 57. Пример использования функций подсчета значений</center> +<center>Рис. 60. Пример использования функций подсчета значений</center> #### Действие «Скопировать и вставить ячейку/диапазон» @@ -968,7 +1141,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image115.png" /></center> -<center>Рис. 58. Пример настройки действия «Скопировать и вставить +<center>Рис. 61. Пример настройки действия «Скопировать и вставить ячейку/диапазон»</center> #### Действие «Отобразить в виде процентов» @@ -977,7 +1150,7 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image116.png" style="width:3.85347in;height:1.66011in" /></center> -<center>Рис. 59. Пример настройки действия «Отображение в виде процентов»</center> +<center>Рис. 62. Пример настройки действия «Отображение в виде процентов»</center> #### Действие «Круговая диаграмма» @@ -989,25 +1162,25 @@ Excel (по умолчанию размер листа А4, с обычными <center><img src="../media/image117.png" style="width:6.59338in;height:1.40625in" /></center> -<center>Рис. 60. Пример настройки действия «Создание круговой диаграммы»</center> +<center>Рис. 63. Пример настройки действия «Создание круговой диаграммы»</center> **ПРИМЕР.** Построение круговой диаграммы для двух параметров, указанных в столбце A, по соответствующим им параметрам, указанным в столбце B. Заполнение -действия для данного примера указано на рисунке 59. +действия для данного примера указано на рисунке 63. -Пример исходных данных представлен на рисунке 60. +Пример исходных данных представлен на рисунке 64. <center><img src="../media/image118.png" style="width:2.54306in;height:1.64167in" /></center> -<center>Рис. 61. Пример исходных данных</center> +<center>Рис. 64. Пример исходных данных</center> -Результат построения круговой диаграммы представлен на рисунке 61. +Результат построения круговой диаграммы представлен на рисунке 65. <center><img src="../media/image119.png" style="width:3.72014in;height:2.56667in" /></center> -<center>Рис. 62. Результат выполнения действия «Круговая диаграмма»</center> +<center>Рис. 65. Результат выполнения действия «Круговая диаграмма»</center> #### Действие «График» @@ -1015,7 +1188,7 @@ A, по соответствующим им параметрам, указанн необходимо указать в поле «Диапазон значений» в виде одномерного диапазона (по одной колонке или по одной строке). Если рядов больше, чем один, то последующие ряды нужно указать в таком же виде через «;», как -указано на рисунке 62. Диапазон аргументов должен быть один и +указано на рисунке 66. Диапазон аргументов должен быть один и указывается аналогично ряду. «Ячейки с названиями рядов» заполняются названиями ячеек через «;», их количество должно быть равно количеству рядов, первая ячейка отображает название первого ряда и т.д. В ячейку @@ -1024,7 +1197,7 @@ A, по соответствующим им параметрам, указанн <center><img src="../media/image120.png" style="width:6.58138in;height:1.42708in" /></center> -<center>Рис. 63. Пример настройки действия «График»</center> +<center>Рис. 66. Пример настройки действия «График»</center> **ПРИМЕР.** @@ -1032,19 +1205,19 @@ A, по соответствующим им параметрам, указанн времени. Так как валют две, то график должен состоять из двух рядов. В качестве аргументов выступит столбец с указанием дат – A, в качестве значений будет два столбца, первый – B, курс евро, и второй – C, курс -доллара. Заполнение действия представлено на рисунке 63. +доллара. Заполнение действия представлено на рисунке 66. -Пример исходных данных представлен на рисунке 64. +Пример исходных данных представлен на рисунке 67. <center><img src="../media/image121.png" style="width:1.97083in;height:2.70278in" /></center> -<center>Рис. 64. Пример исходных данных</center> +<center>Рис. 67. Пример исходных данных</center> -Результат работы программы представлен на рисунке 65. +Результат работы программы представлен на рисунке 68. <center><img src="../media/image122.png" style="width:3.88125in;height:5.00556in" /></center> -<center>Рис. 65. Результат выполнения действия «График»</center> +<center>Рис. 68. Результат выполнения действия «График»</center> #### Действие «Проверка значений» @@ -1076,7 +1249,7 @@ A, по соответствующим им параметрам, указанн <center><img src="../media/image123.png" style="width:6.51042in;height:1.4135in" /></center> -<center>Рис. 66. Пример настройки действия «Проверка значений»</center> +<center>Рис. 69. Пример настройки действия «Проверка значений»</center> **ПРИМЕР.** @@ -1086,7 +1259,7 @@ A, по соответствующим им параметрам, указанн <center><img src="../media/image124.png" style="width:2.30347in;height:1.24653in" /></center> -<center>Рис. 67. Пример исходных данных</center> +<center>Рис. 70. Пример исходных данных</center> Тогда после работы робота при нажатии на любую ячейку из диапазона С2:С6 будет появляться стрелочка для открытия выпадающего списка, в котором @@ -1094,7 +1267,7 @@ A, по соответствующим им параметрам, указанн <center><img src="../media/image125.png" style="width:3.08268in;height:2.0748in" /></center> -<center>Рис. 68. Результат выполнения действия «Проверка значений»</center> +<center>Рис. 71. Результат выполнения действия «Проверка значений»</center> Второй пример - создание правила, позволяющего вводить в диапазон ячеек A1:A5 только действительные числа, находящиеся в промежутке между 5 и @@ -1104,14 +1277,14 @@ A1:A5 только действительные числа, находящиес <center><img src="../media/image126.png" style="width:6.6716in;height:1.34375in" /></center> -<center>Рис. 69. Пример создания правила для проверки значений</center> +<center>Рис. 72. Пример создания правила для проверки значений</center> После работы робота при попытке ввести число, находящееся вне диапазона от 5 до 10, появляется ошибка: <center><img src="../media/image127.png" style="width:5.47986in;height:1.37708in" /></center> -<center>Рис. 70. Результат выполнения действия «Проверка значений»</center> +<center>Рис. 73. Результат выполнения действия «Проверка значений»</center> #### Действие «Добавить изображение» @@ -1122,72 +1295,153 @@ A1:A5 только действительные числа, находящиес <center><img src="../media/image128.png" style="width:6.69306in;height:1.33819in" /></center> -<center>Рис. 71. Пример настройки действия «Добавить изображение»</center> +<center>Рис. 74. Пример настройки действия «Добавить изображение»</center> ### Группа «Форматирование» -#### Действие «Условное форматирование» +#### Действие «Условное форматирование - цвет» -Действие форматирует указанные ячейки на выбранном листе в зависимости -от того, удовлетворяют ли они указанному условию. В поле «Лист, -диапазон» через запятую вводятся лист и диапазон или одна ячейка из -этого листа, к которым будет применяться условное форматирование. В -полях «Цвет заливки» и «Цвет текста» указываются цвета, которыми будет -залита ячейка и окрашен текст в ней, если она будет удовлетворять -условию. Условие составляется из выбора функции и указания значения для -сравнения. Доступные функции – равно, не равно, больше, меньше, больно -или равно, меньше или равно, формула. Если выбрана функция «формула», то -в поле «Значение для сравнения» следует вписать формулу в формате Excel, -начиная со знака «=». +Действие окрашивает указанные ячейки на выбранном листе в зависимости +от того, удовлетворяют ли они указанному условию. В поле «Лист, диапазон» +через запятую вводятся лист и диапазон или одна ячейка из этого листа, +к которым будет применяться условное форматирование. В полях «Цвет заливки» +и «Цвет текста» указываются цвета, которыми будет залита ячейка и окрашен +текст в ней, если она будет удовлетворять условию. Условие составляется из +выбора функции и указания значения для сравнения. Доступные функции – равно, +не равно, больше, меньше, больно или равно, меньше или равно, формула. Если +выбрана функция «формула», то в поле «Значение для сравнения» следует +вписать формулу в формате Excel, начиная со знака «=». -<center><img src="../media/image129.png" style="width:6.69306in;height:1.33056in" /></center> +<center><img src="../media/image129.png" /></center> -<center>Рис. 72. Пример настройки действия «Условное форматирование»</center> +<center>Рис. 75. Пример настройки действия «Условное форматирование - цвет»</center> **ПРИМЕР.** Окрасим все ячейки в столбцах B и C в зеленый цвет, если значение курса -меньше или равно 82. Действие заполняется как на рисунке 72. +меньше или равно 82. Действие заполняется как на рисунке 75. -Исходные данные представлены на рисунке 73. +Исходные данные представлены на рисунке 76. <center><img src="../media/image130.png" style="width:2.64931in;height:3.46667in" /></center> -<center>Рис. 73. Пример исходных данных</center> +<center>Рис. 76. Пример исходных данных</center> -Результат работы программы представлен на рисунке 74. +Результат работы программы представлен на рисунке 77. <center><img src="../media/image131.png" style="width:2.89792in;height:3.82083in" /></center> -<center>Рис. 74. Результат выполнения действия «Условное форматирование»</center> +<center>Рис. 77. Результат выполнения действия «Условное форматирование - цвет»</center> + +#### Действие «Условное форматирование - выравнивание» + +Действие применяет заданное выравнивание в указанные ячейки на выбранном +листе в зависимости от того, удовлетворяют ли они указанному условию. +В поле «Лист, диапазон» через запятую вводятся лист и диапазон или одна +ячейка из этого листа, к которым будет применяться условное форматирование. +В полях «Общее положение» и «Выравнивание содержимого» выбираются из +выпадающего списка необходимые способы выравнивания, которые будут применены +к ячейке, если она будет удовлетворять условию. Условие составляется из +выбора функции и указания значения для сравнения. Доступные функции – равно, +не равно, больше, меньше, больно или равно, меньше или равно, формула. Если +выбрана функция «формула», то в поле «Значение для сравнения» следует вписать +формулу в формате Excel, начиная со знака «=». + +<center><img src="../media/image358.png" /></center> + +<center>Рис. 78. Пример настройки действия «Условное форматирование - выравнивание»</center> + +**ПРИМЕР.** + +Пусть все ячейки в столбцах B и C будут выровнены по левому краю, если +значение курса меньше или равно 82. Действие заполняется как на рис. 78. + +Исходные данные представлены на рисунке 79. + +<center><img src="../media/image130.png" style="width:2.64931in;height:3.46667in" /></center> + +<center>Рис. 79. Пример исходных данных</center> + +Результат работы программы представлен на рисунке 80. + +<center><img src="../media/image359.png"/></center> + +<center>Рис. 80. Результат выполнения действия «Условное форматирование - выравнивание»</center> + +#### Действие «Условное форматирование - шрифт» + +Действие применяет заданные настройки шрифта (сам шрифт, стиль текста) +в указанные ячейки на выбранном листе в зависимости от того, удовлетворяют +ли они указанному условию. В поле «Лист, диапазон» через запятую вводятся +лист и диапазон или одна ячейка из этого листа, к которым будет применяться +условное форматирование. В поле «Шрифт» по необходимости выбирается один из +свободно распространяемых шрифтов Microsoft, в поле «Стиль текста» по +необходимости выбирается оформление текста – курсив, полужирный и другое. +Выбранные шрифт и стиль текста будут применены к ячейке, если она будет +удовлетворять условию. Условие составляется из выбора функции и указания +значения для сравнения. Доступные функции – равно, не равно, больше, меньше, +больно или равно, меньше или равно, формула. Если выбрана функция «формула», +то в поле «Значение для сравнения» следует вписать формулу в формате Excel, +начиная со знака «=». + +<center><img src="../media/image360.png" /></center> + +<center>Рис. 81. Пример настройки действия «Условное форматирование - шрифт»</center> + +**ПРИМЕР.** + +Выделим все значения в столбцах B и C полужирным стилем текста, если их +значения меньше или равны 78. Действие заполняется как на рис. 81. + +Исходные данные представлены на рисунке 82. + +<center><img src="../media/image130.png" style="width:2.64931in;height:3.46667in" /></center> + +<center>Рис. 82. Пример исходных данных</center> + +Результат работы программы представлен на рисунке 83. + +<center><img src="../media/image361.png"/></center> + +<center>Рис. 83. Результат выполнения действия «Условное форматирование - шрифт»</center> #### Действие «Цвет ячейки/диапазона» Действие меняет цвет заливки текста и самого текста в указанном диапазоне / ячейке. -<center><img src="../media/image132.png" style="width:6.69306in;height:1.33958in" /></center> +<center><img src="../media/image132.png" /></center> -<center>Рис. 75. Пример настройки действия «Цвет ячейки/диапазона»</center> +<center>Рис. 84. Пример настройки действия «Цвет ячейки/диапазона»</center> **ПРИМЕР.** -На рисунке 75 представлено, как залить диапазон ячеек A17:C19 в +На рисунке 84 представлено, как залить диапазон ячеек A17:C19 в голубой цвет, а текст в этих ячейках окрасить в фиолетовый. -Исходные данные представлены на рисунке 76: +Исходные данные представлены на рисунке 85: <center><img src="../media/image130.png" style="width:2.49801in;height:3.26744in" /></center> -<center>Рис. 76. Пример исходных данных</center> +<center>Рис. 85. Пример исходных данных</center> -Результат работы робота представлен на рисунке 76: +Результат работы робота представлен на рисунке 86: <center><img src="../media/image133.png" style="width:2.55208in;height:3.40039in" /></center> -<center>Рис. 77. Результат выполнения действия «Цвет ячейки/диапазона»</center> +<center>Рис. 86. Результат выполнения действия «Цвет ячейки/диапазона»</center> -***Действие «Ширина столбца(-ов)»*** +#### Действие «Получить цвет ячейки» + +Данное действие позволяет получить цвет заливки ячейки, возвращая в +переменную его название в формате HEX (начиная с символа «#»). При +указании диапазона ячеек, будет возвращен цвет последней ячейки. + +<center><img src="../media/image362.png" /></center> + +<center>Рис. 87. Пример настройки действия «Получить цвет ячейки»</center> + +#### Действие «Ширина столбца(-ов)» Действие изменяет ширину указанных столбцов. Столбцы можно перечислять через запятую, писать их номера вместо названий (с 1-цы). Ширина @@ -1195,25 +1449,25 @@ A1:A5 только действительные числа, находящиес <center><img src="../media/image134.png" style="width:6.52778in;height:1.25in" /></center> -<center>Рис. 78. Пример настройки действия «Ширина столбца(-ов)»</center> +<center>Рис. 88. Пример настройки действия «Ширина столбца(-ов)»</center> **ПРИМЕР.** -На рисунке 78 представлено, как заполнить действие для установки ширины +На рисунке 88 представлено, как заполнить действие для установки ширины столбцов B и C в 16 пунктов. В поле «Столбцы» можно было бы написать «2,3», то есть второй и третий столбцы. -Исходные данные представлены на рисунке 79: +Исходные данные представлены на рисунке 89: <center><img src="../media/image135.png" style="width:3.24931in;height:1.10347in" /></center> -<center>Рис. 79. Пример исходных данных</center> +<center>Рис. 89. Пример исходных данных</center> -Результат работы представлен на рисунке 80: +Результат работы представлен на рисунке 90: <center><img src="../media/image136.png" style="width:3.96806in;height:1.16597in" /></center> -<center>Рис. 80. Результат выполнения действия «Ширина столбца(-ов)»</center> +<center>Рис. 90. Результат выполнения действия «Ширина столбца(-ов)»</center> #### Действие «Высота строки (-ок)» @@ -1222,24 +1476,24 @@ A1:A5 только действительные числа, находящиес <center><img src="../media/image137.png" style="width:6.82829in;height:1.33333in" /></center> -<center>Рис. 81. Пример настройки действия «Высота строки(-ок)»</center> +<center>Рис. 91. Пример настройки действия «Высота строки(-ок)»</center> **ПРИМЕР.** Изменим высоту первой строки, сделав её равной 30 пунктам. Для этого -заполняем действие так, как указано на рисунке 81. +заполняем действие так, как указано на рисунке 91. -Исходные данные представлены на рисунке 82: +Исходные данные представлены на рисунке 92: <center><img src="../media/image138.png" style="width:3.58264in;height:1.06667in" /></center> -<center>Рис. 82. Пример исходных данных</center> +<center>Рис. 92. Пример исходных данных</center> -Результат работы робота представлен на рисунке 83: +Результат работы робота представлен на рисунке 93: <center><img src="../media/image139.png" style="width:3.66667in;height:1.17431in" /></center> -<center>Рис. 83. Результат выполнения действия «Высота строки(-ок)»</center> +<center>Рис. 93. Результат выполнения действия «Высота строки(-ок)»</center> #### Действие «Объединить ячейки» @@ -1255,24 +1509,24 @@ A1:A5 только действительные числа, находящиес <center><img src="../media/image140.png" style="width:6.36458in;height:1.2624in" /></center> -<center>Рис. 84. Пример настройки действия «Объединить ячейки»</center> +<center>Рис. 94. Пример настройки действия «Объединить ячейки»</center> **ПРИМЕР.** -На рисунке 84 представлено заполнение действия для объединения +На рисунке 94 представлено заполнение действия для объединения колонок в диапазоне ячеек A2:C4. -Исходные данные представлены на рисунке 85: +Исходные данные представлены на рисунке 95: <center><img src="../media/image141.png" style="width:3.30694in;height:1.90903in" /></center> -<center>Рис. 85. Пример исходных данных</center> +<center>Рис. 95. Пример исходных данных</center> -Результат работы представлен на рисунке 86: +Результат работы представлен на рисунке 96: <center><img src="../media/image142.png" style="width:3.6875in;height:1.42153in" /></center> -<center>Рис. 86. Результат выполнения действия «Объединить ячейки»</center> +<center>Рис. 96. Результат выполнения действия «Объединить ячейки»</center> ***Действие «Очистить форматирование»*** @@ -1280,25 +1534,25 @@ A1:A5 только действительные числа, находящиес <center><img src="../media/image143.png" style="width:3.59375in;height:1.42199in" /></center> -<center>Рис. 87. Пример настройки действия «Очистить форматирование»</center> +<center>Рис. 97. Пример настройки действия «Очистить форматирование»</center> **ПРИМЕР.** Очистим форматирование, которое содержится в диапазоне A17:C19. Для -этого заполним действие так, как указано на рисунке 87 и запустим +этого заполним действие так, как указано на рисунке 97 и запустим робота. -Исходные данные представлены на рисунке 88: +Исходные данные представлены на рисунке 98: <center><img src="../media/image144.png" style="width:4.00972in;height:0.92639in" /></center> -<center>Рис. 88. Пример исходных данных</center> +<center>Рис. 98. Пример исходных данных</center> Результат работы представлен на рисунке 89 <center><img src="../media/image145.png" style="width:3.99931in;height:1.02014in" /></center> -<center>Рис. 89. Результат выполнения действия «Очистить форматирование»</center> +<center>Рис. 99. Результат выполнения действия «Очистить форматирование»</center> ***Действие «Формат ячейки»*** @@ -1309,7 +1563,7 @@ A1:A5 только действительные числа, находящиес <center><img src="../media/image146.png" style="width:6.57242in;height:1.30208in" /></center> -<center>Рис. 90. Пример настройки действия «Формат ячейки»</center> +<center>Рис. 100. Пример настройки действия «Формат ячейки»</center> #### Действие «Формат числа» @@ -1318,7 +1572,7 @@ Excel. <center><img src="../media/image147.png" style="width:6.61719in;height:1.3125in" /></center> -<center>Рис. 91. Пример настройки действия «Формат числа»</center> +<center>Рис. 101. Пример настройки действия «Формат числа»</center> Примеры форматов можно посмотреть в программе Excel, кликнув правой кнопкой левой кнопкой мыши по ячейке – «Формат ячейки» – вкладка «Число» @@ -1326,31 +1580,31 @@ Excel. <center><img src="../media/image148.png" style="width:6.15069in;height:4.44792in" /></center> -<center>Рис. 92. Просмотр примеров форматов числа в Excel</center> +<center>Рис. 102. Просмотр примеров форматов числа в Excel</center> Наиболее часто используемые форматы числа предлагаются в студии при наведении на поле для ввода формата. <center><img src="../media/image149.png" style="width:6.87263in;height:2.07292in" /></center> -<center>Рис. 93. Просмотр примеров форматов числа в студии</center> +<center>Рис. 103. Просмотр примеров форматов числа в студии</center> **ПРИМЕР.** Отформатируем число, содержащееся в ячейке A1 в денежный долларовый -формат. Для этого заполним действие так, как указано на рисунке 93. +формат. Для этого заполним действие так, как указано на рисунке 103. -Исходные данные представлены на рисунке 94: +Исходные данные представлены на рисунке 104: <center><img src="../media/image150.png" style="width:1.59444in;height:1.36181in" /></center> -<center>Рис. 94. Пример исходных данных</center> +<center>Рис. 104. Пример исходных данных</center> Результат работы представлен на рисунке ниже: <center><img src="../media/image151.png" style="width:1.31181in;height:1.19722in" /></center> -<center>Рис. 95. Результат выполнения действия «Формат числа»</center> +<center>Рис. 105. Результат выполнения действия «Формат числа»</center> #### Действие «Выравнивание» @@ -1363,24 +1617,24 @@ Excel. <center><img src="../media/image152.png" style="width:6.92359in;height:1.34375in" /></center> -<center>Рис. 96. Пример настройки действия «Выравнивание»</center> +<center>Рис. 106. Пример настройки действия «Выравнивание»</center> **ПРИМЕР.** -В заполненном на рисунке 96 действии настраивается выравнивание +В заполненном на рисунке 106 действии настраивается выравнивание ячейки А1 по центру относительно вертикали. Исходное положение текста в ячейке представлено на рисунке 97: <center><img src="../media/image153.png" style="width:3.51181in;height:1.03889in" /></center> -<center>Рис. 97. Пример исходных данных</center> +<center>Рис. 107. Пример исходных данных</center> -Результат работы представлен на рисунке 98: +Результат работы представлен на рисунке 108: <center><img src="../media/image154.png" style="width:3.925in;height:0.85417in" /></center> -<center>Рис. 98. Результат выполнения действия «Выравнивание»</center> +<center>Рис. 108. Результат выполнения действия «Выравнивание»</center> #### Действие «Перенос текста» @@ -1390,7 +1644,7 @@ Excel. <center><img src="../media/image155.png" style="width:3.72727in;height:1.46941in" /></center> -<center>Рис. 99. Пример настройки действия «Перенос текста»</center> +<center>Рис. 109. Пример настройки действия «Перенос текста»</center> #### Действие «Шрифт» @@ -1400,25 +1654,25 @@ Excel. <center><img src="../media/image156.png" style="width:7.02838in;height:1.35417in" /></center> -<center>Рис. 100. Пример настройки действия «Изменение шрифта»</center> +<center>Рис. 110. Пример настройки действия «Изменение шрифта»</center> **ПРИМЕР.** Изменим шрифт текста, находящегося в ячейке B1 так, как указано в -действии на рисунке 100 – сам шрифт изменим на Batang, зададим стиль +действии на рисунке 110 – сам шрифт изменим на Batang, зададим стиль текста – полужирный курсив, а размер текста 16. -Исходное форматирование текста представлен на рисунке 101: +Исходное форматирование текста представлен на рисунке 111: <center><img src="../media/image157.png" style="width:3.85347in;height:0.81181in" /></center> -<center>Рис. 101. Пример исходных данных</center> +<center>Рис. 111. Пример исходных данных</center> Результат работы представлен на рисунке 102: <center><img src="../media/image158.png" style="width:3.81181in;height:0.80139in" /></center> -<center>Рис. 102. Результат выполнения действия «Шрифт»</center> +<center>Рис. 112. Результат выполнения действия «Шрифт»</center> #### Действие «Границы» @@ -1429,25 +1683,25 @@ Excel. <center><img src="../media/image159.png" style="width:6.69306in;height:1.35556in" /></center> -<center>Рис. 103. Пример настройки действия «Границы»</center> +<center>Рис. 113. Пример настройки действия «Границы»</center> **ПРИМЕР.** Добавим штрихпунктирную внешнюю границу для блока текста, находящегося в диапазоне A2:A6. Для этого необходимо заполнить действие так, как -указано на рисунке 103. +указано на рисунке 113. -Исходный вид блока текста представлен на рисунке 104: +Исходный вид блока текста представлен на рисунке 114: <center><img src="../media/image160.png" style="width:2.64514in;height:1.70764in" /></center> -<center>Рис. 104. Пример исходных данных</center> +<center>Рис. 114. Пример исходных данных</center> -Результат работы представлен на рисунке 105: +Результат работы представлен на рисунке 115: <center><img src="../media/image161.png" style="width:2.15556in;height:1.74931in" /></center> -<center>Рис. 105. Результат выполнения действия «Границы»</center> +<center>Рис. 115. Результат выполнения действия «Границы»</center> ## Модуль «Закрыть Excel-файл» @@ -1473,7 +1727,7 @@ Excel-модуль работает с файлами следующим обр <center><img src="../media/image162.png" style="width:4.1348in;height:2.98387in" /></center> -<center>Рис. 106. Окно «Закрыть Excel-файл»</center> +<center>Рис. 116. Окно «Закрыть Excel-файл»</center> **Поле «Путь к файлу»** заполняется путем до файла, который необходимо закрыть. Он может содержаться в переменной, или можно выбрать его diff --git a/docs/iterface.md b/docs/interface.md similarity index 86% rename from docs/iterface.md rename to docs/interface.md index 1f8fec2..06f3bdd 100644 --- a/docs/iterface.md +++ b/docs/interface.md @@ -203,7 +203,24 @@ - Выбор папки – поле с иконкой в виде трех точек, по нажатию на которую пользователю будет предложено выбрать папку. Путь до выбранной папки запишется в это поле. Выглядит так же, как и «Выбор - файла». + файла»; + +- Выпадающий список со множественным выбором – поле со стрелочкой сбоку, + по нажатию которой открывается список заранее определенных значений. + Пользователь может выбрать несколько значений из этого списка. Все выбранные + значения отображаются в начале списка. В переменную результат запишется + список всех выбранных элементов (то есть тип результирующей переменной – список); + +<center><img src="../media/image363.png" /></center> + +<center>Рис. 17. Элемент «Выпадающий список со множественным выбором» </center> + +- Флажок – поле, которое может принимать только два значения – true и false, + то есть галочка установлена или нет. + +<center><img src="../media/image364.png" /></center> + +<center>Рис. 18. Элемент «Флажок» </center> ### Поле «Источник данных» @@ -219,31 +236,34 @@ необходимо. Если поле должно быть пустым, то не надо заполнять «Источник данных»; +- Поле «Флажок» поддерживает такие значения, как «true»/«false» и 1/0. + Если подано в источнике данных true или 1, то флажок будет установлен; + - Для «Таблицы» необходимо подать заполненную табличную переменную для её отображения; -- Для элемента интерфейса «Выпадающий список» необходимо передать - набор значений, которые пользователю будет предложено выбрать. - Делается это через символ «;». Это могут быть строки, - переменные-элементы, переменные-списки или табличные переменные, - состоящие из одного столбца. Например, введено следующее значение, - при приведенных далее примерах заполнения переменных: +- Для элементов интерфейса «Выпадающий список» и «Выпадающий список со + множественным выбором» необходимо передать набор значений, которые + пользователю будет предложено выбрать. Делается это через символ «;». + Это могут быть строки, переменные-элементы, переменные-списки или табличные + переменные, состоящие из одного столбца. Например, введено следующее + значение, при приведенных далее примерах заполнения переменных: <center><img src="../media/image292.png" style="width:3.64538in;height:0.87489in" /></center> -<center>Рис. 17. Пример заполнения поля «Источник данных»</center> +<center>Рис. 19. Пример заполнения поля «Источник данных»</center> <center><img src="../media/image293.png" style="width:3.17583in;height:2.21733in" /></center> <center><img src="../media/image294.png" style="width:3.14286in;height:3.14286in" /></center> -<center>Рис. 18. Примеры заполнения используемых переменных</center> +<center>Рис. 20. Примеры заполнения используемых переменных</center> Результат будет выглядеть следующим образом: <center><img src="../media/image295.png" style="width:1.53106in;height:1.47898in" /></center> -<center>Рис. 19. Пример результирующих данных</center> +<center>Рис. 21. Пример результирующих данных</center> ### Поля «Колонка» и «Строка» @@ -264,7 +284,7 @@ <center><img src="../media/image296.png" style="width:4.62338in;height:1.84784in" /></center> -<center>Рис. 20. Пример окна без объединения колонок</center> +<center>Рис. 22. Пример окна без объединения колонок</center> Для того, чтобы растянуть поле для выбора файла по длине полей для ввода даты, нам необходимо разместить его не просто в 1 колонке и 0 строке, но @@ -272,12 +292,12 @@ <center><img src="../media/image297.png" style="width:5.8961in;height:1.67376in" /></center> -<center>Рис. 21. Пример заполнения полей элемента интерфейса для настройки +<center>Рис. 23. Пример заполнения полей элемента интерфейса для настройки объединения колонок</center> <center><img src="../media/image298.png" style="width:4.54435in;height:1.81458in" /></center> -<center>Рис. 22. Пример окна с объединенными колонками в первой строке сетки</center> +<center>Рис. 24. Пример окна с объединенными колонками в первой строке сетки</center> То есть при заполнении поля «Объединить колонки» колонки, начиная с той, что указана в поле «Колонка», будут объединены по горизонтали в одну. @@ -287,7 +307,7 @@ <center><img src="../media/image299.png" style="width:4.57639in;height:1.83056in" /></center> -<center>Рис. 23.. Пример окна с объединенными строками в первой колонке сетки</center> +<center>Рис. 25. Пример окна с объединенными строками в первой колонке сетки</center> ### Поле «Переменная» @@ -301,7 +321,7 @@ <center><img src="../media/image300.png" style="width:6.69306in;height:3.87584in" /></center> -<center>Рис. 24. Пример заполненного окна модуля «Интерфейс»</center> +<center>Рис. 26. Пример заполненного окна модуля «Интерфейс»</center> По кнопке «Предпросмотр» откроется диалоговое окно в таком виде, в котором оно будет представлено пользователю. diff --git a/docs/konfiguration.md b/docs/konfiguration.md index 3398185..ff3ab88 100644 --- a/docs/konfiguration.md +++ b/docs/konfiguration.md @@ -55,4 +55,14 @@ ChromeProxyExtension.exe, если по какой-то причине прог Lexema-RPA Client); в состоянии «false» – клики производятся за счет user32.dll, которой достаточно для работы в текущем рабочем столе. Если по каким-то причинам модуль «Кликер» не работает при установленной - галочке «true» – можно сменить флаг на «false» и написать нам об ошибке + галочке «true» – можно сменить флаг на «false» и написать нам об ошибке; + +10. MailProxyServer – используемый прокси-сервер при подключении к почтовому +серверу для работы с почтой; + +11. MailProxyPort – используемый порт прокси-сервера при подключении к +почтовому серверу для работы с почтой; + +12. CheckCertificate – проверять ли безопасность сертификата почтового сервера +при работе с почтой (по умолчанию true). + diff --git a/docs/media/image129.png b/docs/media/image129.png index e6a4356..098c170 100644 Binary files a/docs/media/image129.png and b/docs/media/image129.png differ diff --git a/docs/media/image132.png b/docs/media/image132.png index 43b5deb..c11092b 100644 Binary files a/docs/media/image132.png and b/docs/media/image132.png differ diff --git a/docs/media/image268.png b/docs/media/image268.png index dc5ac97..2354a2a 100644 Binary files a/docs/media/image268.png and b/docs/media/image268.png differ diff --git a/docs/media/image351.png b/docs/media/image351.png index 10c5dee..c724607 100644 Binary files a/docs/media/image351.png and b/docs/media/image351.png differ diff --git a/docs/media/image355.png b/docs/media/image355.png new file mode 100644 index 0000000..c0f95d0 Binary files /dev/null and b/docs/media/image355.png differ diff --git a/docs/media/image356.png b/docs/media/image356.png new file mode 100644 index 0000000..2405e98 Binary files /dev/null and b/docs/media/image356.png differ diff --git a/docs/media/image357.png b/docs/media/image357.png new file mode 100644 index 0000000..fc599b6 Binary files /dev/null and b/docs/media/image357.png differ diff --git a/docs/media/image358.png b/docs/media/image358.png new file mode 100644 index 0000000..a5926ca Binary files /dev/null and b/docs/media/image358.png differ diff --git a/docs/media/image359.png b/docs/media/image359.png new file mode 100644 index 0000000..764231f Binary files /dev/null and b/docs/media/image359.png differ diff --git a/docs/media/image360.png b/docs/media/image360.png new file mode 100644 index 0000000..1574bd7 Binary files /dev/null and b/docs/media/image360.png differ diff --git a/docs/media/image361.png b/docs/media/image361.png new file mode 100644 index 0000000..7efdb27 Binary files /dev/null and b/docs/media/image361.png differ diff --git a/docs/media/image362.png b/docs/media/image362.png new file mode 100644 index 0000000..240344d Binary files /dev/null and b/docs/media/image362.png differ diff --git a/docs/media/image363.png b/docs/media/image363.png new file mode 100644 index 0000000..4e62b77 Binary files /dev/null and b/docs/media/image363.png differ diff --git a/docs/media/image364.png b/docs/media/image364.png new file mode 100644 index 0000000..fb9052a Binary files /dev/null and b/docs/media/image364.png differ diff --git a/docs/media/image365.png b/docs/media/image365.png new file mode 100644 index 0000000..84c607e Binary files /dev/null and b/docs/media/image365.png differ diff --git a/docs/media/image366.png b/docs/media/image366.png new file mode 100644 index 0000000..3306bea Binary files /dev/null and b/docs/media/image366.png differ diff --git a/docs/media/image367.png b/docs/media/image367.png new file mode 100644 index 0000000..a225d02 Binary files /dev/null and b/docs/media/image367.png differ diff --git a/docs/media/image368.png b/docs/media/image368.png new file mode 100644 index 0000000..382f9a2 Binary files /dev/null and b/docs/media/image368.png differ diff --git a/docs/operators.md b/docs/operators.md index 8079587..e4835a4 100644 --- a/docs/operators.md +++ b/docs/operators.md @@ -196,7 +196,12 @@ Данный модуль заканчивает работу всего робота и не требует настройки. Может использоваться в любом месте. -**ПРИМЕР.** +При написании роботов-функций для их последующего использования в одноименном +модуле с помощью модуля Return происходит возврат результирующей переменной в +основного робота. Для этого необходимо открыть модуль Return двойным нажатием +и ввести название возвращаемой из функции переменной. + +**ПРИМЕР 1.** На рисунке ниже представлен пример использования модуля: пусть с помощью модуля «Считать письма» считываются все письма за определенный @@ -212,6 +217,17 @@ Excel-файл. Но что, если этих писем нет? Для это в ветках модуля «Условие». Так робот выглядит более аккуратным и наглядным. +**ПРИМЕР 2.** + +При использовании в роботе-функции: пусть существует робот-функция для +обработки различных, но однотипных Excel-файлов. На вход подается путь +до файла, а выходом будет являться путь до нового, обработанного +(или консолидированного) файла. + +<center><img src="../media/image368.png"/></center> + +<center>Рис. 19. Пример возврата значения модулем «Return»</center> + ## Модуль «Continue» Модуль «Continue» позволяет перейти к следующей итерации цикла без @@ -223,7 +239,7 @@ Excel-файл. Но что, если этих писем нет? Для это <center><img src="../media/image236.png" style="width:6.69306in;height:0.42014in" /></center> -<center>Рис. 19. Модуль «Continue»</center> +<center>Рис. 20. Модуль «Continue»</center> ### ПРИМЕР @@ -234,7 +250,7 @@ Excel-файл. Но что, если этих писем нет? Для это <center><img src="../media/image237.png" style="width:6.69306in;height:4.62292in" /></center> -<center>Рис. 20. Пример работы с «Continue»</center> +<center>Рис. 21. Пример работы с «Continue»</center> Отличие от работы с условием лишь в лучшей читабельности алгоритма (то есть, без модуля Continue пришлось бы все действия над файлом делать @@ -253,7 +269,7 @@ Excel-файл. Но что, если этих писем нет? Для это <center><img src="../media/image238.png" style="width:6.65868in;height:1.4375in" /></center> -<center>Рис. 21. Вид модуля</center> +<center>Рис. 22. Вид модуля</center> **Поле «Условие».** В поле вводится условие, как и в модуле «Условие», которое необходимо писать в соответствии с синтаксисом языка JS, поэтому @@ -264,14 +280,14 @@ Excel-файл. Но что, если этих писем нет? Для это <center><img src="../media/image239.png" style="width:6.69306in;height:2.22292in" /></center> -<center>Рис. 22. Добавление действий</center> +<center>Рис. 23. Добавление действий</center> При нажатии на кнопку «Свернуть» действия, описанные в цикле, сворачиваются для более компактного отображения команды. <center><img src="../media/image240.png" style="width:6.69306in;height:1.15069in" /></center> -<center>Рис. 23. Свернутый вид модуля</center> +<center>Рис. 24. Свернутый вид модуля</center> ## Модуль «Try/Catch» @@ -280,7 +296,7 @@ Excel-файл. Но что, если этих писем нет? Для это <center><img src="../media/image242.png" style="width:6.69306in;height:2.38333in" /></center> -<center>Рис. 24. Внешний вид модуля Try/Catch</center> +<center>Рис. 25. Внешний вид модуля Try/Catch</center> Модуль состоит из двух блоков – TRY и CATCH. Блок TRY содержит набор модулей или целого робота, который должен выполниться, блок CATCH @@ -316,7 +332,7 @@ Excel, причем в модуле Excel путь до файла будет в <center><img src="../media/image243.png" style="width:6.69306in;height:3.56875in" /></center> -<center>Рис. 25. Пример использования модуля «Try/Catch»</center> +<center>Рис. 26. Пример использования модуля «Try/Catch»</center> В результате работы такого робота будет либо стандартное сообщение «Скрипт отработал успешно!», если письмо было на почте, либо окно с @@ -326,7 +342,7 @@ Excel, причем в модуле Excel путь до файла будет в <center><img src="../media/image244.png" style="width:3.08295in;height:1.37483in" /></center> -<center>Рис. 26. Пример обработки ошибки – окно с информацией</center> +<center>Рис. 27. Пример обработки ошибки – окно с информацией</center> ## Модуль «Switch» @@ -350,7 +366,7 @@ Case могут быть только внутри блока Switch**. <center><img src="../media/image245.png" style="width:6.59375in;height:1.29557in" /></center> -<center>Рис. 27. Модуль «Switch»</center> +<center>Рис. 28. Модуль «Switch»</center> После нажатия на кнопку «Добавить», внутри модуля появится блок Case, который может быть использован только внутри блока Switch. Блоки Case @@ -362,7 +378,7 @@ Case могут быть только внутри блока Switch**. <center><img src="../media/image246.png" style="width:6.69306in;height:2.95139in" /></center> -<center>Рис. 28. Модули «Switch – Case»</center> +<center>Рис. 29. Модули «Switch – Case»</center> Внутри блоков Case располагаются любые модули программы, подобно модулю «Группа». \ No newline at end of file diff --git a/docs/other.md b/docs/other.md index 5c8e4dc..f222276 100644 --- a/docs/other.md +++ b/docs/other.md @@ -149,13 +149,12 @@ Chrome - C:\\Program Files ## Модуль «SQL» Модуль «SQL» обеспечивает работу с базами данных. Поддерживаемые СУБД: -MS SQL и PostgreSQL. +MS SQL, PostgreSQL и Oracle. ### Интерфейс модуля -Данный модуль обеспечивает работу с базами данных. Поддерживаются такие -СУБД, как MS SQL и PostgreSQL. Для работы с БД ***необходимо заполнить -все поля*** окна «Модуль SQL». +Данный модуль обеспечивает работу с базами данных. Для работы с БД ***необходимо +заполнить все поля*** окна «Модуль SQL». Окно состоит из следующих полей: «СУБД», «Источник данных», «База данных», «Логин», «Пароль», «Время ожидания», «SQL-скрипт» и @@ -165,8 +164,14 @@ MS SQL и PostgreSQL. <center>Рис. 6. Пример заполнения модуля</center> -**Поля** «СУБД», **«Источник данных», «База данных», «Логин» и -«Пароль»** обеспечивают подключение к БД. +**Поля** «СУБД», **«Источник данных», «База данных», «Логин» и «Пароль»** +обеспечивают подключение к БД. При указании сервера и порта через +двоеточие необходимо заключать строку в кавычки (например, ‘localhost:1521’). + +***Примечание:*** для БД Oracle поле «База данных» заполнению не подлежит. +В поле «Логин» можно добавить строку «;Connect Mode=SYSDBA» для работы +с системным пользователем. + **Поле «Время ожидания»**. В данное поле вводится значение времени в секундах, которое должно хватить запросу на выполнение. Без этого поля @@ -275,53 +280,6 @@ Http-запросы – запросы для передачи информац **Пол «Действие»** предоставляет перечень доступных действий с FTP сервером. -## Модуль «JSON» - -Данный модуль предназначен для обработки данных в формате JSON – -парсинга JSON-объектов. - -### Интерфейс модуля - -В окне модуля расположены поля для ввода значений: «Переменная» и -«JSON», и кнопки «Сохранить» и «Отмена». - -<center><img src="../media/image324.png" style="width:3.03896in;height:1.8032in" /></center> - -<center>Рис. 10. Окно модуля</center> - -**Поле «Переменная».** В поле «Переменная» вводится название переменной, -которая будет преобразована в объектную переменную с полями, имеющимися -в JSON-объекте. - -**Поле «JSON».** В поле необходимо описать объект в формате JSON, в виде -пар «ключ»: «значение», обрамлённых в фигурные скобки. JSON-объект может -быть описан непосредственно текстом в поле «JSON» либо быть созданным в -процессе выполнения других модулей. В случае формирования JSON-объекта в -других модулях, в поле необходимо ввести название переменной, в которой -лежит необходимый объект. - -**ПРИМЕР.** - -Пусть у нас есть текст в формате JSON. Введем его в поле JSON модуля, а -результат пусть запишется в переменную v.a. - -<center><img src="../media/image325.png" style="width:3.24952in;height:1.90909in" /></center> - -<center>Рис. 11. Пример заполнения</center> - -В результате переменная v.a станет объектом с полями «name» и «age». К -полям объекта можно обратиться, написав название поля через точку после -переменной. Проверить значение переменной можно с помощью функционала -«Узнать значение переменной», доступного по кнопке <img src="../media/image326.png" style="width:0.29417in;height:0.18561in" /> -в обозревателе решений. - -<center><img src="../media/image327.png" style="width:3.63496in;height:2.13515in" /></center> - -<center>Рис. 12 Получение значения из поля «name» переменной «a»</center> - -На рисунке 12 видно, что на основе текста формата JSON создалась -переменная с указанными в нем полями и заполненными значениями. - ## Модуль «XML» Модуль «XML» предназначен для парсинга текста формата XML. Результатом @@ -334,7 +292,7 @@ Http-запросы – запросы для передачи информац <center><img src="../media/image328.png" style="width:4.25567in;height:2.468in" /></center> -<center>Рис. 13. Окно модуля «XML»</center> +<center>Рис. 10. Окно модуля «XML»</center> Поле «Переменная» заполняется названием переменной, в которую будет возвращен объект – результат работы модуля. @@ -346,7 +304,7 @@ Http-запросы – запросы для передачи информац <center><img src="../media/image329.png" style="width:4.01163in;height:2.77728in" /></center> -<center>Рис. 14. Объект – результат парсинга XML</center> +<center>Рис. 11. Объект – результат парсинга XML</center> ## Модуль «PDF» @@ -362,7 +320,7 @@ Http-запросы – запросы для передачи информац <center><img src="../media/image330.png" style="width:4.63636in;height:4.81132in" /></center> -<center>Рис. 15. Интерфейс модуля «PDF»</center> +<center>Рис. 12. Интерфейс модуля «PDF»</center> **Поле «Действие».** Представляет собой выпадающий список из доступных в модуле действий. @@ -387,7 +345,7 @@ Http-запросы – запросы для передачи информац <center><img src="../media/image331.png" style="width:4.42857in;height:1.56089in" /></center> -<center>Рис. 16. Пример настройки действия «Получить text»</center> +<center>Рис. 13. Пример настройки действия «Получить text»</center> #### Получить image @@ -397,7 +355,7 @@ Http-запросы – запросы для передачи информац <center><img src="../media/image332.png" style="width:4.38961in;height:1.54664in" /></center> -<center>Рис. 17. Пример настройки действия «Получить image»</center> +<center>Рис. 14. Пример настройки действия «Получить image»</center> #### Объединить документы @@ -406,7 +364,7 @@ Http-запросы – запросы для передачи информац <center><img src="../media/image333.png" style="width:4.27273in;height:1.50905in" /></center> -<center>Рис. 18. Пример настройки действия «Объединить документы»</center> +<center>Рис. 15. Пример настройки действия «Объединить документы»</center> ## Модуль «Пауза» @@ -418,7 +376,7 @@ Http-запросы – запросы для передачи информац <center><img src="../media/image334.png" style="width:3.38961in;height:1.31711in" /></center> -<center>Рис. 19. Окно модуля «Пауза»</center> +<center>Рис. 16. Окно модуля «Пауза»</center> ## Модуль «Прокси» @@ -428,7 +386,7 @@ Http-запросы – запросы для передачи информац <center><img src="../media/image335.png" style="width:5.0894in;height:1.3184in" /></center> -<center>Рис. 20. Окно модуля «Прокси»</center> +<center>Рис. 17. Окно модуля «Прокси»</center> ## Модуль «Лог» @@ -437,7 +395,7 @@ Http-запросы – запросы для передачи информац <center><img src="../media/image336.png" style="width:5.31169in;height:2.73855in" /></center> -<center>Рис. 21. Окно модуля «Лог»</center> +<center>Рис. 18. Окно модуля «Лог»</center> ## Модуль «Локальный робот» @@ -450,18 +408,90 @@ Http-запросы – запросы для передачи информац <center><img src="../media/image352.png" /></center> -<center>Рис. 22. Окно модуля «Локальный робот»</center> +<center>Рис. 19. Окно модуля «Локальный робот»</center> + +## Модуль «Робот-функция» + +С помощью данного модуля есть возможность использовать в роботе существующего, опубликованного +в оркестраторе, робота. Робот-функция будет работать в своей изолированной среде – у него будут +свои переменные, не пересекающиеся с переменными основного робота. + +Для настройки действия необходимо выбрать одного из опубликованных роботов, указать +название входной переменной и переменной, в которую будет записан результат работы робота. + +<center><img src="../media/image365.png" /></center> + +<center>Рис. 20. Окно модуля «Робот-функция»</center> + +***Переменная-аргумент запуска.*** Если в вашем роботе-функции необходимы несколько значений, +то создайте переменную-объект, которая будет иметь столько полей, сколько вам необходимо. +Например, функция, которая рассчитывает некоторый показатель по нескольким значениям – +n1 и n2, должна принимать на вход переменную-объект, в которой присутствуют оба этих поля +(v.number.n1 и v.number.n2, как пример). Обратите внимание, что внутри робота-функции вы +должны будете обрабатывать переменную v.args как входную, независимо от того, какую +переменную как входную вы указали в модуле «Робот-функция». То есть, если в модуле в поле +«Переменная-аргумент запуска» вы указали переменную «v. number», то внутри самого +робота-функции значение v.number будет находиться в переменной v.args. Это сделано для +того, чтобы не нужно было запоминать используемую в функции переменную для её использования. + +***Результат.*** Для заполнения переменной-результата внутри робота-функции необходимо использовать +модуль Return и указать в нем переменную, значение которой должно быть помещено в указанную +переменную результат. + +<center><img src="../media/image366.png" /></center> + +<center>Рис. 21. Пример возврата переменной из робота-функции.</center> + +По кнопке «Загрузить робота» выбранный робот будет загружен в отдельной вкладке студии. ## Модуль «Облачный робот» -С помощью данного модуля есть возможность использовать в роботе существующего, опубликованного в оркестраторе, робота. +С помощью данного модуля есть возможность использовать в роботе существующего, +опубликованного в оркестраторе, робота. -Подключаемый робот будет использовать те же переменные, которые используются текущим роботом. +Данный вариант робота из оркестратора не имеет входных и выходных переменных – +он изменяет и использует переменные основного робота, как бы являясь его частью. -Для настройки действия необходимо выбрать одного из предложенных программой роботов, то есть тех, которые опубликованы текущим пользователем студии. +Для настройки действия необходимо выбрать одного из предложенных программой роботов, +то есть тех, которые опубликованы текущим пользователем студии. <center><img src="../media/image353.png" /></center> -<center>Рис. 23. Окно модуля «Облачный робот»</center> +<center>Рис. 22. Окно модуля «Облачный робот»</center> По кнопке «Загрузить робота» выбранный робот будет загружен в отдельной вкладке студии. + +## Модуль «Диспетчер учетных данных» + +Данный модуль позволяет работать с учетными данными Windows – создавать новые, +получать логины и пароли существующих записей или удалять их. + +<center><img src="../media/image367.png" /></center> + +<center>Рис. 23. Интерфейс окна модуля «Диспетчер учетных данных»</center> + +**Поле «Действие»** - выпадающий список, в котором предложены возможные действия +с учетными записями – создание новой, получение существующей и удаление существующей; + +**В поле «Адрес в Интернете или сети»** вводится адрес сети или сайта; + +**Поля «Пользователь», «Пароль», «Устойчивость» и «Тип»** необходимы к заполнению только +для создания новой учетной записи. + +В поле **«Пользователь»** вводится логин учетной записи, в поле **«Пароль»** соответственно +пароль от учетной записи. + +Поле **«Тип»** предлагает на выбор три типа учетной записи – «Учетные данные Windows», +«Учетные данные на основе сертификатов» и «Общие учетные данные». Учетные данные Windows — +это имена и пароли, которые используются для доступа к общим сетевым папкам, веб-сайтам, +применяющим интегрированную аутентификацию, а также при подключении к удаленному рабочему столу. +Учетные данные на основе сертификатов — предназначены для аутентификации с помощью смарт-карт. +Общие учетные данные — используются сторонними приложениями, для которых требуется отдельная +авторизация с учетными данными, отличными от тех, что применяются для входа в систему. + +Поле **«Устойчивость»** позволяет выбрать один из трех вариантов хранения учетных записей – +«Локальный компьютер», «Сеанс входа» и «Предприятие». + +В поле **«Название переменной»** вводится переменная, в которую будет возвращен результат +получения учетной записи или создания новой. Переменная будет являться объектом из +двух полей – Username и Password. diff --git a/mkdocs.yml b/mkdocs.yml index 22e59f0..4516a09 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -10,7 +10,7 @@ nav: - 'МОДУЛИ «ПОЧТОВЫЕ АГЕНТЫ»': 'email.md' - 'МОДУЛИ-ОПЕРАТОРЫ: «ЦИКЛ», «УСЛОВИЕ», «WHILE», «TRY-CATCH», «BREAK», «RETURN», «SWITCH»': 'operators.md' - 'МОДУЛЬ «РАБОТА С БРАУЗЕРОМ»': 'browser.md' - - 'МОДУЛЬ «ИНТЕРФЕЙС»': 'iterface.md' + - 'МОДУЛЬ «ИНТЕРФЕЙС»': 'interface.md' - 'МОДУЛИ ДЛЯ РАБОТЫ С ТЕКСТОМ': 'text_analysis.md' - 'МОДУЛЬ «TELEGRAM»': 'telegram.md' - 'ДРУГИЕ МОДУЛИ': 'other.md'