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

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


Описание

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

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


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

Свойство

Описание

Тип

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

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

Параметры

Контекст

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

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

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

Задача

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

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

Решение

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

Реализация

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

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

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

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

Результат

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

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

  • Нет меток