История страницы

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

...

Версия 14 (Net)

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

...

Описание

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

Иконка действия

Image Removed

...

Image Added

Параметры и их настройки

Свойство

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

	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст

Context

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

Идентификатор контекста

Robin.Excel

EXCEL_INSTANCE

Контекст excel

Да

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

Start cell column


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

Столбец

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

Robin.

Строка

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

Start Cell Row

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

Robin.

Число

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

Столбец Столбец

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

Destination cell column

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

Robin.

Строка

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

Destination cell string

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

Robin.

Число

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

Skip hidden

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

Robin.

Логический

Boolean	true	Нет
С заголовком

Heading

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

Robin.

Логический

Boolean	true	Нет
Убрать дубли заголовка

Remove duplicate header

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

.

	Robin.Boolean	true	Нет
Результаты
Результат

Result

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

значения выбранного диапазона.ТаблицаДанные_с_фильтром

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

данные диапазона

Robin.DataTable

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

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

Работа параметра: При значении "true" действие первую строку исходной таблицы сохранит в заголовок возвращаемого табличного значения, т.е. она не будет являться строкой с содержимым таблицы.
При "false" первую строку оставит в части с содержимым таблицы, а в заголовке будут использоваться названия по умолчанию - 1, 2, 3 и т.д.

Пример:
Из excel забираем таблицу.
Image Added

При включенном параметре в логе будет указано "Столбцов: 3; строк: 2", т.к. Первая строка взятой области стала заголовком с названиями столбцов "№", "Название" и "Тесты". К этим заголовкам нельзя обратиться как к строке данных, чтобы прочитать, но можно использовать имена столбцов, чтобы обратиться к конкретной ячейке или столбцу (действиями из группы "Таблицы"). Если параметр выключен, то в логе будет указано "Столбцов: 3; строк: 3", названия столбцов в заголовке будут "1", "2" и "3".

Для чекбокса "Убрать дубли заголовка"

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

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

Пример №2:
В excel есть таблица.
Image 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" и .
Image Added
И вставить ее в документ "Test 1" начиная с ячейки "А3".Image Removed

Решение

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

Реализация

Собрать схему робота, состоящую из действий:

...

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