使用 Aspose.Cells Cloud 在 Excel 工作表中添加筛选器

先决条件： 调用此 API 前，您必须获取有效的 JWT 令牌，确保目标工作簿已上传至指定存储空间，并拥有访问该文件的必要权限。建议使用 cURL 7.68 或更高版本以运行命令行示例。

此 REST API 可在 Excel 工作表的特定列上添加筛选器。

PutWorksheetFilter API

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

安全与身份验证

Aspose.Cells Cloud API 安全可靠，需要基于 JWT 令牌的身份验证。

请求参数

参数名称	类型	位置	描述
name	string	Path	工作簿名称。
sheetName	string	Path	工作表名称。
range	string	Query	包含筛选器的单元格范围（例如 `A1:B1`）。
fieldIndex	integer	Query	应用筛选器的列的从零开始的索引。
criteria	string	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 调用 PutWorksheetFilter API

PutWorksheetFilter API 规范

OpenAPI 规范定义了一个公开可访问的编程接口，允许您直接通过网页浏览器执行 REST 交互。

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

请求

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

响应

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

使用 Aspose.Cells Cloud SDK

使用 SDK 是开发速度最快的方式。SDK 会处理底层细节，使您能专注于项目本身。请查看 GitHub 仓库获取 Aspose.Cells Cloud SDK 的完整列表。

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

使用 Aspose.Cells Cloud API 在 Excel 工作表中添加动态筛选器为 Excel 工作表添加前 10 项筛选器（Aspose.Cells Cloud）