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

Взять область значений Версия 4 (Net)

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

...

Описание

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

Иконка

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

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

Настройки 

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

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

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

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

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

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

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

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

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

Настройки 

Remove duplicate header

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

...

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

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

...

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

Пример:

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

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

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

...

При значении "true", в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1. 

Пример №1:
Есть таблица:

...

Image Added
При "Убрать дубли заголовка" = true, и "С заголовком" = True, действие "Взять таблицу" вернет таблицу из 10 строк и 4х столбцов. Названия столбцов этой таблицы будут "№", "Название робота", "Тесты1", "Тесты2".

Пример №2:
Есть таблица:

...

Image Added
При "Убрать дубли заголовка" = true, и "С заголовком" = True, действие "Взять таблицу" вернет таблицу из 4х строк и 5 столбцов. Названия столбцов этой таблицы будут:
"Тест31", "Тест21", "Тест22", "Тест32", "Тест1".

При значении "false", названия столбцов останутся прежними. Действия на net, которые возвращают\обрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов.

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

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

Задача

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

Image Modified. 

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

Решение

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

Реализация

...

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

...

1. Запустить робота по кнопке "Старт" в верхней панели. 

Результат

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

Image Modified