История страницы
Applying filters Version 5 (Net)
Action group: Google services
...
Description
The action applies filters to a specified range.
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. |
Установить фильтры
Группа действий: Сервисы Google
Данное действие предназначено для установки фильтров на указанный диапазон.
Настройки
Свойство
Англ. наименование
Описание
Тип
Контекст
Context
ID документа
Document ID
Лист
Sheet
Наименование рабочего листа.
По умолчанию первый лист документа. |
Robin.String |
No |
Ячейка От
From сell
Адрес начальной ячейки, от которой будет устанавливаться стиль.
Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки.
По умолчанию "А1"
Ячейка До
To cell
Адрес конечной ячейки, до которой будет устанавливаться стиль.
Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки.
По умолчанию до конца рабочей области.
Column
Наименование столбца, к которому будет применен критерий фильтрации.
По умолчанию "А"
Критерий фильтрации.
Заполняется в формате "={значение}", "<{значение}", ">{значение}", ">={значение}", "<={значение}"или "!={значение}".
Если значение поля не заполнено, то фильтрация будет установлена по значению "(Пусто)".
Особые условия использования
Отсутствуют
Пример использования
Задача: существует Google таблица
Необходимо установить фильтр на значения в столбце В с условием <200
Решение: воспользоваться действиями "Настройки подключения", "Установить фильтры".
Реализация:
...
From сell | Address of starting сell to apply filter in format «XY», where «X» - column name and «Y» - row index. | Robin.String | No | |
To cell | Address of last сell to apply filter in format «XY», where «X» - column name and «Y» - row index. | Robin.String | No | |
Column | Name of column to apply filter. By default «A» | Robin.String | No | |
Criteria | Filter criteria in the format «={value}», «<{value}», «>{value}», «>={value}», «<={value}» or «!={Value}». If the field value is not filled in, then filtering will be set by the value «(Empty)». | Robin.String | No |
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 Google spreadsheet:
Set a filter on the values in the "B" column with the condition "<200".
Solution
Use the "Context Google tables", "Applying filter" 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 "Applying filter" action parameters.
In the ID field specify the part of the table's link. - Click "Start" in the top panel to start the robot.
Result
The program robot completed successfully.
The filters are applied successfully.
...
Результат:
Программный робот отработал успешно. Фильтрация данных успешно применена.