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

Взять таблицу Версия 3 (Python)

Группа действий: P7-Офис

Описание

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

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

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

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Контекст документа табличного типа, открытого в Р7-Офис	P7-Офис таблицы		Да
Имя столбца начальной ячейки	Имя столбца начальной ячейки диапазона. Если поле не заполнено, начальный столбец будет определен по значению из поля "Индекс столбца начальной ячейки".	Строка	A	Нет
Индекс столбца начальной ячейки	Порядковый номер столбца начальной ячейки диапазона. Нумерация начинается с 1.	Число	1	Нет
Индекс строки начальной ячейки	Порядковый номер строки начальной ячейки диапазона. Нумерация начинается с 1.	Число	1	Нет
Имя столбца конечной ячейки	Имя столбца конечной ячейки диапазона. Если поле не заполнено, конечный столбец будет определен по значению из поля "Индекс столбца конечной ячейки".	Строка	B	Нет
Индекс столбца конечной ячейки	Порядковый номер столбца конечной ячейки диапазона. Нумерация начинается с 1.	Число	1	Нет
Индекс строки конечной ячейки	Порядковый номер строки конечной ячейки диапазона. Нумерация начинается с 1.	Число	1	Нет
С заголовком	Если значение "true", первая строка таблицы будет выделена отдельно как заголовок и не будет входить в строки с содержимым таблицы.	Логический	true	Нет
Убрать дубли заголовка	Если значение "true", в заголовке полученной таблицы к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1.	Логический	true	Нет
Результаты
Результат	Таблица, извлеченная из указанного диапазона ячеек.	Таблица		Нет

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

Если не заполнены все входные параметры со строками и столбцами, то границами диапазона считаются границы заполненной области в табличном документе.
Допустимые значения для имени столбца ячейки: латинские буквы в любом регистре.
Допустимые значения для индекса столбца/строки: натуральные числа.
Если поле "Имя столбца начальной ячейки" заполнено, то значение поля "Индекс столбца начальной ячейки" игнорируется.
Если поле "Имя столбца конечной ячейки" заполнено, то значение поля "Индекс столбца конечной ячейки" игнорируется.
Если параметр "С заголовком" = "false" , то первую строку действие оставит в части с содержимым таблицы, а в заголовке будут использоваться названия по умолчанию - 1, 2, 3 и т.д.
Если параметр "С заголовком" = "false", то параметр "Убрать дубли заголовка" игнорируется.

Для корректного запуска действий из под ОС Windows необходимо добавить Плагин P7.

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

Задача

Необходимо скопировать таблицу из документа "Test1" и вставить в другую область документа, начиная с ячейки C6.

Решение

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

Реализация

Собрать схему робота, состоящую из действий:
Настроить параметры для действия "Открыть".
1. Поле "Путь к файлу". Указать путь к табличному документу, который необходимо открыть.
Настроить параметры для действия "Взять таблицу".
1. Поле "Контекст". Указать контекст открытого табличного документа.
2. Поле "Имя столбца начальной ячейки". Указать имя столбца начальной ячейки диапазона, начиная с которого будет взята таблица.
3. Поле "Индекс строки начальной ячейки". Указать номер начальной строки, начиная с которой будет взята таблица.
4. Поле "Имя столбца конечной ячейки". Указать имя столбца конечной ячейки, до которой будет взята таблица.
5. Поле "Индекс строки конечной ячейки". Указать номер конечной строки, до которой будет взята таблица.
Настроить параметры для действия "Вставить таблицу".
1. Поле "Контекст". Указать контекст открытого табличного документа.
2. Поле "Таблица". Указать таблицу, полученную действием "Взять таблицу".
3. Поле "Имя столбца". Указать "С".
4. Поле "Индекс строки". Указать "6".
Настроить параметры для действия "Сохранить".
1. Поле "Контекст". Указать контекст открытого табличного документа.
Запустить робота по кнопке "Старт" в верхней панели.