36 KiB
Модуль «Excel»
Модуль «Excel» является самым обширным модулем в программе. Данный модуль предназначен для обработки Excel-файлов в фоновом режиме, незаметном для пользователя компьютера. Модуль последовательно выполнит заданный ему список команд.
Интерфейс модуля
Окно модуля состоит из нескольких разделов: «Добавить команду», «Общие настройки», «Список команд» и окно с предварительным просмотром файла.
Окно предварительного просмотра позволяет просматривать все листы загруженного файла с помощью вкладок с названиями листов и полосы прокрутки. Также есть возможность вписывать в ячейки свои значения, применять различное форматирование, но эти изменения сохранены не будут, то есть данный функционал доступен только для «примерки».
## Раздел «Общие настройки» ### Загрузить файлРаздел «Общие настройки» состоит из поля «Имя файла» и кнопок «Загрузить файл» и «Выбрать ячейку».
Работу с модулем Excel советуем начинать с выбора рабочего файла. После того, как по кнопке «Загрузить файл» будет выбран файл, необходимо подождать несколько секунд и указанный файл будет отображен в окне предварительного просмотра.
## Разделы «Добавить команду» и «Список команд»Раздел «Добавить команду» является основным «полотном» данного модуля. В нем создаются действия, имитирующие работу пользователя, например, такие как считать некоторый диапазон ячеек, затем перенести его на другой лист, удалить дубликаты и построить круговую диаграмму. В данном случае было описано 4 действия. Эти 4 действия необходимо последовательно выбирать и добавлять в раздел «Список команд» - таблицу, отображающую все действия, которые будут выполняться данным модулем. Набор полей в данном разделе не всегда одинаков – он меняется в зависимости от выбранного действия в первом поле.
Кнопки «Добавить», «Редактировать» и «Удалить» предназначены для работы с разделами «Добавить команду» и «Список команд».
### Добавление командыДля добавления команды предусмотрена кнопка «Добавить». Она заносит созданное действие в таблицу «Список команд».
При выборе строки в списке команд информация по выбранному действию отобразится в разделе «Добавить команду».
Помимо описанного функционала, кнопка «Добавить» служит для копирования уже имеющихся действий в списке команд. Для этого необходимо выбрать строку в списке команд и нажать на кнопку «Добавить». Таким образом, если нужно выполнить действие несколько раз, достаточно его копировать, а не создавать вновь.
### Редактирование командыДля редактирования команды предусмотрена кнопка «Редактировать». Чтобы изменить команду, выделите ее в списке команд, внесите необходимые изменения в разделе «Добавить команду» и нажмите на кнопку «Редактировать» для сохранения изменений.
### Изменение порядка действийДля изменения порядка действий предусмотрены кнопки с иконками стрелок «Вверх» и «Вниз». Кнопки расположены справа от списка команд.
Изменение порядка действий бывает необходимо, когда требуется добавить действие, которое не предусмотрели сразу и не внесли в список команд. В таком случае вы можете добавить действие стандартным способом, а затем переместить его.
### Удаление командыКнопка «Удалить» удаляет выбранную строку из списка команд.
### Отключение командыЕсли вы не хотите удалять команду, так как хотели бы, например, проверить, как работает робот без неё, а затем вернуть её в работу, то можно отключить команду, нажав на соответствующую ей строку правой кнопкой мыши и отключить или, наоборот, включить её.
### Выбор ячейкиКнопка «Выбрать ячейку» работает для каждого действия по-своему, но смысл у неё один – она заполняет поле «Ячейки» или «Диапазон» (в зависимости от того, какое из них используется в выбранном действии) названием выбранной в окне предварительного просмотра ячейки / диапазона и вписывает в поле «Лист» название листа, на котором находятся выбранные ячейки. В некоторых действиях по кнопке заполняется только одна ячейка, хотя был выбран диапазон – это означает, что в данном действии использование диапазона невозможно.
В некоторых действиях кнопка «Выбрать ячейку» заполняет номера колонок, строк, какие-либо значения. При работе с файлами рекомендуется её использование для минимизации возникновения синтаксических ошибок.
### Сохранение командыДля сохранения команды в модуле Excel нажмите на кнопку «Сохранить» в правом нижнем углу модуля.
## Описание действий, доступных в модулеДействия разделены на группы для удобной навигации по выпадающему списку. Если вы знаете точное название действия, то вы можете начать вводить его в поле «Действие», и программа постарается подсказать вам то действие, которое вы ищите. ### Группа «Работа с данными» #### Действие «Считать данные»
Данное действие позволяет считать значение из одной конкретной ячейки, либо из диапазона ячеек. Если будет указана одна ячейка, то создастся переменная с типом «Элемент», если же диапазон, то будет создана переменная с типом «Таблица».
#### Действие «Записать данные»Действие позволяет записать указанное значение в одну или в диапазон ячеек.
#### Действие «Формула»Действие позволяет записать формулу в указанную ячейку (или в диапазон) и вернуть её результат в указанную переменную. Поле «Переменная» можно оставить пустым, если результат выполнения данной формулы не важен.
#### Действие «Получить формулу»Действие возвращает формулу из ячейки в указанную переменную.
#### Действие «Заменить формулу на её значение»Данное действие заменяет формулу в ячейке или диапазоне ячеек на её результат.
### Группа «Работа со строками» #### Действие «Добавить строку»Действие вставляет новую строку в указанное место.
#### Действие «Удалить строку»Действие удаляет указанную строку.
#### Действие «Получить количество строк»Действие возвращает номер последней используемой строки в листе в указанную переменную.
#### Действие «Получить количество отфильтрованных строк»Действие возвращает количество видимых строк при примененном фильтре в указанную переменную.
### Группа «Работа с колонками» #### Действие «Добавить столбец»Действие добавляет новый столбец в указанное место.
#### Действие «Удалить столбец»Действие удаляет указанный столбец.
#### Действие «Получить количество столбцов»Действие возвращает номер самого последнего используемого столбца.
### Группа «Работа с листами и файлами» #### Действие «Создать новый лист»Действие создает новый лист с указанным именем.
#### Действие «Удалить лист»Действие удаляет лист с указанным именем.
#### Действие «Очистить лист»Действие очищает ячейки листа от данных. Не очищает форматирование!
#### Действие «Создать новый файл»Действие создает в указанной папке новый файл с названием и указанным расширением (если расширение не указано, создается файл .xlsx). Если поле «Лист» заполнено, то первый лист файла будет назван так, как указано в поле, иначе - по умолчанию (Лист 1, Sheet 1, в зависимости от языка системы).
#### Действие «Заполнить лист на основе Excel-файла»Данное действие производит заполнение листа текущего файла по аналогии с листом какого-либо другого файла. В поле «Лист» указывается лист текущего файла.
#### Действие «Экспортировать в PDF»Действие позволяет сохранить Excel-файл в формате PDF стандартными методами Windows, то есть деление листа Excel-файла на листы в документе PDF будет производиться по стандартным настройкам, указанным в файле Excel (по умолчанию размер листа А4, с обычными полями).
Название файла и его расположение будут совпадать с экспортируемым файлом. ### Группа «Поиск» #### Действие «Найти данные»
Ищет заданную строку в указанном листе и возвращает адрес первой найденной ячейки.
#### Действие «Поиск строки по значениям колонок»Данное действие ищет и возвращает номер первой найденной строки, в заданных колонках которой записаны указанные значения.
В данном случае будет искаться строка, в колонке A которой 23.03.2020, а в колонке B – Уфа. #### Действие «Найти лист»
Ищет лист, в котором есть ячейка с указанным в поле «Строка» значением и возвращает его название в указанную переменную.
### Группа «Другие функции» #### Действие «Сместить ячейку»Смещает заданную ячейку на указанное количество строк и колонок, затем возвращает результат в переменную (в данном примере результатом будет ячейка D13).
#### Действие «Наложить фильтр»Данное действие добавляет фильтр в таблицу на указанном листе, ячейка из которой указана в поле «Ячейка из диапазона значений». В поле столбец записывается столбец, к которому необходимо применить фильтр. Фильтруемый столбец должен быть один. Если необходимо применить несколько фильтров к одной таблице, то необходимо добавить для каждого фильтра свое действие в рамках одного Excel-модуля. Функция, по которой должно происходить сравнение, выбирается из выпадающего списка в поле «Функция», значение, с которым будет происходить сравнение при фильтрации, указано в поле «Значение».
#### Действие «Удалить фильтр»Действие удаляет все фильтры с листа.
#### Действие «Добавить сортировку»Действие добавляет сортировку к указанному диапазону по выбранному столбцу. В зависимости от флажка определяется, сортируется столбец по убыванию или по возрастанию. Столбец для сортировки должен быть один.
#### Действие «Очистить диапазон»Действие удаляет все значения и форматирования ячеек в указанном диапазоне.
#### Действие «Получить уникальные значения столбца»Аналогично действию «Удалить дубликаты» в Excel, данное действие возвращает только уникальные значения указанных столбцов из диапазона. Итоговая таблица может быть вставлена как в тот же лист, так и в другой в лист, но в тот же диапазон. В зависимости от наличия дубликатов, количество строк может быть уменьшено.
#### Действие «Промежуточные итоги»Действие добавляет операцию Excel «Промежуточные итоги» на указанный лист к указанному диапазону.
Поле «Для колонок» соответствует полю в Excel «Добавить итоги по» (выделено зеленым), поле «При каждом изменении в колонке» соответствует аналогичному полю в Excel, но должно быть заполнено названием колонки Excel (A, B, … или 1, 2, …) (выделено красным), поле «Функция» заполняется операцией, которая должна быть применена для выбранных колонок (выделено синим).
#### Действие «Сводная таблица»Добавляет сводную таблицу в указанные лист и диапазон (поле «Лист, диапазон для вставки) на основе данных таблицы из поля «Лист, диапазон источника».
В поля «Поля в столбцах», «Поля в значениях» и «Поля в строках» вписываются названия колонок таблицы-источника (а не Excel-таблицы), как в программе Excel:
«Поля в столбцах» соответствуют названиям столбцов таблицы, значения которых должны быть расположены в столбцах сводной таблицы (выделено зеленым);
«Поля в значениях» соответствуют названиям столбцов таблицы, значения которых должны быть расположены в значениях сводной таблицы (выделено красным);
«Поля в строках» соответствуют названиям столбцов таблицы, значения которых должны быть расположены в строках сводной таблицы (выделено синим);
#### Действие «Скопировать и вставить ячейку/диапазон»Данное действие позволяет скопировать данные и форматирование и вставить их в тот же или в другой файл. С помощью него можно «растягивать» формулы (см. «Действие «Формула»).
#### Действие «Отобразить в виде процентов»Действие переводит выбранный диапазон в проценты.
#### Действие «Круговая диаграмма» Действие создает на указанном листе круговую диаграмму. Значения диаграммы берутся из диапазона, указанного в поле «Ячейки», диапазон с названиями значений указывается в поле «Диапазон названий». В поле «Расположение» указываются границы расположения круговой диаграммы, а именно левый верхний угол и правый нижний через запятую.
#### Действие «График»Действие создает линейный график с одним или несколькими рядами. Ряд необходимо указать в поле «Диапазон значений» в виде одномерного диапазона (по одной колонке или по одной строке). Если рядов больше, чем один, то последующие ряды нужно указать в таком же виде через «;». Диапазон аргументов должен быть один и указывается аналогично ряду. «Ячейки с названиями рядов» заполняются названиями ячеек через «;», их количество должно быть равно количеству рядов, первая ячейка отображает название первого ряда и т.д. В ячейку для вставки записывается ячейка, в которой будет располагаться левый верхний угол графика.
#### Действие «Проверка значений»Действие создает ограничение типов данных, которые можно ввести в выбранные ячейки, путем выбора предложенных правил. В поле «Лист» вводится лист, в ячейки которого добавляются ограничения, в поле «Ячейки» вводится диапазон ячеек, на которых будет проводиться проверка значений при вводе. В поле «Тип данных» выбирается один из предложенных типов данных – целое или действительное число, список, дата, длина текста, время. Поле «Операция» состоит из списка доступных операций для составления правила проверки – равно, не равно, больше, меньше, больше или равно, меньше или равно, между и вне. При использовании типа данных «Список» заполнение поля «Операция» не требуется, поэтому оно не доступно для редактирования.
Последнее поле меняется в зависимости от типа данных – для типа «Список» это будет «Источник данных», для всех остальных – «Критерии (ч/з ;)». Поле «Источник данных» заполняется диапазоном значений (внутри одного столбца или одной строки), в которой будет указан в списке (если список статичный, то указывайте абсолютную ссылку). Поле «Критерии (ч/з ;)» заполняется значениями, относительно которых будет применяться правило проверки.
Поле «Сообщение об ошибке» заполняется текстом ошибки, которая будет отображаться, если в ячейку введено значение, не удовлетворяющее заданному для неё правилу. Является необязательным полем. Если оставить его пустым, то будет отображаться ошибка «Введенное значение неверно. Набор значений, которые могут быть введены в ячейку, ограничен».
### Группа «Форматирование» #### Действие «Условное форматирование»Действие форматирует указанные ячейки на выбранном листе в зависимости от того, удовлетворяют ли они указанному условию. В поле «Лист, диапазон» через запятую вводятся лист и диапазон или одна ячейка из этого листа, к которым будет применяться условное форматирование. В полях «Цвет заливки» и «Цвет текста» указываются цвета, которыми будет залита ячейка и окрашен текст в ней, если она будет удовлетворять условию. Условие составляется из выбора функции и указания значения для сравнения. Доступные функции – равно, не равно, больше, меньше, больно или равно, меньше или равно, формула. Если выбрана функция «формула», то в поле «Значение для сравнение» следует вписать формулу в формате Excel, начиная со знака «=».
#### Действие «Цвет ячейки/диапазона»Действие меняет цвет заливки текста и самого текста в указанном диапазоне / ячейке.
#### Действие «Ширина столбца(-ов)»Действие изменяет ширину указанных столбцов. Столбцы можно перечислять через запятую, писать их номера вместо названий (с 1-цы). Ширина указывается в той же единице измерения, которая используется в Excel.
#### Действие «Высота строки (-ок)»Действие изменяет высоту указанных строк. Используется та же единица измерения, что и в Excel.
#### Действие «Объединить ячейки»Действие объединяет указанные ячейки на выбранном листе. В модуле предусмотрено три вида объединений:
• простое объединение – то есть объединяются и колонки, и столбцы диапазона;
• объединение по строкам;
• объединение по столбцам.
#### Действие «Очистить форматирование»Действие очищает форматирование в указанном диапазоне выбранного листа.
#### Действие «Формат ячейки»Действие меняет формат указанной ячейки на выбранный. По умолчанию, все значения, заносимые в Excel студией, имеют строковый формат, поэтому, для корректного пересчета формул или сортировки, необходимо привести данные к нужному формату.
#### Действие «Формат числа»Действие отображает число по определенным правилам числового формата Excel.
Примеры форматов можно посмотреть в программе Excel, кликнув правой кнопкой левой кнопкой мыши по ячейке – «Формат ячейки» – вкладка «Число» - (все форматы):
Наиболее часто используемые форматы числа предлагаются в студии при наведении на поле для ввода формата.
#### Действие «Выравнивание»Действие применяет заданное выравнивание в указанных ячейках. В поле «Общее положение» предлагается выбрать одно из двух – по вертикали или по горизонтали применять выравнивание, выбранное в поле «Выравнивание содержимого», которое, в свою очередь, предлагает выбрать выравнивание содержимого по левому/правому краю, либо по верхнему/нижнему краю, либо по центру.
#### Действие «Шрифт»Действие меняет шрифт, стиль или размер выбранных ячеек на указанном листе. Модуль предоставляет выбор всех стандартных шрифтов, доступных в пакете Microsoft Office.
#### Действие «Границы»Действие добавляет или изменяет границы выбранных ячеек на указанном листе. Предполагает настройку расположения границ – внешние, внутренние, только правая и др., цвет границ и их стиль – толстая, тонкая, штриховая линия и др.
## Модуль «Закрыть Excel-файл»Excel-модуль работает с файлами следующим образом – как только он начинает работу с некоторым файлом, то он открывает его (в фоновом, незаметном для пользователя, режиме), и держит открытым до конца работы робота. Это было сделано для ускорения работы модуля Excel – если модулей, использующих один и тот же файл, к примеру, несколько, пришлось бы несколько раз открывать и сохранять файл столько раз, сколько он используется что отразилось бы на быстродействии программы. В связи с этим, файл открывается при первом его использовании в модуле Excel и сохраняется только один раз – в самом конце. Но! Так как файл является открытым, с самим файлом нельзя ничего делать – переносить, архивировать, удалять за ненадобностью (например, провели расчеты в новом файле, взяли данные и затем его удалили), так как он занят. Для таких задач существует модуль «Закрыть Excel-файл» - он закрывает и сохраняет заданные ему файлы. Если эти файлы впоследствии снова будут использоваться – они опять откроются и, в следующий раз, будут закрыты либо этим же модулем, либо в конце работы робота.
Интерфейс модуля состоит из одного поля и списка путей к файлам, которые необходимо закрыть.
Поле «Путь к файлу» заполняется путем до файла, который необходимо закрыть. Он может содержаться в переменной, или можно выбрать его вручную, нажав на кнопку с изображением папки, находящуюся в поле для ввода.
По кнопке «Добавить» указанный в поле «Путь к файлу» путь будет занесен в «Список файлов».
По кнопке «Удалить» можно удалить выбранный путь из «Списка файлов».