Вставить таблицу / Insert table
Группа действий: Excel
Действие записывает данные из переменной типа Таблица в заданную область активной страницы Excel книги
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры |
Контекст | Контекст действия для работы с Excel-документом | Robin.Excel | Контекст excel | Да |
Имя столбца начальной ячейки | Имя столбца начальной ячейки, в которую будет помещена верхняя левая ячейка таблицы. Если поле не заполнено, то берется значение из поля «Индекс столбца начальной ячейки». | Robin.String |
| Нет |
Индекс столбца начальной ячейки | Индекс столбца начальной ячейки, в которую будет помещена верхняя левая ячейка таблицы. Если поле не заполнено, то берется граница используемой области. | Robin.Numeric |
| Нет |
Строка начальной ячейки | Строка ячейки, в которую будет помещена верхняя левая ячейка таблицы. | Robin.Numeric |
| Нет |
Таблица | Переменная типа DataTable с данными | Robin.DataTable |
| Да |
С заголовком | Если значение «true», заголовок таблицы будет вставлен в документ вместе с ее строками. | Robin.Boolean | true | Нет |
Особые условия использования
Для параметра "С заголовком":
- При значении "true", действие запишет в документ строку заголовка исходной таблицы в качестве первой строки вместе с остальными основными строками таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 3 строки.
- При "false", действие запишет в документ только основные строки с содержим исходной таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 2 строки.
Пример использования
Задача: существует 2 Excel- документа "Test" и "Test 1". Необходимо взять таблицу из документа "Test" и вставить ее в документ "Test 1" начиная с ячейки А3.
Решение: воспользоваться действиями "Открыть", "Взять таблицу", "Вставить таблицу", "Сохранить".
Реализация:
- Собрать схему робота, состоящую из действий:
- Настроить параметры для действия "Открыть". В поле "Путь к файлу" указать путь до требуемого Excel-файла. Проставить чекбокс Видимый = true для отображения действий робота на экране.
- Настроить параметры для действия "Взять таблицу". В поле "Контекст" указать контекст открытого документа, создать переменную типа "Таблица", в которую будут записаны данные. и в поле "Результат" ее указать. Остальные поля оставить пустыми, т.к необходимо забрать таблицу полностью.
- Настроить параметры для действия "Открыть". В поле "Путь к файлу" указать путь до требуемого Excel-файла, в который необходимо будет вставить таблицу. Проставить чекбокс Видимый = true для отображения действий робота на экране.
- Настроить параметры для действия "Вставить таблицу". В поле "Контекст" указать контекст открытого документа, в поле "Имя столбца начальной ячейки" указать - А, в поле "Строка начальной ячейки" - 3. В поле "Таблица" указать ранее созданную переменную "Таблица" с данными.
- Настроить параметры для действия "Сохранить". В параметре "Контекст" указать контекст Excel-документа, в который будет вставлена таблица с данными.
- Запустить робота по кнопке "Старт" в верхней панели.
Результат:
Робот отработал успешно.
В документ "Test 1" вставлена таблица начиная с ячейки А3.
