Добавление фильтра по значку в рабочий лист Excel — документация Aspose.Cells Cloud
REST API
Этот REST API добавляет фильтр по значку в рабочий лист Excel с использованием Aspose.Cells Cloud REST API.
Фон: Фильтр по значку применяет визуальный набор значков к ячейкам на основе их значений, позволяя быстро анализировать тренды данных визуально. Типичные сценарии использования включают подсветку показателей эффективности, индикаторов статуса или категоризацию значений с помощью значков в форме дорожных светофоров непосредственно в рабочих листах Excel.
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/iconFilter
Безопасность и аутентификация
API Aspose.Cells Cloud безопасны и требуют аутентификацию на основе токена JWT.
Параметры запроса:
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | Path | Имя рабочей книги. |
| sheetName | string | Path | Имя рабочего листа. |
| range | string | Query | Диапазон ячеек (например, A1:B1), к которому будет применён фильтр. |
| fieldIndex | integer | Query | Индекс столбца (начиная с нуля), к которому применяется фильтр. |
| iconSetType | string | Query | Набор значков для использования. Допустимые значения: Arrows3, ArrowsGray3, Flags3, Signs3, Symbols3, Symbols32, TrafficLights31, TrafficLights32, Arrows4, ArrowsGray4, Rating4, RedToBlack4, TrafficLights4, Arrows5, ArrowsGray5, Quarters5, Rating5, Stars3, Boxes5, Triangles3, None, CustomSet, Smilies3, ColorSmilies3. |
| iconId | integer | Query | Идентификатор конкретного значка в выбранном наборе значков. |
| matchBlanks | boolean | Query | Определяет, включать ли пустые ячейки (true или false). |
| refresh | boolean | Query | Указывает, следует ли обновить фильтр после применения (true или false). |
| folder | string | Query | Папка, содержащая исходную рабочую книгу. |
| storageName | string | Query | Имя хранилища, в котором находится рабочая книга. |
Ответ
{
"Status":"OK",
"Code":200
}
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр успешно применён; ответ содержит детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизовано) | Недействительный или отсутствующий токен JWT. |
| 413 | Payload Too Large (Слишком большой объём полезной нагрузки) | Загруженный файл превышает лимит размера. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Как использовать API PutWorksheetIconFilter с SDK
Спецификация API PutWorksheetIconFilter
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять взаимодействие с REST напрямую из веб-браузера.
Вы можете использовать инструмент командной строки cURL для лёгкого доступа к веб-сервисам Aspose.Cells. Следующий пример показывает, как выполнить вызов облачного API с помощью cURL.
Использование SDK Aspose.Cells Cloud
Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах вашего проекта. Ознакомьтесь с репозиторием на GitHub для получения полного списка SDK Aspose.Cells Cloud.
Примеры кода ниже демонстрируют, как вызывать веб-сервисы Aspose.Cells с использованием различных SDK:
Дополнительные возможности автофильтра см. в документации по добавлению цветового фильтра, добавлению фильтра по дате и очистке автофильтра.