История страницы
Read cell Version 4 (Net)
Action group: Google services
...
Description
The action reads the cell data.
Action icon
Settings of parameters
| Property | Description | Type | Filling example | Mandatory field |
| Parameters | ||||
| Context | Indentifier of session for action | Robin.SpreadShee ts | SpreadSheets context | Yes |
| Document ID | Indentifier of document for action | Robin.String | Yes | |
| Sheet | Name of working sheet. By default, the first sheet of the document. | Robin.String | No | |
| Cell | Cell to read from in format «XY», where «X» - column name and «Y» - row index | Robin.String | Yes | |
| Results | ||||
| Result | Value from cell | Robin.String | ||
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.
Example of use
Task
There is a table with values:
Take the data from cell "A3" and output it to the dialog box.
Solution
Use the
Взять значение ячейки
Группа действий: Сервисы Google
Описание
Данное действие предназначено для получения значения из ячейки.
Иконка
Настройки
...
Свойство
...
Англ. наименование
...
Описание
...
Тип
...
Контекст
...
Context
...
...
Лист
...
Sheet
...
Наименование рабочего листа. По умолчанию первый лист документа.
...
ID документа
...
Ячейка
...
Cell
...
Наименование ячейки, к которой необходимо применить действие.
Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки.
...
Результат
...
Result
...
Переменная с типом "Строка", в которую будет записано значение указанной ячейки
...
Особые условия использования
В Google Sheets API есть лимит до 60 read-запросов на пользователя в минуту. Для того, чтобы действие сразу не выдавало ошибку при достижении лимита количества запросов, в действие включена операция цикла, которая в течение минуты будет повторно отправлять запросы.
- Если за это время запрос выполниться, то действие завершится успешно.
- Если за это время запрос не удастся отправить, то робот завершится с ошибкой.
Пример использования
Задача: существует Google таблица с значениями
Необходимо взять данные из ячейки А3 вывести в диалоговое окно.
Решение: воспользоваться действиями "Context Google tables", "Read cell", "Show message" actions.
Реализация:
Implementation
- Assemble a robot scheme with the actionsСобрать следующую схему робота, состоящую из действий:
- Set the "Context Google tables" action parameters.Настроить параметры для действия "Настройки подключения":
Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к 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) - Set the "Read cell" action parameters.Настроить параметры для действия "Взять значение ячейки":
В поле "ID документа" указать часть ссылки таблицыIn the ID field specify the part of the table's link.
Настроить параметры для действия "Сообщение": - Set the "Show message" action parameters.
- Нажать на кнопку Click "Старт" в верхней панелиStart" in the top panel.
Результат:
Программный робот отработал успешно. Данные из ячейки получены.
Result
The program robot completed successfully. The cell data was obtained.
The value from cell "A3" is displayed in the dialog box.В диалоговое окно выведено значение из ячейки А3.
Обзор
Инструменты контента