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

Ключ

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

Вставить таблицу Версия

...

7 (Net)

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

...

Описание

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

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

Image Removed

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

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

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

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

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

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

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

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

...

Image Added

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

Свойство

Описание

Тип

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

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

Параметры

Контекст

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

Robin.SpreadShee ts

Идентификатор сеанса работы с Google таблицами

Контекст SpreadSheets

Да

ID документа

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

Robin.String


Да

Лист

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

Robin.String


Нет

Ячейка От

Адрес начальной ячейки, от которой будут устанавливаться значения. Заполнять в формате

«ХY»

"ХY", где

«Х»

"Х" - это имя столбца, а

«Y»

"Y" - номер строки

Robin.String


Да

Данные

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

Robin.DataTable


Да

С заголовком

Если значение

«true»

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

Robin.Boolean

true

Нет

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

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

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

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

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

Image Added

Image Removed

Image Added

Image Removed

Image Added

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

Задача

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

Решение

Воспользоваться действиями "Настройки подключения", "Взять область значений", "Вставить таблицу". 

Реализация

  1. Собрать следующую схему робота, состоящую из следующих действий
  2. :
  3. .
    Image Modified
  4. Настроить параметры для действия "Настройки подключения":.
    Image Modified
    Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
  5. Настроить параметры для
  6. действия 
  7. действия "Взять область значений"
  8. :
  9. .
    Image Modified
    В поле "ID документа" указать часть ссылки таблицы.
    Image Modified
  10. Настроить параметры для
  11. действия 
  12. действия "Вставить таблицу"
  13. :
  14. .
    Image Modified
    В поле "ID документа" указать часть ссылки таблицы.
    Image Modified
  15. Нажать на кнопку "Старт" в верхней панели. 

Результат

Программный робот отработал успешно.  
Image Modified
Требуемая область значений получена, сохранена в переменную "Таблица" и вставлена на заданный лист.  
Image Modified