Взять область значений Версия 4 (Net)
Группа действий: Сервисы Google
Описание
Данное действие предназначено для получения значений из области ячеек.
Иконка
Параметры действия
Входные параметры
Контекст Идентификатор сеанса, к которому будет применено действие
ID документа Идентификатор документа, к которому необходимо применить действие
Лист Наименование рабочего листа
Ячейка От Адрес начальной ячейки, от которой будет браться область
Ячейка До Адрес конечной ячейки, до которой будет браться область
С заголовком Если значение «true», первая строка таблицы будет выделена отдельно как заголовок и не будет входить в строки с содержимым таблицы
Убрать дубли заголовка Если значение «true», в заголовке полученной таблицы к одинаковым названиям столбцов будут добавлены индексы
Выходные параметры
Таблица Переменная с типом "Таблица", которая будет содержать значения из указанного диапазона
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|
Параметры | ||||
Контекст | Идентификатор сеанса, к которому будет применено действие. | GoogleTablesInstance | Да | |
ID документа | Идентификатор документа, к которому необходимо применить действие. | Строка | 12Q3VXVkv-6Y2IMH | Да |
Лист | Наименование рабочего листа. По умолчанию первый лист документа. | Строка | Лист1 | Нет |
Ячейка От | Адрес начальной ячейки, от которой будет браться область. Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки. | Строка | А1 | Да |
Ячейка До | Адрес конечной ячейки, до которой будет браться область. Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки. | Строка | С9 | Да |
С заголовком | Если значение «true», первая строка таблицы будет выделена отдельно как заголовок и не будет входить в строки с содержимым таблицы. | Логический | true | Нет |
Убрать дубли заголовка | Если значение «true», в заголовке полученной таблицы к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1. | Логический | true | Нет |
Результаты | ||||
Таблица | Переменная с типом "Таблица", которая будет содержать значения из указанного диапазона. | Таблица | ОбластьЗначений | Нет |
Особые условия использования
В Google Sheets API есть лимит до 60 read-запросов на пользователя в минуту. Для того, чтобы действие сразу не выдавало ошибку при достижении лимита количества запросов, в действие включена операция цикла, которая в течение минуты будет повторно отправлять запросы.
- Если за это время запрос выполниться, то действие завершится успешно.
- Если за это время запрос не удастся отправить, то робот завершится с ошибкой.
Для чек-бокса "With header"
Работа параметра: При значении "true" действие первую строку исходной таблицы сохранит в заголовок возвращаемого табличного значения, т.е. она не будет являться строкой с содержимым таблицы.
При "false" первую строку оставит в части с содержимым таблицы, а в заголовке будут использоваться названия по умолчанию - 1, 2, 3 и т.д.
Пример:
Забираем таблицу:
При включенном параметре в логе будет указано "Столбцов: 3; строк: 2", т.к. Первая строка взятой области стала заголовком с названиями столбцов "№", "Title" и "Tests". К этим заголовкам нельзя обратиться как к строке данных, чтобы прочитать, но можно использовать имена столбцов, чтобы обратиться к конкретной ячейке или столбцу (действиями из группы "Таблицы"). Если параметр выключен, то в логе будет указано "Столбцов: 3; строк: 3", названия столбцов в заголовке будут "1", "2" и "3".
Для чек-бокса "Remove header duplicates"
При значении "true", в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1.
Пример №1:
Есть таблица:
При "Remove header duplicates" = true, и "With header" = True, действие "Get area form table" вернет таблицу из 10 строк и 4х столбцов. Названия столбцов этой таблицы будут "№", "Title", "Tests1", "Tests2".
Пример №2:
При "Remove header duplicates" = true, и "With header" = True, действие "Get area form table" вернет таблицу из 4х строк и 5 столбцов. Названия столбцов этой таблицы будут:
"Test31", "Test21", "Test22", "Test32", "Test1".
При значении "false", названия столбцов останутся прежними. Действия на net, которые возвращают\обрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов.
Например, в исходной таблице есть столбцы "Test1", "Test" и "Test". Если добавлять индексы только к текущим дублям, то названия станут такими "Test1", "Test1" и "Test2", т.е. в итоге появятся новые дубли с названием "Test1". Поэтому действие при переименовании конкретного столбца должно проверять, нет ли уже такого названия у другого столбца и при наличии таких совпадений проставлять у текущего столбца следующий по счету индекс. Т.е. в данном случае действие переименует столбцы как "Test1", "Test2" и "Test3".
Пример использования
Задача
Существует Google таблица с значениями:
Необходимо взять область значений с ячейки "B1" до "С4". Результат записать в переменную типа таблица.
Решение
Воспользоваться действиями "Context Google tables", "Get area form table".
Реализация
- Собрать следующую схему робота, состоящую из действий:
- Настроить параметры для действия "Настройки подключения":
Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive) - Настроить параметры для действия "Взять область значений":
В поле "ID документа" указать часть ссылки таблицы. - Нажать на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Требуемая область значений получена и сохранена в переменную "Table".