модуль excel
111
docs/excel.md
|
@ -103,7 +103,110 @@
|
|||
<H1 align="center"></h1>
|
||||
<p>Название файла и его расположение будут совпадать с экспортируемым файлом.
|
||||
### Группа «Поиск»
|
||||
|
||||
|
||||
|
||||
|
||||
#### Действие «Найти данные»
|
||||
<p> Ищет заданную строку в указанном листе и возвращает адрес первой найденной ячейки.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Поиск строки по значениям колонок»
|
||||
<p> Данное действие ищет и возвращает номер первой найденной строки, в заданных колонках которой записаны указанные значения.
|
||||
<H1 align="center"></h1>
|
||||
<p> В данном случае будет искаться строка, в колонке A которой 23.03.2020, а в колонке B – Уфа.
|
||||
#### Действие «Найти лист»
|
||||
<p> Ищет лист, в котором есть ячейка с указанным в поле «Строка» значением и возвращает его название в указанную переменную.
|
||||
<H1 align="center"></h1>
|
||||
### Группа «Другие функции»
|
||||
#### Действие «Сместить ячейку»
|
||||
<p> Смещает заданную ячейку на указанное количество строк и колонок, затем возвращает результат в переменную (в данном примере результатом будет ячейка D13).
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Наложить фильтр»
|
||||
<p> Данное действие добавляет фильтр в таблицу на указанном листе, ячейка из которой указана в поле «Ячейка из диапазона значений». В поле столбец записывается столбец, к которому необходимо применить фильтр. Фильтруемый столбец должен быть один. Если необходимо применить несколько фильтров к одной таблице, то необходимо добавить для каждого фильтра свое действие в рамках одного Excel-модуля. Функция, по которой должно происходить сравнение, выбирается из выпадающего списка в поле «Функция», значение, с которым будет происходить сравнение при фильтрации, указано в поле «Значение».
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Удалить фильтр»
|
||||
<p> Действие удаляет все фильтры с листа.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Добавить сортировку»
|
||||
<p> Действие добавляет сортировку к указанному диапазону по выбранному столбцу. В зависимости от флажка определяется, сортируется столбец по убыванию или по возрастанию. Столбец для сортировки должен быть один.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Очистить диапазон»
|
||||
<p> Действие удаляет все значения и форматирования ячеек в указанном диапазоне.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Получить уникальные значения столбца»
|
||||
<p> Аналогично действию «Удалить дубликаты» в Excel, данное действие возвращает только уникальные значения указанных столбцов из диапазона. Итоговая таблица может быть вставлена как в тот же лист, так и в другой в лист, но в тот же диапазон. В зависимости от наличия дубликатов, количество строк может быть уменьшено.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Промежуточные итоги»
|
||||
<p> Действие добавляет операцию Excel «Промежуточные итоги» на указанный лист к указанному диапазону.
|
||||
<H1 align="center"></h1>
|
||||
<p> Поле «Для колонок» соответствует полю в Excel «Добавить итоги по» (выделено зеленым), поле «При каждом изменении в колонке» соответствует аналогичному полю в Excel, но должно быть заполнено названием колонки Excel (A, B, … или 1, 2, …) (выделено красным), поле «Функция» заполняется операцией, которая должна быть применена для выбранных колонок (выделено синим).
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Сводная таблица»
|
||||
<p> Добавляет сводную таблицу в указанные лист и диапазон (поле «Лист, диапазон для вставки) на основе данных таблицы из поля «Лист, диапазон источника».
|
||||
<H1 align="center"></h1>
|
||||
<p> В поля «Поля в столбцах», «Поля в значениях» и «Поля в строках» вписываются названия колонок таблицы-источника (а не Excel-таблицы), как в программе Excel:
|
||||
<p> «Поля в столбцах» соответствуют названиям столбцов таблицы, значения которых должны быть расположены в столбцах сводной таблицы (выделено зеленым);
|
||||
<p> «Поля в значениях» соответствуют названиям столбцов таблицы, значения которых должны быть расположены в значениях сводной таблицы (выделено красным);
|
||||
<p> «Поля в строках» соответствуют названиям столбцов таблицы, значения которых должны быть расположены в строках сводной таблицы (выделено синим);
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Скопировать и вставить ячейку/диапазон»
|
||||
<p> Данное действие позволяет скопировать данные и форматирование и вставить их в тот же или в другой файл. С помощью него можно «растягивать» формулы (см. «Действие «Формула»).
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Отобразить в виде процентов»
|
||||
<p> Действие переводит выбранный диапазон в проценты.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Круговая диаграмма»
|
||||
Действие создает на указанном листе круговую диаграмму. Значения диаграммы берутся из диапазона, указанного в поле «Ячейки», диапазон с названиями значений указывается в поле «Диапазон названий». В поле «Расположение» указываются границы расположения круговой диаграммы, а именно левый верхний угол и правый нижний через запятую.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «График»
|
||||
<p> Действие создает линейный график с одним или несколькими рядами. Ряд необходимо указать в поле «Диапазон значений» в виде одномерного диапазона (по одной колонке или по одной строке). Если рядов больше, чем один, то последующие ряды нужно указать в таком же виде через «;». Диапазон аргументов должен быть один и указывается аналогично ряду. «Ячейки с названиями рядов» заполняются названиями ячеек через «;», их количество должно быть равно количеству рядов, первая ячейка отображает название первого ряда и т.д. В ячейку для вставки записывается ячейка, в которой будет располагаться левый верхний угол графика.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Проверка значений»
|
||||
<p> Действие создает ограничение типов данных, которые можно ввести в выбранные ячейки, путем выбора предложенных правил. В поле «Лист» вводится лист, в ячейки которого добавляются ограничения, в поле «Ячейки» вводится диапазон ячеек, на которых будет проводиться проверка значений при вводе. В поле «Тип данных» выбирается один из предложенных типов данных – целое или действительное число, список, дата, длина текста, время. Поле «Операция» состоит из списка доступных операций для составления правила проверки – равно, не равно, больше, меньше, больше или равно, меньше или равно, между и вне. При использовании типа данных «Список» заполнение поля «Операция» не требуется, поэтому оно не доступно для редактирования.
|
||||
<p> Последнее поле меняется в зависимости от типа данных – для типа «Список» это будет «Источник данных», для всех остальных – «Критерии (ч/з ;)». Поле «Источник данных» заполняется диапазоном значений (внутри одного столбца или одной строки), в которой будет указан в списке (если список статичный, то указывайте абсолютную ссылку). Поле «Критерии (ч/з ;)» заполняется значениями, относительно которых будет применяться правило проверки.
|
||||
<p> Поле «Сообщение об ошибке» заполняется текстом ошибки, которая будет отображаться, если в ячейку введено значение, не удовлетворяющее заданному для неё правилу. Является необязательным полем. Если оставить его пустым, то будет отображаться ошибка «Введенное значение неверно. Набор значений, которые могут быть введены в ячейку, ограничен».
|
||||
<H1 align="center"></h1>
|
||||
### Группа «Форматирование»
|
||||
#### Действие «Условное форматирование»
|
||||
<p> Действие форматирует указанные ячейки на выбранном листе в зависимости от того, удовлетворяют ли они указанному условию. В поле «Лист, диапазон» через запятую вводятся лист и диапазон или одна ячейка из этого листа, к которым будет применяться условное форматирование. В полях «Цвет заливки» и «Цвет текста» указываются цвета, которыми будет залита ячейка и окрашен текст в ней, если она будет удовлетворять условию. Условие составляется из выбора функции и указания значения для сравнения. Доступные функции – равно, не равно, больше, меньше, больно или равно, меньше или равно, формула. Если выбрана функция «формула», то в поле «Значение для сравнение» следует вписать формулу в формате Excel, начиная со знака «=».
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Цвет ячейки/диапазона»
|
||||
<p> Действие меняет цвет заливки текста и самого текста в указанном диапазоне / ячейке.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Ширина столбца(-ов)»
|
||||
<p> Действие изменяет ширину указанных столбцов. Столбцы можно перечислять через запятую, писать их номера вместо названий (с 1-цы). Ширина указывается в той же единице измерения, которая используется в Excel.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Высота строки (-ок)»
|
||||
<p> Действие изменяет высоту указанных строк. Используется та же единица измерения, что и в Excel.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Объединить ячейки»
|
||||
<p> Действие объединяет указанные ячейки на выбранном листе. В модуле предусмотрено три вида объединений:
|
||||
<p> • простое объединение – то есть объединяются и колонки, и столбцы диапазона;
|
||||
<p> • объединение по строкам;
|
||||
<p> • объединение по столбцам.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Очистить форматирование»
|
||||
<p> Действие очищает форматирование в указанном диапазоне выбранного листа.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Формат ячейки»
|
||||
<p> Действие меняет формат указанной ячейки на выбранный. По умолчанию, все значения, заносимые в Excel студией, имеют строковый формат, поэтому, для корректного пересчета формул или сортировки, необходимо привести данные к нужному формату.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Формат числа»
|
||||
<p> Действие отображает число по определенным правилам числового формата Excel.
|
||||
<H1 align="center"></h1>
|
||||
<p> Примеры форматов можно посмотреть в программе Excel, кликнув правой кнопкой левой кнопкой мыши по ячейке – «Формат ячейки» – вкладка «Число» - (все форматы):
|
||||
<H1 align="center"></h1>
|
||||
<p> Наиболее часто используемые форматы числа предлагаются в студии при наведении на поле для ввода формата.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Выравнивание»
|
||||
<p> Действие применяет заданное выравнивание в указанных ячейках. В поле «Общее положение» предлагается выбрать одно из двух – по вертикали или по горизонтали применять выравнивание, выбранное в поле «Выравнивание содержимого», которое, в свою очередь, предлагает выбрать выравнивание содержимого по левому/правому краю, либо по верхнему/нижнему краю, либо по центру.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Шрифт»
|
||||
<p> Действие меняет шрифт, стиль или размер выбранных ячеек на указанном листе. Модуль предоставляет выбор всех стандартных шрифтов, доступных в пакете Microsoft Office.
|
||||
<H1 align="center"></h1>
|
||||
#### Действие «Границы»
|
||||
<p> Действие добавляет или изменяет границы выбранных ячеек на указанном листе. Предполагает настройку расположения границ – внешние, внутренние, только правая и др., цвет границ и их стиль – толстая, тонкая, штриховая линия и др.
|
||||
<H1 align="center"></h1>
|
||||
## Модуль «Закрыть Excel-файл»
|
||||
<p> Excel-модуль работает с файлами следующим образом – как только он начинает работу с некоторым файлом, то он открывает его (в фоновом, незаметном для пользователя, режиме), и держит открытым до конца работы робота. Это было сделано для ускорения работы модуля Excel – если модулей, использующих один и тот же файл, к примеру, несколько, пришлось бы несколько раз открывать и сохранять файл столько раз, сколько он используется что отразилось бы на быстродействии программы. В связи с этим, файл открывается при первом его использовании в модуле Excel и сохраняется только один раз – в самом конце. Но! Так как файл является открытым, с самим файлом нельзя ничего делать – переносить, архивировать, удалять за ненадобностью (например, провели расчеты в новом файле, взяли данные и затем его удалили), так как он занят. Для таких задач существует модуль «Закрыть Excel-файл» - он закрывает и сохраняет заданные ему файлы. Если эти файлы впоследствии снова будут использоваться – они опять откроются и, в следующий раз, будут закрыты либо этим же модулем, либо в конце работы робота.
|
||||
<p> Интерфейс модуля состоит из одного поля и списка путей к файлам, которые необходимо закрыть.
|
||||
<H1 align="center"></h1>
|
||||
<p> Поле «Путь к файлу» заполняется путем до файла, который необходимо закрыть. Он может содержаться в переменной, или можно выбрать его вручную, нажав на кнопку с изображением папки, находящуюся в поле для ввода.
|
||||
<p> По кнопке «Добавить» указанный в поле «Путь к файлу» путь будет занесен в «Список файлов».
|
||||
<p> По кнопке «Удалить» можно удалить выбранный путь из «Списка файлов».
|
||||
|
|
After Width: | Height: | Size: 10 KiB |
After Width: | Height: | Size: 14 KiB |
After Width: | Height: | Size: 11 KiB |
After Width: | Height: | Size: 11 KiB |
After Width: | Height: | Size: 21 KiB |
After Width: | Height: | Size: 9.3 KiB |
After Width: | Height: | Size: 10 KiB |
After Width: | Height: | Size: 10 KiB |
After Width: | Height: | Size: 13 KiB |
After Width: | Height: | Size: 22 KiB |
After Width: | Height: | Size: 17 KiB |
After Width: | Height: | Size: 31 KiB |
After Width: | Height: | Size: 21 KiB |
After Width: | Height: | Size: 31 KiB |
After Width: | Height: | Size: 11 KiB |
After Width: | Height: | Size: 14 KiB |
After Width: | Height: | Size: 26 KiB |
After Width: | Height: | Size: 25 KiB |
After Width: | Height: | Size: 28 KiB |
After Width: | Height: | Size: 16 KiB |
After Width: | Height: | Size: 10 KiB |
After Width: | Height: | Size: 9.9 KiB |
After Width: | Height: | Size: 22 KiB |
After Width: | Height: | Size: 10 KiB |
After Width: | Height: | Size: 10 KiB |
After Width: | Height: | Size: 11 KiB |
After Width: | Height: | Size: 26 KiB |
After Width: | Height: | Size: 34 KiB |
After Width: | Height: | Size: 14 KiB |
After Width: | Height: | Size: 22 KiB |
After Width: | Height: | Size: 23 KiB |
After Width: | Height: | Size: 26 KiB |