Вставить таблицу/Insert the table

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

Описание

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

Иконка


Параметры


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

Настройки

Свойство

Описание

Тип данных

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

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

Поле "Контекст"

Контекст действия для работы с таблицей ods/xlsx

Robin OpenSheetDoc

 

Да

Поле "Таблица"

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

Таблица

 

Да

Поле "Имя столбца начальной ячейки"

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

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

Строка

 

Нет

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

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

Если поле не заполнено, то берется граница используемой области

Число

 

Нет

Поле "Строка начальной ячейки"

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

Число

 

Нет

Чекбокс

"С заголовком"

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

Логический

 

Нет

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

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

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

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

Задача: существует файл Книга1.xlsx, необходимо найти текст "тест" в диапазоне с 1-4 строку в столбце А , сохранить и закрыть документ. 

Решение: воспользоваться действием "Открыть", "Найти текст", "Сохранить", "Закрыть". 

Реализация:

  1. Перетащить на рабочую область действие "Открыть" и заполнить его параметры
    В поле "Путь к файлу" указать путь к файлу Книга1.xlsx