diff --git a/docs/excel.md b/docs/excel.md index d55251c..5042fb9 100644 --- a/docs/excel.md +++ b/docs/excel.md @@ -103,7 +103,110 @@
Название файла и его расположение будут совпадать с экспортируемым файлом. ### Группа «Поиск» - - - - +#### Действие «Найти данные» +
Ищет заданную строку в указанном листе и возвращает адрес первой найденной ячейки. +
Данное действие ищет и возвращает номер первой найденной строки, в заданных колонках которой записаны указанные значения. +
В данном случае будет искаться строка, в колонке 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-файл» - он закрывает и сохраняет заданные ему файлы. Если эти файлы впоследствии снова будут использоваться – они опять откроются и, в следующий раз, будут закрыты либо этим же модулем, либо в конце работы робота. +
Интерфейс модуля состоит из одного поля и списка путей к файлам, которые необходимо закрыть. +
Поле «Путь к файлу» заполняется путем до файла, который необходимо закрыть. Он может содержаться в переменной, или можно выбрать его вручную, нажав на кнопку с изображением папки, находящуюся в поле для ввода. +
По кнопке «Добавить» указанный в поле «Путь к файлу» путь будет занесен в «Список файлов». +
По кнопке «Удалить» можно удалить выбранный путь из «Списка файлов». diff --git a/docs/img/excel_30.png b/docs/img/excel_30.png new file mode 100644 index 0000000..6dc3daf Binary files /dev/null and b/docs/img/excel_30.png differ diff --git a/docs/img/excel_31.png b/docs/img/excel_31.png new file mode 100644 index 0000000..4569c51 Binary files /dev/null and b/docs/img/excel_31.png differ diff --git a/docs/img/excel_32.png b/docs/img/excel_32.png new file mode 100644 index 0000000..a2f9d95 Binary files /dev/null and b/docs/img/excel_32.png differ diff --git a/docs/img/excel_33.png b/docs/img/excel_33.png new file mode 100644 index 0000000..c3abfc5 Binary files /dev/null and b/docs/img/excel_33.png differ diff --git a/docs/img/excel_34.png b/docs/img/excel_34.png new file mode 100644 index 0000000..1974707 Binary files /dev/null and b/docs/img/excel_34.png differ diff --git a/docs/img/excel_35.png b/docs/img/excel_35.png new file mode 100644 index 0000000..2741595 Binary files /dev/null and b/docs/img/excel_35.png differ diff --git a/docs/img/excel_36.png b/docs/img/excel_36.png new file mode 100644 index 0000000..81c5894 Binary files /dev/null and b/docs/img/excel_36.png differ diff --git a/docs/img/excel_37.png b/docs/img/excel_37.png new file mode 100644 index 0000000..b26423d Binary files /dev/null and b/docs/img/excel_37.png differ diff --git a/docs/img/excel_38.png b/docs/img/excel_38.png new file mode 100644 index 0000000..82cfc94 Binary files /dev/null and b/docs/img/excel_38.png differ diff --git a/docs/img/excel_39.png b/docs/img/excel_39.png new file mode 100644 index 0000000..68f1329 Binary files /dev/null and b/docs/img/excel_39.png differ diff --git a/docs/img/excel_40.png b/docs/img/excel_40.png new file mode 100644 index 0000000..4c78df9 Binary files /dev/null and b/docs/img/excel_40.png differ diff --git a/docs/img/excel_41.png b/docs/img/excel_41.png new file mode 100644 index 0000000..effd630 Binary files /dev/null and b/docs/img/excel_41.png differ diff --git a/docs/img/excel_42.png b/docs/img/excel_42.png new file mode 100644 index 0000000..dff9224 Binary files /dev/null and b/docs/img/excel_42.png differ diff --git a/docs/img/excel_43.png b/docs/img/excel_43.png new file mode 100644 index 0000000..508aed1 Binary files /dev/null and b/docs/img/excel_43.png differ diff --git a/docs/img/excel_44.png b/docs/img/excel_44.png new file mode 100644 index 0000000..752eef6 Binary files /dev/null and b/docs/img/excel_44.png differ diff --git a/docs/img/excel_45.png b/docs/img/excel_45.png new file mode 100644 index 0000000..12bdf4a Binary files /dev/null and b/docs/img/excel_45.png differ diff --git a/docs/img/excel_46.png b/docs/img/excel_46.png new file mode 100644 index 0000000..4408156 Binary files /dev/null and b/docs/img/excel_46.png differ diff --git a/docs/img/excel_47.png b/docs/img/excel_47.png new file mode 100644 index 0000000..fb7d89a Binary files /dev/null and b/docs/img/excel_47.png differ diff --git a/docs/img/excel_48.png b/docs/img/excel_48.png new file mode 100644 index 0000000..d7bc8aa Binary files /dev/null and b/docs/img/excel_48.png differ diff --git a/docs/img/excel_49.png b/docs/img/excel_49.png new file mode 100644 index 0000000..5af96ab Binary files /dev/null and b/docs/img/excel_49.png differ diff --git a/docs/img/excel_50.png b/docs/img/excel_50.png new file mode 100644 index 0000000..f72ded3 Binary files /dev/null and b/docs/img/excel_50.png differ diff --git a/docs/img/excel_51.png b/docs/img/excel_51.png new file mode 100644 index 0000000..609fab7 Binary files /dev/null and b/docs/img/excel_51.png differ diff --git a/docs/img/excel_52.png b/docs/img/excel_52.png new file mode 100644 index 0000000..b9bab3f Binary files /dev/null and b/docs/img/excel_52.png differ diff --git a/docs/img/excel_53.png b/docs/img/excel_53.png new file mode 100644 index 0000000..4b1f393 Binary files /dev/null and b/docs/img/excel_53.png differ diff --git a/docs/img/excel_54.png b/docs/img/excel_54.png new file mode 100644 index 0000000..8f6dc94 Binary files /dev/null and b/docs/img/excel_54.png differ diff --git a/docs/img/excel_55.png b/docs/img/excel_55.png new file mode 100644 index 0000000..e8bb81a Binary files /dev/null and b/docs/img/excel_55.png differ diff --git a/docs/img/excel_56.png b/docs/img/excel_56.png new file mode 100644 index 0000000..ea8be4d Binary files /dev/null and b/docs/img/excel_56.png differ diff --git a/docs/img/excel_57.png b/docs/img/excel_57.png new file mode 100644 index 0000000..252deb7 Binary files /dev/null and b/docs/img/excel_57.png differ diff --git a/docs/img/excel_58.png b/docs/img/excel_58.png new file mode 100644 index 0000000..5158e85 Binary files /dev/null and b/docs/img/excel_58.png differ diff --git a/docs/img/excel_59.png b/docs/img/excel_59.png new file mode 100644 index 0000000..a94e86f Binary files /dev/null and b/docs/img/excel_59.png differ diff --git a/docs/img/excel_60.png b/docs/img/excel_60.png new file mode 100644 index 0000000..68c7c32 Binary files /dev/null and b/docs/img/excel_60.png differ diff --git a/docs/img/excel_61.png b/docs/img/excel_61.png new file mode 100644 index 0000000..9989645 Binary files /dev/null and b/docs/img/excel_61.png differ