Сравнение версий

Старая версия 16

changes.mady.by.user пользователь-76339

Сохранено

по сравнению с

Новая версия 17

changes.mady.by.user пользователь-76339

Сохранено

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

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

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

Задача:

...

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

Context

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

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

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

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

Robin.Numeric

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

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

Robin.String

Run_MacrosДа

...

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

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

...

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

...

  • 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
    СвойствоАнгл. наименованиеОписаниеТипПример заполненияОбязательность заполнения поля
    Параметры
    Контекст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".

    Необходимо изменить доступ к файлу "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 до Я / по возрастанию"

    ...

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

    ...

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

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

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

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

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

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

    Задача:

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

    Image Removed

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

    Решение:

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

    Реализация:

    ...

    .

    ...

    Результат:

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

    Image Removed

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

    ...

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

    Настройки

    1

    Свойство

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

    Описание

    Тип

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

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

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

    Context

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

    Robin.Excel

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

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

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

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

    Robin.Numeric

    		Нет
    Начало диапазона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Словарь

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

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

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

    Задача:

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

    Image Removed

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

    Решение:

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

    Реализация:

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

    Результат:

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

    Image Removed