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

Ключ

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

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

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

...

Описание

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

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

Image Modified

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

Свойство

Описание

Тип

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

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

Параметры

Контекст

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

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

Контекст 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 строки.
Целевая таблицаТаблица после вставки без проставленного чекбокса "С заголовком"Таблица после вставки с проставленным чекбоксом "С заголовком"

Image Modified

Image Modified

Image Modified

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

Задача

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

Решение

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

Реализация

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

Результат

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