Открыть / Open
Открывает Excel-документ.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Путь до файла | Path to file | Путь к файлу, который необходимо открыть. Доступен ввод вручную, либо выбор папки в модальном окне "Открыть" по кнопке | Robin.Filepath | C:\Excel\Excel_file.xlsx | Да |
Видимый | Visible | Открытие документа в видимом режиме. Чек-бокс.
По умолчанию false. | Robin.Boolean | true | Нет |
Результаты | |||||
Контекст | Context | Уникальный идентификатор сеанса. Однозначно определяет к какому из открытых документов алгоритму следует обращаться. | Robin.Excel | EXCEL_INSTANCE | Да |
Особые условия использования
После завершения выполнения всех действий Система автоматически закрывает открытый Excel-документ.
Пример использования
Задача:
Существует Excel-документ "Test.xlsx".
Необходимо открыть файл "Test.xlsx".
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
Реализация:
- Открываем группу действий "Excel".
- Открываем подгруппу "Общие"
- Помещаем в рабочее пространство студии действие "Открыть".
Настройка действия:- Параметр "Контекст". Заполняется автоматически.
- Параметр "Путь до файла". Указываем путь к файлу, который необходимо открыть.
- Параметр "Видимый". Устанавливаем признак.
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Документ "Test.xlsx" открыт.
Закрыть / Close
Закрывает Excel-документ.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Сохранить | Save | Сохранение документа перед закрытием. Чек-бокс. По умолчанию false. | Robin.Boolean | true | Нет |
Особые условия использования
Блок "Закрыть" не предполагает в себе действия по сохранению файла, поэтому его необходимо использовать в связке с "Сохранить" (см. описание действия "Сохранить").
Пример использования
Задача:
Существует Excel-документ "Test.xlsx".
Необходимо закрыть заданный файл после выполнения действий с ним.
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Закрыть документ "Test.xlsx".
Реализация:
- Открываем группу действий "Excel".
- Открываем подгруппу "Общие"
- Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
- Помещаем в рабочее пространство студии действие "Закрыть".
Настройка действия:- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий документу "Test.xlsx".
- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий документу "Test.xlsx".
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Документ "Test.xlsx" закрыт.
Создать файл / Create file
Создает новый Excel-файл.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Имя | Name | Имя документа, который будет создан. | Robin.String | Test | Да |
Папка | Folder | Путь до папки, в которую будет сохранен документ. Доступен ввод вручную, либо выбор папки в модальном окне "Выбор папки" по кнопке . | Robin.FolderPath | C:\Users\Internet\Documents\RobinStudio\1 | Да |
Формат | Format | Формат, в котором будет создан документ. Выпадающий список. По умолчанию xlsx. | Robin.String | xls | Нет |
Перезаписать | Overwrite | Перезапись документа при совпадении названия в папке. Чек-бокс. По умолчанию false. Если:
| Robin.Boolean | true | Нет |
Особые условия использования
Если название файла указано в формате: "Test.xlsx", файл сохраняется с именем "name" без расширения.
Пример использования
Задача:
Необходимо создать Excel-документ с заданным наименованием в указанной папке.
Решение:
- Создать Excel-документ.
Реализация:
- Открываем группу действий "Excel".
- Открываем подгруппу "Общие"
- Помещаем в рабочее пространство студии действие "Создать файл Excel".
Настройка действия:- Параметр "Имя". Указываем наименование файла документа.
- Параметр "Папка". Указываем путь к папке, в которую будет сохранен документ.
- Параметр "Формат". Указываем формат сохранения
- Параметр "Перезаписать". Указываем параметр как активный.
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Документ "Test.xlsx" создан в папке.
Исполнить формулу / Apply formula to cell
Исполняет формулу в выбранной ячейке.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Имя листа | Sheet name | Наименование страницы, к которой будет применено действие | Robin.String | Лист1 | Нет |
Индекс листа | Sheet index | Порядковый номер страницы, к которой будет применено действие. Нумерация начинается с "1". По умолчанию "1" | Robin.String | 1 | Нет |
Формула | Formula | Формула, по которой будет выполнено вычисление в ячейке. Должна начинаться с символа "=". | Robin.String | =COUNTIF(I3:I{Rows},"Да") Считает количество ячеек со значением "Да" в полях с "I3" до "I" c номером в переменной "Rows" | Да |
Ячейка | Cell | Адрес ячейки, в которую будет записан результат выполнения формулы. Формат заполнения:"ХY", где "Х" - это номер столбца, а "Y" - номер строки. | Robin.String | A1 | Да |
Локальный язык | Local language | Локальное наименование формулы. | Robin.String | Подсчет_Да | Нет |
Особые условия использования
Формулы нужно использовать на английском языке. Посмотреть наименования функций можно на официальном сайте:
Пример использования
Задачи:
Существует Excel-документ "Test.xlsx".
Необходимо исполнить формулу по подсчету количество записей на странице.
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Исполнить формулу.
- Сохранить документ.
Реализация:
- Открываем группу действий "Excel".
- Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
- Помещаем в рабочее пространство студии действие "Исполнить формулу".
Настройка действия:- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
- Параметр "Формула". Указываем формулу для выполнения вычислений в ячейке.
- Параметр "Результат". Указываем переменную, в которую должен быть записан результат выполнения формулы.
- Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Документ содержит результат выполнения формулы в заданной ячейке.
Запустить макрос / Run macro
Запускает макрос.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Имя листа | Sheet name | Наименование страницы, к которой будет применено действие. | Robin.String | Лист1 | Нет |
Индекс листа | Sheet index | Порядковый номер листа документа, к которой будет применено действие. Нумерация начинается с "1". По умолчанию значение равно "1" | Robin.Numeric | 1 | Нет |
Имя макроса | Macro name | Наименование макроса, который будет запущен. | Robin.String | Run_Macros | Да |
Особые условия использования
Отсутствуют.
Пример использования
Задачи:
Существует Excel-документ "Test.xlsm".
Необходимо запустить макрос по подсчету количество записей на странице.
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Запустить макрос.
- Сохранить документ.
Реализация:
- Открываем группу действий "Excel".
- Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
- Помещаем в рабочее пространство студии действие "Запустить макрос".
Настройка действия:- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsm".
- Параметр "Имя макроса". Указываем наименование макроса, который необходимо выполнить.
- Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Документ содержит результат выполнения макроса.
Сохранить как / Save as
Сохраняет Excel-документ.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Имя файла | File name | Наименование нового документа, который будет создан. Если данное поле остается пустым, то файл сохраняется с тем же именем, который документ имел при открытии. | Robin.String | Тестовый файл | Да |
Папка | Folder | Путь к папке, в которую будет сохранен документ. Если поле остается пустым, то файл сохраняется в той же папке, из которой был открыт исходный файл. Доступен ввод вручную, либо выбор папки в модальном окне "Выбор папки" по кнопке . | Robin.FolderPath | C:\Excel | Да |
Формат | Format | Формат, в котором будет сохранен документ. Выпадающий список. Доступные к выбору расширения:
По умолчанию xlsx. | Robin.String | xlsx | Нет |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Существует Excel-документ "Test.xlsx".
Необходимо сохранить файл в исходном формате после внесенных изменений на страницу (например, применение фильтра).
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Установить фильтры.
- Сохранить Excel-документ.
Реализация:
- Открываем группу действий "Excel".
- Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
- Помещаем в рабочее пространство студии действие "Выбрать по фильтру" (см. описание действия "Выбрать по фильтру").
- Помещаем в рабочее пространство студии действие "Сохранить документ".
- Настройка действия:
- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
- Параметр "Имя файла". Указываем название файла, куда необходимо сохранить таблицу.
- Параметр "Папка". Указываем путь к папке, в которую будет сохранен документ.
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Создан файл "Тестовый файл". Файл содержит таблицу с отфильтрованными записями.
Изменить доступ / Change access
Изменяет доступ к Excel-документу.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Убрать общий доступ | Remove access | Запрет общего доступа к документу. Если чек-бокс:
| Robin.Boolean | √ | Нет |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Существует Excel-документ "Test.xlsx".
Необходимо изменить доступ к файлу "Test.xlsx".
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Изменить доступ к документу.
- Сохранить документ.
Реализация:
- Открываем группу действий "Excel".
- Помещаем в рабочее пространство студии действие "Изменить доступ".
Настройка действия:- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx"..
- Параметр "Убрать доступ". Устанавливаем чек-бокс.
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Доступ к документу "Test.xlsx" ограничен.
Сортировка / Sort
Сортирует данные в таблице.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие | Robin.Excel | EXCEL_INSTANCE | О |
Имя листа | Sheet name | Наименование страницы, к которой будет применено действие | Строка | Лист2 | Н |
Индекс листа | Sheet index | Индекс (порядковый номер) страницы, к которой будет применено действие. Порядковый номер начинается с "1" | Строка | 1 | Н |
Столбец | Column | Наименование столбца, в котором будет применяться действие | Строка | 1 | Н |
От | Start cell | Адрес начальной ячейки (начало диапазона), от которой будет установлена сортировка. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. | Строка | A1 | О |
До | End cell | Адрес конечной ячейки (конец диапазона), до которой будет установлена сортировка. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. | Строка | A1000 | О |
Порядок | Sort order |
| Строка | Н |
Особые условия использования
Если установленный диапазон (поля "От" и "До") содержит данные:
- одной колонки (например, от "А1" до "А10"), то сортировка данных происходит только в рамках данной колонки и установленного диапазона строк.
- двух и более колонок (например, от "А1" до "C10"), то сортировка данных происходит по первой заданной колонке (колонка "A"). Порядок данных, включенных в диапазон до поля "До" (включительно), меняется в зависимости от сортировки данных.
Порядок данных в таблице, которые не были включены в диапазон сортировки, не меняется.
Пример использования
Задача:
Существует Excel-документ "Test.xlsx".
Необходимо отсортировать Excel-документ по полю "id".
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Отсортировать таблицу по выбранному полю.
- Сохранить документ.
Реализация:
- Открываем группу действий "Excel".
- Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
- Помещаем в рабочее пространство студии действие "Сортировка".
Настройка действия:- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
- Параметр "От". Указываем ячейку, от которой будет установлена сортировка.
- Параметр "До". Указываем ячейку, до которой будет установлена сортировка.
- Параметр "По возрастанию". Указываем признак.
- Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Excel-документ отсортирован по полю "id".
Найти текст / Find text
Находит адрес ячейки по тексту, который написан в этой ячейке.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | О |
Имя листа | Sheet name | Наименование страницы, к которой будет применено действие | Строка | Лист1 | Н |
Индекс листа | Sheet index | Индекс (порядковый номер) страницы, к которой будет применено действие. | Строка | 1 | Н |
От | Start cell | Адрес начальной ячейки (начало диапазона), от которой будет установлена копируемая область. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. | Строка | A1 | Н |
До | End cell | Адрес конечной ячейки (конец диапазона), до которой будет установлена копируемая область. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. | Строка | B3 | Н |
Пропустить скрытые ячейки | Skip hidden | Если отмечено: действие ищет только видимые ячейки. Если не отмечено: действие ищет скрытые ячейки вместе с пустыми | Логический | Н | |
Текст | Text | Текст который будет храниться в искомой ячейке | Строка | 10 | О |
Поиск с помощью | Search by |
| Строка | Н | |
Результат | Result | Переменная, в которую будет записан список найденных ячеек | Словарь | Словарь | О |
Особые условия использования
Если поле "Столбец" не заполнен, то поиск осуществляется по всей странице.
Пример использования
Задача:
Существует Excel-документ "Test.xlsx".
Необходимо найти на странице все ячейки, содержащие значение "10".
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Найти адреса ячеек по заданному тексту.
Реализация:
- Открываем группу действий "Excel".
- Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
- Помещаем в рабочее пространство студии действие "Поиск ячейки".
Настройка действия:- Параметр "Контекст". Выбрать из выпадающего списка контекст соответствующий файлу "Test.xlsx".
- Параметр "Текст". Указываем текст, который должен храниться в искомой ячейке.
- Параметр "Результат". Указываем переменную, в которую должен быть записан адрес ячейки.
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Переменная "Массив_найденных_строк" содержит данные по ячейкам, в которых хранится искомый текст.