Eng_Вставить таблицу

Вставить таблицу Версия 13 (Net)

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

Описание

Действие записывает данные из переменной типа Таблица в заданную область активной страницы Excel книги.

Иконка

Параметры

Входные параметры

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

Имя столбца начальной ячейки Имя столбца начальной ячейки, в которую будет помещена верхняя левая ячейка таблицы.

Индекс столбца начальной ячейки Индекс столбца начальной ячейки, в которую будет помещена верхняя левая ячейка таблицы.

Строка начальной ячейки Строка ячейки, в которую будет помещена верхняя левая ячейка таблицы.

Таблица Переменная типа DataTable с данными.

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

Настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Контекст действия для работы с Excel-документом	Robin.Excel	Контекст excel	Да
Имя столбца начальной ячейки	Имя столбца начальной ячейки, в которую будет помещена верхняя левая ячейка таблицы. Если поле не заполнено, то берется значение из поля «Индекс столбца начальной ячейки».	Robin.String		Нет
Индекс столбца начальной ячейки	Индекс столбца начальной ячейки, в которую будет помещена верхняя левая ячейка таблицы. Если поле не заполнено, то берется граница используемой области.	Robin.Numeric		Нет
Строка начальной ячейки	Строка ячейки, в которую будет помещена верхняя левая ячейка таблицы.	Robin.Numeric		Нет
Таблица	Переменная типа DataTable с данными	Robin.DataTable		Да
С заголовком	Если значение «true», заголовок таблицы будет вставлен в документ вместе с ее строками.	Robin.Boolean	true	Нет

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

Для параметра "With heading":

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

Целевая таблица	Таблица после вставки без проставленного чек-бокса "С заголовком"	Таблица после вставки с проставленным чек-боксом "С заголовком"

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

Задача

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

Решение

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

Реализация

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