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

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

Описание

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

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

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

Свойство

Описание

Тип

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

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

Параметры

КонтекстКонтекст документа табличного типа, открытого в Р7-Офис
P7-Офис таблицы
Да
Имя столбца начальной ячейки

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

СтрокаAНет
Индекс столбца начальной ячейкиПорядковый номер столбца начальной ячейки диапазона. Нумерация начинается с 1.
Число1Нет
Индекс строки начальной ячейкиПорядковый номер строки начальной ячейки диапазона. Нумерация начинается с 1. 
Число1Нет
Имя столбца конечной ячейкиИмя столбца конечной ячейки диапазона. Если поле не заполнено, конечный столбец будет определен по значению из поля "Индекс столбца конечной ячейки".
СтрокаBНет
Индекс столбца конечной ячейкиПорядковый номер столбца конечной ячейки диапазона. Нумерация начинается с 1.
Число1Нет
Индекс строки конечной ячейкиПорядковый номер строки конечной ячейки диапазона. Нумерация начинается с 1. 
Число1Нет

С заголовком

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

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

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

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

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

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

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

Задача

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

Решение

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

  2. Заполнить параметры действий

  3. Запустить робота.

Реализация

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

Результат

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


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