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

Ключ

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

Взять таблицу

...

Группа действий: Excel 

...

Действие возвращает значения ячеек из заданной области страницы в виде таблицы.


Image RemovedImage Added

Настройки


Свойство

Описание

Тип

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

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

Параметры

Контекст

Контекст действия для работы с Excel-документом

Robin.Excel

Контекст excel

Да

Имя столбца начальной ячейки

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

Robin.String


Нет

Индекс столбца начальной ячейки

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

Robin.Numeric


Нет

Строка начальной ячейки

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

Robin.Numeric


Нет

Имя столбца конечной ячейки

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

Robin.String


Нет

Индекс столбца конечной ячейки

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

Robin.Numeric


Нет

Строка конечной ячейки

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

Robin.Numeric


Нет

Пропустить скрытые

Логическая переменная. Если значение параметра равно True, то возвращаются только видимые строки и столбцы, иначе - все.

Robin.Boolean

true

Нет

С заголовком

Если значение «true», первая строка таблицы будет выделена отдельно как заголовок и не будет входить в строки с содержимым таблицы.

Robin.Boolean

true

Нет

Убрать дубли заголовка

Если значение «true», в заголовке полученной таблицы к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1.

Robin.Boolean

true

Нет

Результаты

Результат

Переменная, в которую будут записаны данные диапазона

Robin.DataTable



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

Для чек-бокса "С заголовком": 

...

  • При значении "true", в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1. 
    Пример №1:
    В excel есть таблица:

    При "Убрать дубли заголовка" = true, и "С заголовком" = True, действие "Взять таблицу" вернет таблицу из 10 строк и 4х столбцов. Названия столбцов этой таблицы будут "№", "Название робота", "Тесты1", "Тесты2".

    Пример №2:
    В excel есть таблица:
    Image RemovedImage Added
    При "Убрать дубли заголовка" = true, и "С заголовком" = True, действие "Взять таблицу" вернет таблицу из 4х строк и 5 столбцов. Названия столбцов этой таблицы будут:

    "Тест31", "Тест21", "Тест22", "Тест32", "Тест1".
  • При значении "false", названия столбцов останутся прежними. Действия на net, которые возвращают\обрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов.
  • Например, в исходной таблице есть столбцы "Тест1", "Тест" и "Тест". Если добавлять индексы только к текущим дублям, то названия станут такими "Тест1", "Тест1" и "Тест2", т.е. в итоге появятся новые дубли с названием "Тест1". Поэтому действие при переименовании конкретного столбца должно проверять, нет ли уже такого названия у другого столбца и при наличии таких совпадений проставлять у текущего столбца следующий по счету индекс. Т.е. в данном случае действие переименует столбцы как "Тест1", "Тест2" и "Тест3".



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

Задача: существует 2 Excel- документа "Test" и "Test 1". Необходимо взять таблицу из документа "Test" и вставить ее в документ "Test 1" начиная с ячейки А3.

Image RemovedImage Added

Решение: воспользоваться действиями "Открыть", "Взять таблицу", "Вставить таблицу", "Сохранить". 

...

  1. Собрать схему робота, состоящую из действий: "Открыть", "Взять таблицу", "Вставить таблицу", "Сохранить". 
    Image AddedImage Removed
  2. Настроить параметры для действия  "Открыть". В поле "Путь к файлу" указать путь до требуемого Excel-файла. Проставить чекбокс Видимый = true для отображения действий робота на экране. 
    Image RemovedImage Added
  3. Настроить параметры для действия "Взять таблицу". В поле "Контекст" указать контекст открытого документа, создать переменную типа "Таблица", в которую будут записаны данные и в поле "Результат" ее указать.  Остальные поля оставить пустыми, т.к необходимо забрать таблицу полностью. 
    Image AddedImage Removed
  4. Настроить параметры для действия "Открыть". В поле "Путь к файлу" указать путь до требуемого Excel-файла, в который необходимо будет вставить таблицу. Проставить чекбокс Видимый = true для отображения действий робота на экране. 

    Image AddedImage Removed
  5. Настроить параметры для действия "Вставить таблицу". В поле "Контекст" указать контекст открытого документа, в поле "Имя столбца начальной ячейки" указать значение "А", в поле "Строка начальной ячейки" указать значение "3". В поле "Таблица" указать ранее созданную переменную "Таблица" с данными. 
    Image AddedImage Removed
  6. Настроить параметры для действия "Сохранить". В параметре "Контекст" указать контекст Excel-документа, в который будет вставлена таблица с данными. 
    Image AddedImage Removed
  7. Запустить робота по кнопке "Старт" в верхней панели. 


...

Робот отработал успешно. 

Image RemovedImage Added

В документ "Test 1" вставлена таблица начиная с ячейки А3. 

Image AddedImage Removed