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

Ключ

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

...

Applying filters Version 5 (Net)

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

Описание

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

Иконка

Image Removed

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

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

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

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

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

Ячейка От                     Адрес начальной ячейки, от которой будет устанавливаться стиль

Ячейка До                    Адрес конечной ячейки, до которой будет устанавливаться стиль

Столбец                        Наименование столбца, к которому будет применен критерий фильтрации

Критерий                      Критерий фильтрации

Настройки 

Action group: Google services

...

Description

The action applies filters to a specified range.

Action icon

Image Added

Settings of parameters 

PropertyDescriptionTypeFilling exampleMandatory field
Parameters
ContextIndentifier of session for actionRobin.SpreadShee tsSpreadSheets contextYes
Document IDIndentifier of document for actionRobin.String
Yes
SheetName of working sheet.

Свойство

Описание

Тип

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

Контекст

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

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

GoogleTablesInstanceДа

ID документа

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

Лист

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

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

No
Нет

Ячейка От

Адрес начальной ячейки, от которой будет устанавливаться стиль.

Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки.

По умолчанию "А1"

СтрокаА1Нет

Ячейка До

Адрес конечной ячейки, до которой будет устанавливаться стиль.

Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки.

По умолчанию до конца рабочей области.

СтрокаС9НетСтолбец

Наименование столбца, к которому будет применен критерий фильтрации.

По умолчанию "А"

Строка
АНетКритерий

Критерий фильтрации.

Заполняется в формате "={значение}", "<{значение}", ">{значение}", ">={значение}", "<={значение}"или "!={значение}".

Если значение поля не заполнено, то фильтрация будет установлена по значению "(Пусто)".

Строка
=Климов Руслан ИвановичНет

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

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

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

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

Задача

Существует Google таблица:

Image Removed

Необходимо установить фильтр на значения в столбце В с условием <200.

Решение

Воспользоваться действиями "Настройки подключения", "Установить фильтры".

Реализация

...

From сellAddress of starting сell to apply filter in format «XY», where «X» - column name and «Y» - row index.Robin.String
No
To cellAddress of last сell to apply filter in format «XY», where «X» - column name and «Y» - row index.Robin.String
No
ColumnName of column to apply filter. By default «A»Robin.String
No
CriteriaFilter 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:

Image Added

Set a filter on the values in the "B" column with the condition "<200".

Solution

Use the "Context Google tables", "Applying filter" actions.

Implementation

  1. Assemble a robot scheme with the actions:
    Image Added
  2. Set the "Context Google tables" action parameters.
    image2024-1-23_17-32-1.pngImage Added
    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).
  3. Set the "Applying filter" action parameters.
    Image Added
    In the ID field specify the part of the table's link.
    image2024-1-23_17-35-12.pngImage Added
  4. Click "Start" in the top panel to start the robot.

Result

The program robot completed successfully.

Image Added

The filters are applied successfully.

...

Результат

Программный робот отработал успешно. 

Image Removed

Фильтрация данных успешно применена.