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