История страницы
Вставить таблицу
...
Версия 1 (Python)
Группа действий: Офис
...
Описание
Действие вставляет таблицу в документ.
Иконка
...
Параметры
Входные параметры:
...
действия
...
Параметры и их настройки
...
Настройки
Свойство | Описание | Тип |
---|
Пример заполнения |
---|
Обязательность заполнения поля | ||||
---|---|---|---|---|
Параметры |
Контекст |
Контекст действия для работы с таблицей ods/xlsx | Robin |
.OpenSheetD oc | Да |
Таблица |
Таблица, которая будет вставлена |
Таблица
Robin.DataTable | Да |
Имя столбца начальной ячейки |
Имя столбца начальной ячейки в документе, куда будет вставлена верхняя левая ячейка указанной таблицы. |
Если поле не заполнено, то берется значение из поля "Индекс столбца начальной ячейки" |
Robin.String |
Нет |
Индекс столбца начальной ячейки |
Индекс столбца начальной ячейки в документе, куда будет вставлена левая верхняя ячейка указанной таблицы |
. Если поле не заполнено, то берется граница используемой области |
Robin.Numeric |
Нет |
Строка начальной ячейки |
Строка ячейки в документе, куда будет вставлена левая верхняя ячейка указанной таблицы |
Robin.Numeric |
Нет |
Чекбокс
С заголовком |
Если значение |
"true", заголовок таблицы будет вставлен в документ вместе с ее строками |
Robin.Boolean |
true | Нет |
Особые условия
...
использования
Действие вставляет таблицу в табличный документ.
- Чтобы вставить таблицу в определенное место документа, пользователю необходимо указать строку и столбец ячейки, в которую будет вставлена верхняя левая ячейка указанной таблицы.
- Если пользователь не укажет строку и столбец ячейки, то таблица будет вставлена в границе используемой области документа - в верхнюю левую ячейку используемой области документа.
- Для идентификации столбца пользователь может указать имя столбца или индекс.
- Если имя столбца не заполнено, то берется значения из параметра индекса столбца.
- Если имя столбца заполнено, то индекс столбца игнорируется.
- Если указано некорректное имя/индекс столбца, то действие выдаст ошибку. Тип исключения: Robin.Exception.ValidationError. Описание ошибки: "Указан некорректный столбец.".
- Если указана некорректная строка, то действие выдаст ошибку. Тип исключения: Robin.Exception.ValidationError. Описание ошибки: "Указана некорректная строка.".
- Если указана строка, но не указан столбец, то верхняя левая ячейки таблицы будет вставлена в первый столбец используемой области и указанную строку.
- Если указан столбец, но не указана строка, то верхняя левая ячейки таблицы будет вставлена в первую строку используемой области и указанный столбец.
- Пользователь может вставить таблицу с заголовком или без. Если с заголовком, то в документ будет вставлен и заголовок, и строки указанной таблицы. Если без заголовка, то в документ будут вставлены только строки указанной таблицы.
Пример
...
использования
Задача: существует файл Книга1.xlsx, необходимо найти текст "тест" в диапазоне с 1-4 строку в столбце А , сохранить и закрыть документ.
Существует 2 табличных документа "Test 1" и "Test 2". Необходимо взять таблицу из документа "Test 1" и вставить ее в документ "Test 2" начиная с ячейки А3.
Решение
Воспользоваться действиями Решение: воспользоваться действием "Открыть", "Найти текстВзять таблицу", "СохранитьВставить таблицу", "ЗакрытьСохранить".
Реализация:
- Собрать схему робота, состоящую из действий:
- Настроить параметры для действия "Открыть". В поле "Путь к файлу" указать путь до требуемого табличного документа.
- Настроить параметры для действия "Взять таблицу". В поле "Контекст" указать контекст открытого документа, создать переменную типа "Таблица", в которую будут записаны данные. и в поле "Результат" ее указать. Остальные поля оставить пустыми, т.к необходимо забрать таблицу полностью.
- Настроить параметры для действия "Открыть". Перетащить на рабочую область действие "Открыть" и заполнить его параметры
В поле "Путь к файлу" указать путь к файлу Книга1.xlsx
Реализация
- до требуемого табличного документа, в который необходимо будет вставить таблицу.
- Настроить параметры для действия "Вставить таблицу". В поле "Контекст" указать контекст открытого документа, в поле "Имя столбца начальной ячейки" указать - А, в поле "Строка начальной ячейки" - 3. В поле "Таблица" указать ранее созданную переменную "Таблица" с данными.
- Настроить параметры для действия "Сохранить". В параметре "Контекст" указать контекст табличного документа, в который будет вставлена таблица с данными.
- Запустить робота по кнопке "Старт" в верхней панели.
Результат
Робот отработал успешно.
В документ "Test 2" вставлена таблица начиная с ячейки А3.
Дополнительно
Результат вставки текста в файл при указанном чекбоксе "С заголовком" у действия "Вставить таблицу".