Добавление фильтра ТОП 10 в рабочий лист Excel – Aspose.Cells Cloud

Этот REST API фильтрует ТОП 10 элементов в списке.

Необходимые условия
• Получите действительный JWT-токен с помощью аутентификации Aspose.Cells Cloud.
• Загрузите рабочую книгу Excel в ваше облачное хранилище Aspose Cloud (или укажите хранилище/папку, где она расположена).
• Знайте имя рабочего листа и диапазон ячеек, который вы хотите отфильтровать.

API PutWorksheetFilterTop10

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

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

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

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

Имя параметра Тип Расположение Обязательный Значение по умолчанию Описание
name string путь Да — Имя файла Excel.
sheetName string путь Да — Имя рабочего листа, содержащего данные.
range string query Да — Диапазон ячеек, к которому применяется фильтр (например, A1:B10).
fieldIndex integer query Да — Индекс столбца (начиная с нуля), по которому применяется фильтр.
isTop boolean query Да true true — фильтровать верхние элементы; false — нижние элементы.
isPercent boolean query Нет false true — интерпретировать itemCount как процент; false — как абсолютное число.
itemCount integer query Нет 10 Количество элементов, включаемых в фильтр.
matchBlanks boolean query Нет false true — включить пустые ячейки в результаты фильтрации.
refresh boolean query Нет false true — обновить фильтр после его применения.
folder string query Нет — Папка в хранилище, где расположен файл Excel.
storageName string query Нет — Имя облачного хранилища Aspose Cloud.

Ответ

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

Типичные ошибочные ответы

{
    "Code":400,
    "Message":"Bad Request – отсутствуют или некорректны параметры."
}

{
    "Code":401,
    "Message":"Unauthorized – недействительный или отсутствующий JWT-токен."
}

{
    "Code":413,
    "Message":"Payload Too Large – загруженный файл превышает допустимый размер."
}

{
    "Code":500,
    "Message":"Internal Server Error – непредвиденная ошибка сервера."
}

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

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

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

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

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

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

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

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

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

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