История страницы

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

...

Версия 1 (Python)

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

...

Описание

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

Параметры

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

Контекст - Контекст действия для работы с таблицей ods/xlsx.
Таблица - Таблица, которая будет вставлена.
Имя столбца начальной ячейки - Имя столбца начальной ячейки в документе, куда будет вставлена верхняя левая ячейка указанной таблицы. Если поле не заполнено, то берется значение из поля «Индекс столбца начальной ячейки».
Индекс столбца начальной ячейки - Индекс столбца начальной ячейки в документе, куда будет вставлена левая верхняя ячейка указанной таблицы. Если поле не заполнено, то берется граница используемой области.
Строка начальной ячейки - Строка ячейки в документе, куда будет вставлена левая верхняя ячейка указанной таблицы.
С заголовком - Если значение «true», заголовок таблицы будет вставлен в документ вместе с ее строками.

Настройки

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

Image Added

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

заполнения

Свойство	Описание	Тип	Пример заполнения

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

Обязательность заполнения поля
Параметры
Контекст	Контекст действия для работы с таблицей ods/xlsx

.

Robin.OpenSheetD oc

		Да
Таблица	Таблица, которая будет вставлена

.

Robin.DataTable

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

«Индекс

"Индекс столбца начальной

ячейки».

ячейки"

Robin.String

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

.

Robin.Numeric

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

.

Robin.Numeric

		Нет
С заголовком	Если значение

«true»

"true", заголовок таблицы будет вставлен в документ вместе с ее строками

.

Robin.Boolean

true

Нет

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

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

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

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

Задача:

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

Image Modified

Решение:

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

Реализация:

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