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

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

Описание

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

Иконка

Настройки 

Свойство

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

Описание

Тип

Пример заполненияОбязательность заполнения поля
Параметры

Контекст

Context

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

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

GoogleTablesInstanceДа

ID документа

Document ID

Идентификатор документа, к которому необходимо применить действие.Строка12Q3VXVkv-6Y2IMHДа

Лист

Sheet

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

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

СтрокаЛист1Нет

Ячейка От

From сell

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

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

СтрокаА1Да

Ячейка До

To cell

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

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

СтрокаС9Да
С заголовком
Heading
Если значение «true», первая строка таблицы будет выделена отдельно как заголовок и не будет входить в строки с содержимым таблицы.ЛогическийtrueНет
Убрать дубли заголовка
Remove duplicate header
Если значение «true», в заголовке полученной таблицы к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1.ЛогическийtrueНет
Результаты

Таблица

Table

Переменная с типом "Таблица", которая будет содержать значения из указанного диапазона.ТаблицаОбластьЗначенийНет

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

Для чек-бокса "С заголовком": 

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

Пример:

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

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


Для чек-бокса "Убрать дубли заголовка": 



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

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

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

Реализация:

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



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


    В поле "Контекст" указать контект подключения к Google Sheets.
    В поле "ID документа" указать часть ссылки таблицы.


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


Результат:

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