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

Ключ

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

Вставить таблицу

...

Версия 7 (Net)

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

...

Описание

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

...


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

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 Added

Image Added

Image Added

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

Задача

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

Реализация:

...

Решение

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

Реализация

  1. Собрать следующую схему робота, состоящую из следующих действий.
    Image Added

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

  9. В поле "Лист" указать наименование листа на котором находятся данные. 
    В поле "Ячейка от" указать наименование ячейки от которой будет взята область данных.
    В поле "Ячейка до" указать наименование ячейки до которой будет взята область данных.
    В поле "Таблица" указать переменную типа таблица, куда будут записано полученное значение. 
  10. Настроить параметры для
  11. действия 
  12. действия "Вставить таблицу"
  13. :
  14. .
    Image Modified

  15. В поле "Контекст" указать контект подключения к Google Sheets.

  16. В поле "ID документа" указать часть ссылки таблицы.
    Image Modified

     В поле "Лист" указать наименование листа на котором находятся данные. 

В поле "Ячейка от" указать адрес начальной ячейки от которой будут устанавливаться значения. 

В поле "Данные" указать переменную типа таблица с данными.

...

  1. Нажать на кнопку "Старт" в верхней панели. 

Результат

...

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

Image Removed

Image RemovedImage Added