Добавление пользовательского критерия в рабочий лист Excel – Aspose.Cells Cloud API
Этот REST API фильтрует список с использованием пользовательского критерия.
API PutWorksheetCustomFilter
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/custom
Безопасность и аутентификация
API Aspose.Cells Cloud являются безопасными и требуют аутентификации по токену JWT.
Параметры запроса:
| Имя параметра | Тип | Местоположение | Описание |
|---|---|---|---|
| name | string | path | Имя файла Excel. |
| sheetName | string | path | Имя рабочего листа, содержащего данные, подлежащие фильтрации. |
| range | string | query | Диапазон ячеек, к которому будет применён фильтр (например, A1:B1). |
| fieldIndex | integer | query | Индекс столбца (начиная с нуля), по которому применяется фильтр. |
| operatorType1 | string | query | Первый оператор сравнения (например, LessOrEqual, Equal). |
| criteria1 | string | query | Первое фильтрующее значение или выражение. |
| isAnd | boolean | query | Если true, два критерия объединяются с помощью И; иначе — ИЛИ. |
| operatorType2 | string | query | Второй оператор сравнения (необязательный). |
| criteria2 | string | query | Второе фильтрующее значение или выражение (необязательное). |
| matchBlanks | boolean | query | Если true, пустые ячейки включаются в результаты фильтрации. |
| refresh | boolean | query | Если true, рабочий лист будет обновлён после применения фильтра. |
| folder | string | query | Путь к папке в хранилище, где находится файл. |
| storageName | string | query | Имя сервиса хранилища. |
Ответ
{
"Status":"OK",
"Code":200
}
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр успешно применён; ответ содержит детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизован) | Неверный или отсутствующий JWT-токен. |
| 413 | Payload Too Large (Слишком большой payload) | Загружаемый файл превышает ограничение по размеру. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Как использовать API PutWorksheetCustomFilter с SDK
Спецификация API PutWorksheetCustomFilter
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Следующий пример показывает, как выполнить вызов облачного API с помощью cURL.
Использование SDK Aspose.Cells Cloud
Использование SDK — самый быстрый способ разработки. SDK берёт на себя обработку низкоуровневых деталей, позволяя сосредоточиться на логике вашего проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Приведённые ниже примеры кода демонстрируют, как вызывать веб-сервисы Aspose.Cells с использованием различных SDK:
Другие операции AutoFilter, такие как добавление стандартного фильтра или фильтра по дате, описаны в соответствующих страницах документации в разделе AutoFilter.