Оглавление

Открыть / Open

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

Настройки

...

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

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

...

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

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

Если:

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

...

Robin.Boolean

...

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

...

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

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

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

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

Закрыть / Close

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

Настройки

...

...

Сохранение документа перед закрытием.

Чек-бокс.

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

...

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

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

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

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

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

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

Настройки

...

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

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

...

Robin.String

...

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

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

...

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

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

...

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

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

Если:

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

...

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

Если название файла указано в формате: "Test.xlsx", файл сохраняется с именем "name" без расширения.

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

Задача:

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

Исполнить формулу / Apply formula to cell

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

Настройки

...

Свойство

...

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

...

Описание

...

Тип

...

Context

...

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

...

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

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

...

Robin.Numeric

...

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

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

...

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

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

...

Robin.String

...

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

...

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

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

...

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

Формулы нужно использовать на английском языке. Посмотреть наименования функций можно на официальном сайте:

https://support.office.com/en-gb/article/excel-functions-by-category-5f91f4e9-7b42-46d2-9bd1-63f26a86c0eb

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

Задачи:

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

Image Removed

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

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

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

Настройки

...

Context

...

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

...

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

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

...

Robin.Numeric

...

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

...

Robin.String

...

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

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

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

Задачи:

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

Image Removed

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

Сохранить как / Save as

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

Настройки

...

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

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

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

...

...

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

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

...

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

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

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

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

• 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

...

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

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

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

Задача:

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

Image Removed

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

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

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

Настройки

...

...

Limit access

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

Если:

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

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

...

Robin.Boolean

...

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

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

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

Задача:

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

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

Решение:

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

Реализация:

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

Результат:

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

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

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

Настройки

...

Свойство

...

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

...

Описание

...

Тип

...

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

...

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

...

Context

...

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

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

...

Column

...

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

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

...

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

...

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

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

...

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

...

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

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

...

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

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

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

...

...

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

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

• одной колонки (например, от "А1" до "А10"), то сортировка данных происходит только в рамках данной колонки и установленного диапазона строк.
• двух и более колонок (например, от "А1" до "C10"), то сортировка данных происходит по первой заданной колонке (колонка "A"). Порядок данных, включенных в диапазон до поля "До" (включительно), меняется в зависимости от сортировки данных.

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

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

Задача:

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

Image Removed

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed

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

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

Настройки

...

Свойство

...

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

...

Описание

...

Тип

...

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

...

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

...

Context

...

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

...

Robin.Excel

...

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

...

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

...

Robin.Numeric

...

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

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

Robin.String

...

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

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

...

Robin.String

...

Robin.String

...

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

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

• xsFull
• xsContains
• xsStart
• xsEnd

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

...

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

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

...

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

Если поле "Столбец" не заполнен, то поиск осуществляется по всей странице.

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

Задача:

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

Image Removed

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

Решение:

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

Реализация:

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

Результат:

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

Image Removed