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

Ключ

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

...

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-запросов на пользователя в минуту. Для того, чтобы действие сразу не выдавало ошибку при достижении лимита количества запросов, в действие включена операция цикла, которая в течение минуты будет повторно отправлять запросы.

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

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

Задача

Существует 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Собрать следующую схему робота, состоящую из следующих действий:
  2. Set the "Context Google tables" action parameters.Настроить параметры для действия "Настройки подключения":
    image2024-1-23_17-32-1.png
    Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к 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.Настроить параметры для действия "Установить фильтры":

    В поле "ID документа" указать часть ссылки таблицыIn the ID field specify the part of the table's link.
    image2024-1-23_17-35-12.png
  4. Запустить робота, нажав на кнопку "Старт" в верхней панели. 

Результат

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

Image Removed

  1. Click "Start" in the top panel to start the robot.

Result

The program robot completed successfully.

Image Added

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