为 Excel 工作表添加图标筛选器 – Aspose.Cells Cloud 文档

REST API

本 REST API 使用 Aspose.Cells Cloud REST API 为 Excel 工作表添加图标筛选器。

背景说明：图标筛选器根据单元格的值应用视觉图标集，从而实现对数据趋势的快速可视化分析。常见应用场景包括高亮显示绩效指标、状态指示符，或直接在 Excel 工作表中使用红绿灯图标对值进行分类。

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

安全与身份验证

Aspose.Cells Cloud API 是安全的，需要使用 基于 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（内部服务器错误） 意外的服务器错误。

如何使用 SDK 调用 PutWorksheetIconFilter API

PutWorksheetIconFilter API 规范

OpenAPI 规范 定义了一个公开可访问的编程接口，允许您直接从 Web 浏览器发起 REST 交互。

您可以使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何使用 cURL 调用 Cloud API。

使用 Aspose.Cells Cloud SDK

使用 SDK 是加速开发的最佳方式。SDK 负责处理底层细节，让您专注于项目任务。请查阅 GitHub 仓库，了解 Aspose.Cells Cloud SDK 的完整列表。

以下代码示例展示了如何使用 various SDK 调用 Aspose.Cells Web 服务：

有关其他自动筛选功能，请参阅文档中的 添加颜色筛选器、添加日期筛选器 和 清除自动筛选。

使用 Aspose.Cells Cloud API 在 Excel 工作表中添加动态筛选器 AutoFitterOptions – 属性与使用指南 | Aspose.Cells Cloud API