Вставить таблицу Версия 6 (Net)

Группа действий: Сервисы Google 


Описание

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

Иконка


Параметры действия

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

Контекст                                               Идентификатор сеанса, к которому будет применено действие

ID документа                                        Идентификатор документа, к которому необходимо применить действие

Лист                                                      Наименование рабочего листа

Ячейка От                                            Адрес начальной ячейки, от которой будут устанавливаться значения

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

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

Настройки

Свойство

Описание

Тип

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

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

Параметры

Контекст

Идентификатор сеанса, к которому будет применено действие.

Robin.SpreadShee ts

Контекст SpreadSheets

Да

ID документа

Идентификатор документа, к которому необходимо применить действие.

Robin.String


Да

Лист

Наименование рабочего листа. По умолчанию первый лист документа.

Robin.String


Нет

Ячейка От

Адрес начальной ячейки, от которой будут устанавливаться значения. Заполнять в формате «ХY», где «Х» - это имя столбца, а «Y» - номер строки.

Robin.String


Да

Данные

Таблица данных для установки.

Robin.DataTable


Да

С заголовком

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

Robin.Boolean

true

Нет

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

В Google Sheets API есть лимит до 60 read-запросов на пользователя в минуту. Для того, чтобы действие сразу не выдавало ошибку при достижении лимита количества запросов, в действие включена операция цикла, которая в течение минуты будет повторно отправлять запросы.

  • Если за это время запрос выполниться, то действие завершится успешно.
  • Если за это время запрос не удастся отправить, то робот завершится с ошибкой.

Для параметра "С заголовком":

  • При значении "true", действие запишет в документ строку заголовка исходной таблицы в качестве первой строки вместе с остальными основными строками таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 3 строки.
  • При "false", действие запишет в документ только основные строки с содержимым исходной таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 2 строки.
Целевая таблицаТаблица после вставки без проставленного чек-бокса "С заголовком"Таблица после вставки с проставленным чек-боксом "С заголовком"

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

Задача

Существует Google таблица с значениями:

Необходимо взять область значений с ячейки "B1" до "С4". И далее вставить полученную таблицу (область) начиная с ячейки "А7". 

Решение

Воспользоваться действиями "Context Google tables", "Get area form table", "Insert table". 

Реализация

  1. Собрать следующую схему робота, состоящую из действий:


  2. Настроить параметры для действия "Настройки подключения":

    Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive)

  3. Настроить параметры для действия "Взять область значений":

    В поле "ID документа" указать часть ссылки таблицы.


  4. Настроить параметры для действия "Вставить таблицу":

    В поле "ID документа" указать часть ссылки таблицы.


  5. Нажать на кнопку "Старт" в верхней панели. 

Результат

Программный робот отработал успешно.

Требуемая область значений получена и вставлена на заданный лист начиная с ячейки "А7". 

  • Нет меток