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

Ключ

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

...

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

Иконка


Параметры


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

  • Поле "Контекст". Обязательное. Описание: "Контекст действия для работы с таблицей ods/xlsx.". Тип данных - Robin.OpenSheetDoc
  • Поле "Таблица". Обязательное. Описание: "Таблица, которая будет вставлена.". Тип данных - Таблица.
  • Поле "Имя столбца начальной ячейки". Необязательное. Описание: "Имя столбца начальной ячейки в документе, куда будет вставлена верхняя левая ячейка указанной таблицы. Если поле не заполнено, то берется значение из поля "Индекс столбца начальной ячейки".". Тип данных - Строка.
  • Поле "Индекс столбца начальной ячейки". Необязательное. Описание: "Индекс столбца начальной ячейки в документе, куда будет вставлена левая верхняя ячейка указанной таблицы. Если поле не заполнено, то берется граница используемой области.". Тип данных - Число.
  • Поле "Строка начальной ячейки". Необязательное. Описание: "Строка ячейки в документе, куда будет вставлена левая верхняя ячейка указанной таблицы."". Тип данных - Число.
  • Чекбокс "С заголовком". Необязательное. Описание: "Если значение «true», заголовок таблицы будет вставлен в документ вместе с ее строками.". Тип данных - Логический.

Настройки

Свойство

Описание

Тип данных

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

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

Параметры

Контекст

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

Robin.OpenSheetD oc

Да

РезультатыРезультат

Словарь с записями - найденными ячейками: ключ записи = адрес ячейки, значение записи = значение ячейки.

Robin.Dictionary

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

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

"

 Тип данных - Robin OpenSheetDoc

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

Да

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

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

 Тип данных - Таблица

 

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

 Да

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

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

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

"

 Тип данных - Строка

 Необязательное  

Нет

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

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

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

"

 Тип данных - Число

 Необязательное  

Нет

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

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

""

 Тип данных - Число

 

 НеобязательноеНет

 Чекбокс

Чекбокс "С заголовком"

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

"

 Тип данных - Логический

 

 Необязательное

 

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

Отсутствуют 

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

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

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

Реализация:

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

Описание на англ.:

Название действия: "Insert the table". Описание: "The action inserts the table into the document.".

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

  • Поле "Context". Описание: "The context of the action for working with the ods/xlsx table.". 
  • Поле "Table". Обязательное. Описание: "The table to be inserted.". 
  • Поле "Name of the initial cell column". Описание: "The name of the column of the initial cell in the document where the upper-left cell of the specified table will be inserted. If the field is not filled in, then the value is taken from the field "Index of the column of the initial cell"."
  • Поле "Index of the initial cell column". Описание: "The index of the column of the initial cell in the document where the upper-left cell of the specified table will be inserted. If the field is not filled in, then the border of the used area is taken.". 
  • Поле "The row of the initial cell". Описание: "The row of the cell in the document where the upper left cell of the specified table will be inserted."". 
  • Чекбокс "Heading". Описание: "If the value is "true", the table header will be inserted into the document along with its rows.".

Настройки

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

Нет

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

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

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

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

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

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

Реализация:

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







Реализация