Оглавление

Открыть / Open

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

Настройки

...

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

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

...

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

Чек-бокс.

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

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

...

Robin.Boolean

...

Уникальный идентификатор сеанса.

Однозначно определяет к какому из открытых документов алгоритму следует обращаться.

...

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

После завершения выполнения всех действий Система автоматически закрывает открытый Excel-документ. 

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

Задача:

Существует 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-файл.

Настройки

...

Имя документа, который будет создан.

...

Robin.String

...

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

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

...

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

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

...

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

Чек-бокс.

По умолчанию 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".

По умолчанию "1"

...

Robin.String

...

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

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

...

Robin.String

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

Считает количество ячеек со значением "Да" в полях с "I3" до "I" c номером в переменной "Rows"

...

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

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

...

Robin.String

...

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

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

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". 

По умолчанию значение равно "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

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

...

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

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

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

Задача:

Существует 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-документу.

Настройки

...

...

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

Если чек-бокс:

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

...

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

...

Column

...

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

...

От

...

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

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

...

До

...

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

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

...

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

• От A до Z
• От Z до 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"

...

Строка

...

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

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

Строка

...

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

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

...

Строка

...

Строка

...

• xsFull
• xsContains
• xsStart
• xsEnd

...

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

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

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

Задача:

Существует 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