Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

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

...

Версия 1 (Python)

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

...

Описание

Действие вставляет таблицу в документ. 

Иконка

...

Параметры

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

...

действия

...

Image Added

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

...

Настройки

СвойствоОписаниеТип
данныхзаполнения
Пример заполнения
Обязательность 
Обязательность заполнения поля
Поле "
Параметры
Контекст
"
Контекст действия для работы с таблицей ods/xlsxRobin
OpenSheetDoc 
.OpenSheetD oc
Да
Поле "
Таблица
Таблица, которая будет вставлена

Таблица

Robin.DataTable
Да
Поле "
Имя столбца начальной ячейки
"
Имя столбца начальной ячейки в документе, куда будет вставлена верхняя левая ячейка указанной таблицы.
Если поле не заполнено, то берется значение из поля "Индекс столбца начальной ячейки"

Строка

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

Число

 
Robin.Numeric
Нет
Поле "
Строка начальной ячейки
"
Строка ячейки в документе, куда будет вставлена левая верхняя ячейка указанной таблицы

Число

 
Robin.Numeric
Нет
Чекбокс
"
С заголовком
"
Если значение
«true»
"true", заголовок таблицы будет вставлен в документ вместе с ее строками
Логический
Robin.Boolean
 
trueНет

Особые условия

...

использования

Действие вставляет таблицу в табличный документ.

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

Пример

...

использования

Задача 

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

Image Added

Решение

Воспользоваться

...

Предусловие для всех кейсов: На рабочую область установлено и корректно настроено действие "Открыть" группы Офис, подгруппы Табличные документы.

Задача: 

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

Реализация:

Указана некорректная строка

...

, "Вставить таблицу"

...

Результат: Действие выдало ошибку. Описание ошибки: "Указана некорректная строка.".

Указан некорректный столбец

  1. Установить на рабочую область действие "Вставить таблицу".
  2. Корректно заполнить параметры. "Имя столбца начальной ячейки" - указать некорректное значение (несуществующее имя).
  3. Запустить робота.

Результат: Действие выдало ошибку. Описание ошибки: "Указан некорректный столбец.".

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

Указано только имя столбца 

  1. Установить на рабочую область действие "Вставить таблицу".
  2. Корректно заполнить параметры. "Имя столбца начальной ячейки" - указать имя столбца. "Индекс столбца начальной ячейки" - не заполнять.
  3. Запустить робота.

Результат: Действие вставило таблицу в столбец, указанный в "Имя столбца начальной ячейки".

Указан только индекс столбца 

  1. Установить на рабочую область действие "Вставить таблицу".
  2. Корректно заполнить параметры. "Имя столбца начальной ячейки" - не заполнять. "Индекс столбца начальной ячейки" - указать индекс столбца.
  3. Запустить робота.

Результат: Действие вставило таблицу в столбец, указанный в "Индекс столбца начальной ячейки".

Указано имя и индекс столбца

  1. Установить на рабочую область действие "Вставить таблицу".
  2. Корректно заполнить параметры. "Имя столбца начальной ячейки" - указать имя столбца. "Индекс столбца начальной ячейки" - указать индекс столбца.
  3. Запустить робота.

Результат: Действие вставило таблицу в столбец, указанный в "Имя столбца начальной ячейки".

Не указан столбец

  1. Установить на рабочую область действие "Вставить таблицу".
  2. Корректно заполнить параметры. "Имя столбца начальной ячейки", "Индекс столбца начальной ячейки" - не заполнять, "Строка начальной ячейки" - заполнить.
  3. Запустить робота.

Результат: Действие вставило таблицу в первый столбец используемой области и в указанную строку.

Не указана строка

  1. Установить на рабочую область действие "Вставить таблицу".
  2. Корректно заполнить параметры. "Строка начальной ячейки" - не заполнять. "Имя столбца начальной ячейки" - заполнить.
  3. Запустить робота.

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

Не указан столбец и строка

  1. Установить на рабочую область действие "Вставить таблицу".
  2. Корректно заполнить параметры. "Строка начальной ячейки", "Имя столбца начальной ячейки", "Индекс столбца начальной ячейки" - не заполнять.
  3. Запустить робота.

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

Указана вставка с заголовком

, "Сохранить".

Реализация

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

Результат

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

Image Added

В документ "Test 2" вставлена таблица начиная с ячейки А3.

Image Added

Дополнительно

 Результат вставки текста в файл при указанном чекбоксе "С заголовком" у действия "Вставить таблицу".

Image Added

  1. Установить на рабочую область действие "Вставить таблицу".
  2. Корректно заполнить параметры. "С заголовком" - true.
  3. Запустить робота.

Результат: Действие вставило таблицу в документ. В таблицу вставлен и заголовок и его строки.