Открыть / Open

Открывает Excel-документ.

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
Путь до файлаPath to file

Путь к файлу, который необходимо открыть.

Доступен ввод вручную, либо выбор папки в модальном окне "Открыть" по кнопке

Robin.FilepathC:\Excel\Excel_file.xlsxДа
ВидимыйVisible

Открытие документа в видимом режиме.

По умолчанию false.

Если:

  • true, то действия, производимые в таблице, отображаются на экране.
  • false, то действия робота выполняются в фоновом режиме.

Robin.Boolean

trueНет
Результаты
КонтекстContext

Уникальный идентификатор сеанса, к которому будет применено действие.

Robin.ExcelEXCEL_INSTANCE

Особые условия использования

Автоматическое закрытие документа не предусмотрено. Необходимо использование действия "Закрыть".

Пример использования

Задача:

Существует Excel-документ "Test.xlsx".

Необходимо открыть файл "Test.xlsx".

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".

Реализация:

  1. Открываем группу действий "Excel".
  2. Открываем подгруппу "Общие"
  3. Помещаем в рабочее пространство студии действие "Открыть". 
    Настройка действия: 
    1. Параметр "Контекст". Заполняется автоматически.
    2. Параметр "Путь до файла". Указываем путь к файлу, который необходимо открыть.
    3. Параметр "Видимый". Устанавливаем признак.
  4. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Документ "Test.xlsx" открыт.

Закрыть / Close

Закрывает Excel-документ.

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
КонтекстContext

Уникальный идентификатор сеанса, к которому будет применено действие.

Robin.ExcelEXCEL_INSTANCEДа

Особые условия использования

Действие "Закрыть" не предполагает в себе действия по сохранению файла, поэтому его необходимо использовать в связке с "Сохранить как". (см. описание действия "Сохранить как").

Пример использования

Задача:

Существует Excel-документ "Test.xlsx". 

Необходимо закрыть заданный файл после выполнения действий с ним.

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Закрыть документ "Test.xlsx".

Реализация:

  1. Открываем группу действий "Excel".
  2. Открываем подгруппу "Общие"
  3. Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть"). 
  4. Помещаем в рабочее пространство студии действие "Закрыть". 
    Настройка действия: 
    1. Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий документу "Test.xlsx".
  5. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Документ "Test.xlsx" закрыт.

Создать файл Excel / Create Excel file

Создает новый Excel-файл.

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
ИмяName

Наименование нового документа, который будет создан.

Создает файл одного из стандартных расширений Excel (xls или xlsx), которое актуально для ПК, на котором запущена студия.

Robin.String

TestДа
ПапкаFolder

Путь до папки, в которую будет сохранен документ.

Доступен ввод вручную, либо выбор папки в модальном окне "Выбор папки" по кнопке .

Robin.FolderPathC:\Users\User\DesktopДа
ПерезаписатьOverwrite

Перезапись документа при совпадении названия в папке.

По умолчанию false.

Если:

  • true, то в случае если в указанной папке файл с таким же наименованием:
    • уже есть, то Система перезапишет существующий файл на указанный.
    • нет, то заданный файл будет добавлен в указанную папку.
  • false, то в случае если в указанной папке файл с таким же наименованием:
    • уже есть, то будет зафиксирована ошибка "Файл с таким именем уже существует". В результате файл добавлен не будет.
    • нет, то заданный файл будет добавлен в указанную папку.
Robin.BooleantrueНет

Особые условия использования

Если в поле "Имя" название файла указано с расширением, то в параметр записывается та часть текста, которая указана до расширения.

Например: "Test.xlsx", в параметр "Имя" будет записано "Test".

Сохранить в определенном расширении пользователь сможет позже действием "Сохранить как".

Пример использования

Задача:

Необходимо создать Excel-документ с заданным наименованием в указанной папке.

Решение:

  1. Создать Excel-документ.

Реализация:

  1. Открываем группу действий "Excel".
  2. Открываем подгруппу "Общие"
  3. Помещаем в рабочее пространство студии действие "Создать файл Excel". 
    Настройка действия: 
    1. Параметр "Имя". Указываем наименование файла документа.
    2. Параметр "Папка". Указываем путь к папке, в которую будет сохранен документ.
    3. Параметр "Перезаписать". Указываем параметр как активный.
  4. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Документ "Test.xlsx" создан в папке.

Исполнить формулу / Apply formula to cell (перенести в подгруппу "Ячейки")

Исполняет формулу в выбранной ячейке.

Настройки

Свойство

Англ. наименование

Описание

Тип

Пример заполненияОбязательность заполнения поля
Параметры
Контекст

Context

Уникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Имя листаSheet name

Наименование страницы, к которой будет применено действие.

Robin.String
Лист1Нет
Индекс листаSheet index

Порядковый номер страницы, к которой будет применено действие.

Нумерация начинается с "1".

Robin.Numeric

1Нет
ЯчейкаCell

Адрес ячейки, в которую будет записан результат выполнения формулы.

Формат заполнения:"ХY", где "Х" - это номер столбца, а "Y" - номер строки.

Robin.StringA1Да
ФормулаFormula

Формула, по которой будет выполнено вычисление в ячейке.

Должна начинаться с символа "=".

Robin.String

=COUNTIF(I3:I{Rows},"Да")

Да
Локальный языкLocal language

Использовать локальный язык формул.

По умолчанию false.

Robin.BooleantrueНет

Особые условия использования

По умолчанию используются формулы на английском языке.

Посмотреть наименования функций можно на официальном сайте: https://support.office.com/en-gb/article/excel-functions-by-category-5f91f4e9-7b42-46d2-9bd1-63f26a86c0eb

Для использования локального (в нашем случае русского) языка необходимо сделать пометку в поле "Локальный язык".

Пример использования

Задачи:

Существует Excel-документ "Test.xlsx".

Необходимо исполнить формулу по подсчету количество записей на странице. 

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Исполнить формулу.
  3. Сохранить документ.

Реализация:

  1. Открываем группу действий "Excel".
  2. Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
  3. Помещаем в рабочее пространство студии действие "Исполнить формулу". 
    Настройка действия: 
    1. Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
    2. Параметр "Формула". Указываем формулу для выполнения вычислений в ячейке.
    3. Параметр "Результат". Указываем переменную, в которую должен быть записан результат выполнения формулы.
  4. Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ").
  5. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Документ содержит результат выполнения формулы в заданной ячейке.

Запустить макрос / Run macro

Запускает макрос.

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Контекст

Context

Уникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Имя листаSheet name

Наименование листа, к которому будет применено действие.

Robin.String
Лист1Нет
Индекс листаSheet index

Порядковый номер листа документа, к которому будет применено действие.

Нумерация начинается с "1". 

Robin.Numeric

1Нет
Имя макросаMacro name

Наименование макроса, который будет запущен.

Robin.String

Run_MacrosДа

Особые условия использования

Отсутствуют.

Пример использования

Задачи:

Существует Excel-документ "Test.xlsm".

Необходимо запустить макрос по подсчету количество записей на странице. 

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Запустить макрос.
  3. Сохранить документ.

Реализация:

  1. Открываем группу действий "Excel".
  2. Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
  3. Помещаем в рабочее пространство студии действие "Запустить макрос". 
    Настройка действия: 
    1. Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsm".
    2. Параметр "Имя макроса". Указываем наименование макроса, который необходимо выполнить.
  4. Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ").
  5. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Документ содержит результат выполнения макроса.

Сохранить / Save

Сохраняет Excel-документ.

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
КонтекстContextУникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
ПапкаFolder

Путь к папке, в которую будет сохранен документ.

Если поле остается пустым, то файл сохраняется в той же папке, в которой был открыт исходный файл.

Доступен ввод вручную, либо выбор папки в модальном окне "Выбор папки" по кнопке .

Robin.FolderPath

 C:\Excel

Нет
Имя файлаFile name

Наименование нового документа, который будет создан.

Если данное поле остается пустым, то файл сохраняется с тем же именем, который документ имел при открытии.

Robin.StringНовый_файлНет
ФорматFormat

Формат, в котором будет сохранен документ.

Если данное поле остается пустым, то файл сохраняется в том же формате, который документ имел при открытии.

Выпадающий список.

Доступные к выбору расширения:

  • csv
  • dbf
  • dif
  • htm
  • html
  • mht
  • mhtml
  • ods
  • pdf
  • prn
  • slk
  • txt
  • wj2
  • wj3
  • wk1
  • wk3
  • wk4
  • wks
  • wq1
  • xla
  • xlam
  • xls
  • xlsb
  • xlsm
  • xlsx
  • xlt
  • xltm
  • xltx
  • xlw
  • xml
Robin.StringxlsxНет

Особые условия использования

Отсутствуют. 

Пример использования

Задача:

Существует Excel-документ "Test.xlsx".

Необходимо сохранить файл в исходном формате после внесенных изменений на страницу (например, применение фильтра).

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Установить фильтры.
  3. Сохранить Excel-документ.

Реализация:

  1. Открываем группу действий "Excel".
  2. Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть"). 
  3. Помещаем в рабочее пространство студии действие "Выбрать по фильтру" (см. описание действия "Выбрать по фильтру").
  4. Помещаем в рабочее пространство студии действие "Сохранить документ". 
  5. Настройка действия: 
    1. Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
    2. Параметр "Имя файла". Указываем название файла, куда необходимо сохранить таблицу.
    3. Параметр "Папка". Указываем путь к папке, в которую будет сохранен документ.
  6. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Создан файл "Тестовый файл". Файл содержит таблицу с отфильтрованными записями.


Изменить доступ / Change access

Изменяет доступ к Excel-документу.

Настройки

СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
Параметры
КонтекстContext

Уникальный идентификатор сеанса, к которому будет применено действие.

Robin.ExcelEXCEL_INSTANCEДа
Ограничить доступ
Limit access

Запрет общего доступа к документу.

Если:

  • true, то действие предоставляет документу эксклюзивный доступ. 
  • false, действие сохраняет документ с текущим именем и общим доступом.

По умолчанию false.

Robin.Boolean

trueНет

Особые условия использования

Отсутствуют.

Пример использования

Задача:

Существует Excel-документ "Test.xlsx".

Необходимо изменить доступ к файлу "Test.xlsx".

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Изменить доступ к документу.
  3. Сохранить документ.


Реализация:

  1. Открываем группу действий "Excel".
  2. Помещаем в рабочее пространство студии действие "Изменить доступ". 
    Настройка действия: 
    1. Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx"..
    2. Параметр "Убрать доступ". Устанавливаем чек-бокс.
  3. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Доступ к документу "Test.xlsx" ограничен.

Сортировка / Sort

Сортирует данные в таблице.

Настройки

Свойство

Англ. наименование

Описание

Тип

Пример заполнения

Обязательность заполнения поля

Параметры
Контекст

Context

Уникальный идентификатор сеанса, к которому будет применено действиеRobin.ExcelEXCEL_INSTANCEДа
Имя листаSheet nameНаименование листа, к которому будет применено действиеRobin.StringЛист2Нет
Индекс листаSheet index

Порядковый номер листа, к которому будет применено действие.

Порядковый номер начинается с "1".

Robin.Numeric1Нет
Столбец
Column

Наименование столбца, по которому будет проведена сортировка.

Если столбец не указан, то сортировка идет по первому в диапазоне.

Robin.StringА или 1Нет

Начало диапазона

Start cell

Адрес начальной ячейки, от которой будет установлен диапазон сортировки.

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.

По умолчанию применяются границы используемой области из контекста.

Robin.StringA1Нет

Конец диапазона

End cell

Адрес конечной ячейки, до которой будет установлен диапазон сортировки.

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.


По умолчанию применяются границы используемой области из контекста.

Robin.StringВ1000Нет
ПорядокOrder

Порядок сортировки.

  • от A до Я / по возрастанию
  • от Я до A / по убыванию

По умолчанию "от A до Я / по возрастанию"

Robin.String

от A до Я / по возрастанию

Нет

Особые условия использования

Меняется порядок только включенных в диапазон сортировки данных. 

Порядок данных в таблице, которые не были включены в диапазон сортировки, не меняется.

Если установленный диапазон (поля "Начало диапазона" и "Конец диапазона") содержит данные:

Пример использования

Задача:

Существует Excel-документ "Test.xlsx".

Необходимо отсортировать Excel-документ по полю "id".

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Отсортировать таблицу по выбранному полю.
  3. Сохранить документ.

Реализация:

  1. Открываем группу действий "Excel".
  2. Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
  3. Помещаем в рабочее пространство студии действие "Сортировка". 
    Настройка действия: 
    1. Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
    2. Параметр "Начало диапазона". Указываем ячейку, от которой будет установлена сортировка.
    3. Параметр "Конец диапазона". Указываем ячейку, до которой будет установлена сортировка.
    4. Параметр "По возрастанию". Указываем признак.
  4. Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ"). 
  5. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Excel-документ отсортирован по полю "id".

Найти текст / Find text

Находит адрес ячейки по тексту, который написан в этой ячейке.

Настройки

Свойство

Англ. наименование

Описание

Тип

Пример заполнения

Обязательность заполнения поля

Параметры
Контекст

Context

Уникальный идентификатор сеанса, к которому будет применено действие.

Robin.Excel

EXCEL_INSTANCEДа
Имя листаSheet name

Наименование страницы, к которой будет применено действие

Robin.String
Лист1Нет
Индекс листаSheet index

Индекс (порядковый номер) страницы, к которой будет применено действие.
Порядковый номер начинается с "1". По умолчанию значение равно "1"

Robin.Numeric

1Нет
Начало диапазонаStart cell

Адрес начальной ячейки, от которой будет выполняться поиск.

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.

По умолчанию применяются границы используемой области.

Robin.String


A1Нет
Конец диапазонаEnd cell

Адрес конечной ячейки, до которой будет выполняться поиск.

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.


По умолчанию применяются границы используемой области.

Robin.String

B3Нет
Пропустить скрытые ячейкиSkip hiddenСкрытые ячейки не будут участвовать в поиске.
По умолчанию false		Robin.BooleantrueНет
ТекстTextТекст, поиск которого будет осуществляться.

Robin.String

10Да
Поиск с помощьюSearch by

Метод поиска.

Выпадающий список:

  • xsFull
  • xsContains
  • xsStart
  • xsEnd

По умолчанию xsFull

Robin.StringxsFullНет
Результаты
РезультатResult

Словарь найденных ячеек.

Ключ- ячейка.

Robin.DictionaryСловарь

Особые условия использования

Если поле диапазон поиска не задан, то поиск осуществляется по всей используемой области на листе.

Пример использования

Задача:

Существует Excel-документ "Test.xlsx".

Необходимо найти на странице все ячейки, содержащие значение "10". 

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Найти адреса ячеек по заданному тексту.

Реализация:

  1. Открываем группу действий "Excel".
  2. Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
  3. Помещаем в рабочее пространство студии действие "Поиск ячейки". 
    Настройка действия: 
    1. Параметр "Контекст". Выбрать из выпадающего списка контекст соответствующий файлу "Test.xlsx".
    2. Параметр "Текст". Указываем текст, который должен храниться в искомой ячейке.
    3. Параметр "Результат". Указываем переменную, в которую должен быть записан адрес ячейки.
  4. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Переменная "Массив_найденных_строк" содержит данные по ячейкам, в которых хранится искомый текст.