История страницы

Get area from table Version 4 (Net)

Action group: Google services

...

Description

This action retrieves values from the cell area.

Action icon

Image Added

Settings of parameters 

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 "With header" checkbox

Parameter is action: If true, the action will save the first row of the source table into the header of the returned table value, i.e. it will not be a row with the table contents.
If “false”, the first row will leave the table content part, and the header will use the default names - 1, 2, 3, etc.

Example

Get the table:
Image Added

With this parameter enabled, the log will show "Columns: 3; rows: 2" because the first row of the taken area has become a header with the column names "No.", "Title", and "Tests". These headings cannot be accessed as a row of data to read, but you can use the column names to access a specific cell or column (actions from the "Tables" group). If the option is off, the log will show "Columns: 3; rows: 3", the column names in the header will be "1", "2" and "3".

For "Remove header duplicates" checkbox

When "true", indexes will be added to identical column names in the header of the tabular value that the actions return as a result. The numbering starts from 1.

Example 1

There is a table:
Image Added
If

Взять область значений

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

Описание

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

Иконка

Image Removed

Настройки 

...

Свойство

...

Англ. наименование

...

Описание

...

Тип

...

Контекст

...

Context

...

Идентификатор сеанса работы с Google таблицами

...

ID документа

...

Document ID

...

Лист

...

Sheet

...

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

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

...

Ячейка От

...

From сell

...

Адрес начальной ячейки, от которой будет браться область.

Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки.

...

Ячейка До

...

To cell

...

Адрес конечной ячейки, до которой будет браться область.

Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки.

...

Heading

...

Remove duplicate header

...

Таблица

...

Table

...

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

Для чек-бокса "With header": 

Работа параметра: При значении "true" действие первую строку исходной таблицы сохранит в заголовок возвращаемого табличного значения, т.е. она не будет являться строкой с содержимым таблицы.
 При "false" первую строку оставит в части с содержимым таблицы, а в заголовке будут использоваться названия по умолчанию - 1, 2, 3 и т.д.

Пример:

Забираем таблицу:
Image Removed

При включенном параметре в логе будет указано "Столбцов: 3; строк: 2", т.к. Первая строка взятой области стала заголовком с названиями столбцов "№", "Title" и "Tests". К этим заголовкам нельзя обратиться как к строке данных, чтобы прочитать, но можно использовать имена столбцов, чтобы обратиться к конкретной ячейке или столбцу (действиями из группы "Таблицы"). Если параметр выключен, то в логе будет указано "Столбцов: 3; строк: 3", названия столбцов в заголовке будут "1", "2" и "3".

Для чек-бокса "Remove header duplicates": 

При значении "true", в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1. 
Пример №1:
Есть таблица:
Image Removed
При "Remove header duplicates" = true, и and "With header" = True, действие the action "Get area form table" вернет таблицу из 10 строк и 4х столбцов. Названия столбцов этой таблицы будут "№will return a table with 10 rows and 4 columns. The names of the columns in the table will be: "No.", "Title", "Tests1", "Tests2".Пример №2:
Есть таблица:

Example 2

Image Modified
При If "Remove header duplicates" = true, и and "With header" = True, действие the action "Get area form table" вернет таблицу из 4х строк и 5 столбцов. Названия столбцов этой таблицы будутwill return a table with 4 rows and 5 columns. The names of the columns in the table will be:
"Test31", "Test21", "Test22", "Test32", "Test1".

При значении If "false", названия столбцов останутся прежними. Действия на net, которые возвращают\обрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов.the column names will remain the same. Actions on net that return/process such tables with duplicated column names will crash with an error, because net cannot have a header with the same column names.

For example, the source table has columns Например, в исходной таблице есть столбцы "Test1", "Test" и and "Test". Если добавлять индексы только к текущим дублям, то названия станут такими If we add indexes only to the current doubles, the names will become "Test1", "Test1" и and "Test2", тi.е. в итоге появятся новые дубли с названием e. new doubles with the name "Test1" . Поэтому действие при переименовании конкретного столбца должно проверять, нет ли уже такого названия у другого столбца и при наличии таких совпадений проставлять у текущего столбца следующий по счету индекс. Т.е. в данном случае действие переименует столбцы как will appear. Therefore, when renaming a particular column, the action should check if another column already has such a name and if there is such a match, the current column should have the next index. That is, in this case the action will rename the columns as "Test1", "Test2" и and "Test3".

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

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

Image Removed

Необходимо взять область значений с ячейки B1 до С4. Результат записать в переменную типа таблица. 

Example of use

Task

There is a Google sheet with values:

Image Added

Take the area of values from cell "B1" to "C4". The result should be written to a variable of the table type.

Solution

Use the Решение: воспользоваться действиями "Context Google tables", "Get area form table" actions.

Реализация:

Implementation

1. Assemble a robot scheme with actionsСобрать следующую схему робота, состоящую из действий:
   Image Modified
2. Set the "Context Google tables" action parameters.Настроить параметры для действия "Настройки подключения":
   Image Modified
   Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Fill in the "The file path" and "Application name" fields (more about filling in these fields in section Instructions for setting up a connection to Google Sheets/Docs/Drive).
3. Set the "Get area from table" action parameters.
   Image Added
   In the ID field specify the part of the table's linkНастроить параметры для действия "Взять область значений":
   Image Removed
   В поле "ID документа" указать часть ссылки таблицы.
   Image Modified
4. Нажать на кнопку Click "Старт" в верхней панели. 

Результат:

1. Start" in the top panel.

Result

The program robot completed successfully. The required range of values was obtained and saved to the variable Программный робот отработал успешно. Требуемая область значений получена и сохранена в переменную "Table". 

Image Modified