Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Взять данные из строки Версия 3 (Net)

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

...

Описание

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

Иконка

...

Image Added

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

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

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

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

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

Индекс строки                                     Индекс строки, из которой будут получены данные

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

Результат Коллекция, в которой будут хранится полученные данные

Настройки 

Свойство

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

Описание

Тип

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

Контекст

Context

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

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

 

GoogleTablesInstanceДа

ID документа

Document ID

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

Лист

Sheet

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

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

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

Индекс строки

Row index

Индекс строки, из которой будут получены данные.

Индексация начинается с 1.

Число3Да
Результаты

Результат

Result

Коллекция, в которой будут хранится полученные данные.

Коллекция
Нет

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

...

В Google Sheets API есть лимит до 60 read-запросов на пользователя в минуту. Для того, чтобы действие сразу не выдавало ошибку при достижении лимита количества запросов, в действие включена операция цикла, которая в течение минуты будет повторно отправлять запросы.

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

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

Задача

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

image2024-1-24_16-59-14.pngImage Added

 Image RemovedНеобходимо взять данные из строки "3" и получить значение по индексу "2" из коллекции. Результат вывести в диалоговое окно. 

Решение

Воспользоваться : воспользоваться действиями "Настройки подключенияContext Google tables", "Взять данные из строкиGet row data", "Получить значение по индексуGet value by index", "СообщениеShow message". 

Реализация

...

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

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

  3. Настроить параметры для действия "Взять данные из строки":
    Image Removed
    В поле "Контекст" указать контект подключения к Google Sheets.Image Added
    В поле "ID документа" указать часть ссылки таблицы.
    Image Removed
    В поле "Лист" указать наименование листа на котором находятся данные. 
    В поле "Индекс строки" указать наименование строки, данные из которой нужно сохранить.
    В поле "Результат" указать переменную типа коллекция, куда будут записаны полученные значения. Image Added

  4. Настроить параметры для действия "Получить значение по индексу":
    Image Removed
    В поле "Коллекция" указать коллекцию полученных значений из строки. 
    В поле "Индекс" указать 2. (нумерация начинается с 0). 
    В поле "Значение" указать переменную типа объект, куда будет сохранен результат. Image Added

  5. Настроить параметры для действия "Сообщение":
    Image Removed

В поле "Текст сообщения" указать переменную типа объект с содержащимся значением. 

В поле "Заголовок окна" указать "Результат". 

...

  1. Image Added

  2. Нажать на кнопку "Старт" в верхней панели. 

Результат

Программный робот отработал успешно. Записи из строки получены. 

Image RemovedImage Added

В диалоговое окно выведено значение по индексу "2"

Image RemovedImage Added