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

Ключ

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

...

Insert table Version 6 (Net)

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

Описание

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

Иконка

Image Removed

Параметры действия

Входные параметры  

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

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

Лист                                                      Наименование рабочего листа

Ячейка От                                            Адрес начальной ячейки, от которой будут устанавливаться значения

Данные                                                Таблица данных для установки

С заголовком                                      Если значение «true», заголовок таблицы будет вставлен в документ вместе с ее строками

Настройки

Action group: Google services

...

Description

The action writes data from a variable of type Table to the specified area of the active google table page.

Action icon

Image Added

Settings of parameters

PropertyDescriptionTypeFilling exampleMandatory field
Parameters
ContextIndentifier of session for actionRobin.SpreadShee tsSpreadSheets contextYes
Document IDIndentifier of document for actionRobin.String
Yes
SheetName of working sheer

Свойство

Описание

Тип

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

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

Параметры

Контекст

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

Robin.SpreadShee ts

Контекст SpreadSheets

Да

ID документа

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

Robin.String

Да

Лист

Наименование рабочего листа
. По умолчанию первый лист документа.Robin.String
Нет

No

Ячейка От

Адрес начальной ячейки, от которой будут устанавливаться значения. Заполнять в формате «ХY», где «Х» - это имя столбца, а «Y» - номер строки.
From сellAddress of starting сell to set values In fomat «XY», where «X» - column name and «Y» - row indexRobin.String
Да

Yes

Данные

Таблица данных для установки.
Data tableData table to set valuesRobin.DataTable
Да

Yes

С заголовком

Если значение «true», заголовок таблицы будет вставлен в документ вместе с ее строками
Whith headingIf value is «true», the table header will be inserted into the document along with its rows.Robin.Booleantrue

Нет

Особые условия использования

...

No

Special conditions of use

The Google Sheets API

...

has a limit of up to 60 read-

...

requests per user per minute. To ensure that the action does not immediately generate an error when the limit on the number of requests is reached, the action includes a loop operation that will resend requests within a minute.

  • If the request is completed in that time, the action will complete successfully.
  • If the request cannot be sent in this time, the robot will terminate with an error.

For the "With heading" parameter:

  • When true, the action will write the header row of the source table as the first row in the document along with the rest of the main rows of the table. Example: the Studio specifies that the table "Columns: 3; rows: 2", when pasted into the document, 3 columns and 3 rows will be filled in.
  • If "false", the action will only write to the document the main rows with the contents of the source table. Example: the Studio specifies that the table "Columns: 3; rows: 2", when inserted into the document, 3 columns and 2 rows will be filled.
Target tableTable after insertion without checkbox "With header" checkedTable after insertion with checkbox "With header" checked

Image Added

Image Added

Image Added

Example of use

Task 

There is a Google spreadsheet with values:

Image Added

It is necessary to take the area of values from cell "B1" to "C4". And then insert the obtained table (area) starting from cell "A7". 

Solution

Use "Context Google tables",

...

  • Если за это время запрос выполниться, то действие завершится успешно.
  • Если за это время запрос не удастся отправить, то робот завершится с ошибкой.

Для параметра "С заголовком":

  • При значении "true", действие запишет в документ строку заголовка исходной таблицы в качестве первой строки вместе с остальными основными строками таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 3 строки.
  • При "false", действие запишет в документ только основные строки с содержимым исходной таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 2 строки.

...

Image Removed

...

Image Removed

...

Image Removed

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

Задача

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

Image Removed

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

Решение

Воспользоваться действиями "Context Google tables",  "Get area form table", "Insert table" actions

Реализация

Implementation

  1. Assemble a robot scheme with the actionsСобрать следующую схему робота, состоящую из действий:


  2. Set the "Context Google tables" action parameters.Настроить параметры для действия "Настройки подключения":

    Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Fill in the "File path" and "Project name" fields (more information about filling in these fields in the Instructions for setting up a connection to Google Sheets/Docs/Drive)

  3. Настроить параметры для действия "Взять область значений"Set the parameters for the "Get area from table" action:


    В поле In the "Document ID документа" указать часть ссылки таблицы" field, specify the reference part of the table.


    Настроить параметры для действия "Вставить таблицу"
  4. Set the parameters for the "Insert table" action:

    В поле In the "Document ID документа" указать часть ссылки таблицы" field, specify the reference part of the table.

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

Результат

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

Image Removed

  1. Start" in the top panel to start the robot.

Result

The program robot completed successfully.

Image Added

The required value area is obtained and inserted into the given sheet starting from cell "A7Требуемая область значений получена и вставлена на заданный лист начиная с ячейки "А7".