Добавление фильтра по дате в лист Excel | Aspose.Cells Cloud API

Этот REST API добавляет фильтр по дате в лист Excel.

Необходимые условия: У вас должен быть действительный JWT-токен, а целевая рабочая книга уже должна существовать в указанном месте хранения. Запрос не требует JSON-тела.

API PutWorksheetDateFilter

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/dateFilter

Безопасность и аутентификация

API Aspose.Cells Cloud защищены и требуют аутентификацию по токену JWT.

Параметры запроса

Имя параметра	Тип	Расположение	Описание
name	string	Path	Имя рабочей книги.
sheetName	string	Path	Имя листа.
range	string	Query	Диапазон Excel, к которому применяется фильтр (например, `A1:B1`).
fieldIndex	integer	Query	Индекс столбца для фильтрации (начиная с нуля).
dateTimeGroupingType	string	Query	Тип группировки даты/времени. Допустимые значения: `Day`, `Hour`, `Minute`, `Month`, `Second`, `Year`. Значения чувствительны к регистру; значение по умолчанию — `Day`.
year	integer	Query	Компонент года фильтруемого значения.
month	integer	Query	Компонент месяца фильтруемого значения.
day	integer	Query	Компонент дня фильтруемого значения.
hour	integer	Query	Компонент часа фильтруемого значения.
minute	integer	Query	Компонент минуты фильтруемого значения.
second	integer	Query	Компонент секунды фильтруемого значения.
matchBlanks	boolean	Query	Включать пустые ячейки (`true` или `false`).
refresh	boolean	Query	Обновлять фильтр после применения (`true` или `false`).
folder	string	Query	Путь к папке исходной рабочей книги.
storageName	string	Query	Имя службы хранения.

Запрос PUT не требует тела запроса; все параметры передаются через строку запроса.

Ответ

{
    "Status":"OK",
    "Code":200
}

Коды HTTP-статуса

Код	Значение	Описание
200	OK	Фильтр успешно применён; в ответе содержатся детали операции.
400	Bad Request	Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла).
401	Unauthorized	Недействительный или отсутствующий JWT-токен.
413	Payload Too Large	Загруженный файл превышает лимит размера.
500	Internal Server Error	Непредвиденная ошибка сервера.

Как использовать API PutWorksheetDateFilter с SDK

Спецификация API PutWorksheetDateFilter

Спецификация OpenAPI определяет общедоступный программный интерфейс и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как выполнить вызов облачного API с помощью cURL.

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/autoFilter/dateFilter?range=A1:B1&fieldIndex=0&dateTimeGroupingType=Year&year=1920&refresh=true" \
-X PUT \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Ответ

{
  "Code": 200,
  "Status": "OK"
}

Использование SDK Aspose.Cells Cloud

Использование SDK — самый быстрый способ разработки. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.

Примеры кода ниже демонстрируют, как вызывать веб-сервисы Aspose.Cells с использованием различных SDK:

Добавление динамической фильтрации в лист Excel с помощью API Aspose.Cells Cloud AutoFitterOptions — Свойства и руководство по использованию | Aspose.Cells Cloud API