Открыть / Open

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

Настройки

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

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

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

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

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

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

Если:

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

Robin.Boolean

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

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

Robin.ExcelEXCEL_INSTANCE

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

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

Открытие .txt файлов в кодировке UTF-8 возможно через уже открытый Excel: Данные -> Получить данные из текста. В появившемся окне необходимо выбрать формат файла (File Origin) 65001. Через действие "Открыть" это сделать не получится.

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

Задача:

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

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

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

Настройки

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

Context

Уникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Имя макроса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

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

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

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

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

  • xlsx
  • xlsm  
  • xlsb        
  • xls       
  • xml         
  • mht        
  • mhtml       
  • htm        
  • html      
  • xltm         
  • xlt        
  • xltx          
  • xlw         
  • txt          
  • txt (Unicode text)         
  • csv          
  • prn         
  • txt (Macintosh)       
  • txt (MS-DOS)           
  • csv (Macintosh)       
  • csv (MS-DOS)        
  • dif        
  • slk    
  • xlam          
  • xla        
  • xlsx (Open XML strict workbook)         
  • ods          
  • dbf         
  • wj2
  • wj3
  • wk1         
  • wk3        
  • wk4        
  • wks          
  • wq1         
  • pdf
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Нет

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

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

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

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

Настройки

Свойство

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

Описание

Тип

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

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

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

Context

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

Robin.Excel

EXCEL_INSTANCEДа
Начало диапазонаStart cell

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

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

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

Robin.String


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

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

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

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

Robin.String

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

Robin.String

10Да
Метод поиска
Search method

Принцип соответствия введенного текста значениям ячеек.

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

  • Полное - xsFull
  • Содержит - xsContains
  • Начинается - xsStart
  • Заканчивается - xsEnd

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

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

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

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

Robin.DictionaryСловарь

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

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