История страницы
Вставить таблицу Версия
...
7 (Net)
Группа действий: Сервисы Google
...
Описание
Действие записывает данные из переменной типа Таблица в заданную область активной страницы google таблицы
Иконка действия
Параметры
...
Входные параметры
Контекст Идентификатор сеанса, к которому будет применено действие
ID документа Идентификатор документа, к которому необходимо применить действие
Лист Наименование рабочего листа
Ячейка От Адрес начальной ячейки, от которой будут устанавливаться значения
Данные Таблица данных для установки
С заголовком Если значение «true», заголовок таблицы будет вставлен в документ вместе с ее строками
...
и их настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Идентификатор сеанса, к которому будет применено действие |
Контекст 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 документа" указать часть ссылки таблицы. - Нажать на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно.
Требуемая область значений получена, сохранена в переменную "Таблица" и вставлена на заданный лист.