Установить фильтры Версия 4 (Net)
Группа действий: Сервисы Google
Описание
Данное действие предназначено для установки фильтров на указанный диапазон.
Иконка
Параметры действия
Входные параметры
Контекст Идентификатор сеанса, к которому будет применено действие
ID документа Идентификатор документа, к которому необходимо применить действие
Лист Наименование рабочего листа
Ячейка От Адрес начальной ячейки, от которой будет устанавливаться фильтр
Ячейка До Адрес конечной ячейки, до которой будет устанавливаться фильтр
Столбец Наименование столбца, к которому будет применен критерий фильтрации
Критерий Критерий фильтрации
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|
Параметры | ||||
Контекст | Идентификатор сеанса, к которому будет применено действие. | GoogleTablesInstance | Да | |
ID документа | Идентификатор документа, к которому необходимо применить действие. | Строка | 12Q3VXVkv-6Y2IMH | Да |
Лист | Наименование рабочего листа. По умолчанию первый лист документа. | Строка | Лист1 | Нет |
Ячейка От | Адрес начальной ячейки, от которой будет устанавливаться фильтр. Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки. По умолчанию "А1" | Строка | А1 | Нет |
Ячейка До | Адрес конечной ячейки, до которой будет устанавливаться фильтр. Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки. По умолчанию до конца рабочей области. | Строка | С9 | Нет |
Столбец | Наименование столбца, к которому будет применен критерий фильтрации. По умолчанию "А" | Строка | А | Нет |
Критерий | Критерий фильтрации. Заполняется в формате "={значение}", "<{значение}", ">{значение}", ">={значение}", "<={значение}"или "!={значение}". Если значение поля не заполнено, то фильтрация будет установлена по значению "(Пусто)". | Строка | =Климов Руслан Иванович | Нет |
Особые условия использования
В Google Sheets API есть лимит до 60 read-запросов на пользователя в минуту. Для того, чтобы действие сразу не выдавало ошибку при достижении лимита количества запросов, в действие включена операция цикла, которая в течение минуты будет повторно отправлять запросы.
- Если за это время запрос выполниться, то действие завершится успешно.
- Если за это время запрос не удастся отправить, то робот завершится с ошибкой.
Пример использования
Задача
Существует Google таблица:
Необходимо установить фильтр на значения в столбце В с условием <200.
Решение
Воспользоваться действиями "Context Google tables", "Applying filter".
Реализация
- Собрать следующую схему робота, состоящую из следующих действий:
- Настроить параметры для действия "Настройки подключения":
Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive) - Настроить параметры для действия "Установить фильтры":
В поле "ID документа" указать часть ссылки таблицы. - Запустить робота, нажав на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно.
Фильтрация данных успешно применена.