История страницы
Insert table Version 6 (Net)
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
Settings of parameters
Property | Description | Type | Filling example | Mandatory field |
Parameters | ||||
Context | Indentifier of session for action |
Вставить таблицу
Группа действий: Сервисы Google
Описание
Действие записывает данные из переменной типа Таблица в заданную область активной страницы google таблицы.
Иконка
Настройки
Свойство
Описание
Тип
Пример заполнения
Обязательность заполнения поля
Параметры
Контекст
Robin.SpreadShee ts |
SpreadSheets context |
Yes |
Document ID |
Indentifier of document for action | Robin.String |
Yes |
Лист
Sheet | Name of working sheer. По умолчанию первый лист документа. | Robin.String |
No |
Ячейка От
From сell | Address of starting сell to set values In fomat «XY», where «X» - column name and «Y» - row index | Robin.String |
Yes |
Данные
Data table | Data table to set values | Robin.DataTable |
Yes |
С заголовком
Whith heading | If value is «true», the table header will be inserted into the document along with its rows. | Robin.Boolean | true |
Нет
...
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 table | Table after insertion without checkbox "With header" checked | Table after insertion with checkbox "With header" checked |
---|---|---|
Example of use
Task
There is a Google spreadsheet with values:
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", "Get area form table", "Insert table" actions.
Implementation
- Assemble a robot scheme with the actions:
- 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
...
Для параметра "С заголовком":
- При значении "true", действие запишет в документ строку заголовка исходной таблицы в качестве первой строки вместе с остальными основными строками таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 3 строки.
- При "false", действие запишет в документ только основные строки с содержимым исходной таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 2 строки.
Пример использования
Задача: существует Google таблица с значениями . Необходимо взять область значений с ячейки B1 до С4. И далее вставить полученную таблицу (область) начиная с ячейки А7.
Реализация:
- Собрать следующую схему робота, состоящую из действий: "Настройки подключения", "Взять область значений", "Вставить таблицу".
- Настроить параметры для действия "Настройки подключения":
Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive)
Настроить параметры для действия "Взять область значений":
В поле "Контекст" указать контект подключения к Google Sheets.
В поле "ID документа" указать часть ссылки таблицы.
В поле "Ячейка до" указать наименование ячейки до которой будет взята область данных.
Настроить параметры для действия "Вставить таблицу":
В поле "Контекст" указать контект подключения к Google Sheets.
В поле "ID документа" указать часть ссылки таблицы.
В поле "Лист" указать наименование листа на котором находятся данные.
В поле "Ячейка от" указать адрес начальной ячейки от которой будут устанавливаться значения.
В поле "Данные" указать переменную типа таблица с данными.
5. Нажать на кнопку "Старт" в верхней панели.
Результат:
Программный робот отработал успешно. Требуемая область значений получена и сохранена в переменную "Таблица" и вставлена на заданный лист.
- Set the parameters for the "Get area from table" action:
In the "Document ID" field, specify the reference part of the table. - Set the parameters for the "Insert table" action:
In the "Document ID" field, specify the reference part of the table. - Click "Start" in the top panel to start the robot.
Result
The program robot completed successfully.
The required value area is obtained and inserted into the given sheet starting from cell "A7".