Просмотреть исходный

Вставить таблицу Версия 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".

Решение

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

Реализация

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

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

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

В поле "ID документа" указать часть ссылки таблицы.
Нажать на кнопку "Старт" в верхней панели.

Результат

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

Документация ROBIN > Вставить таблицу. Google Sheets > image2022-9-16_14-19-56.png

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

Документация ROBIN > Вставить таблицу. Google Sheets > image2022-9-16_14-20-32.png