为 Excel 工作表添加前 10 项筛选器 – Aspose.Cells Cloud

此 REST API 可对列表中的前 10 项进行筛选。

前置条件
• 使用 Aspose.Cells Cloud 认证机制获取有效的 JWT 令牌。
• 将 Excel 工作簿上传至您的 Aspose Cloud 存储空间（或指定其所在的存储空间/文件夹）。
• 明确需要筛选的工作表名称及单元格范围。

PutWorksheetFilterTop10 API

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

安全与认证

Aspose.Cells Cloud API 采用安全机制，需使用 基于 JWT 令牌的认证方式。

请求参数

参数名 类型 位置 是否必需 默认值 描述
name string 路径 是 — Excel 文件的名称。
sheetName string 路径 是 — 包含数据的工作表名称。
range string 查询 是 — 应用筛选的单元格范围（例如 A1:B10）。
fieldIndex integer 查询 是 — 筛选所依据列的从零开始的索引。
isTop boolean 查询 是 true 为 true 表示筛选前 N 项；为 false 表示筛选后 N 项。
isPercent boolean 查询 否 false 为 true 时，将 itemCount 视为百分比；为 false 时为绝对数量。
itemCount integer 查询 否 10 筛选中包含的项目数量。
matchBlanks boolean 查询 否 false 为 true 时，将空单元格包含在筛选结果中。
refresh boolean 查询 否 false 为 true 时，在应用筛选后刷新筛选结果。
folder string 查询 否 — 存储空间中 Excel 文件所在的文件夹。
storageName string 查询 否 — 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（内部服务器错误） 服务器发生意外错误。

如何结合 SDK 使用 PutWorksheetFilterTop10 API

PutWorksheetFilterTop10 API 规范

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

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

使用 Aspose.Cells Cloud SDK

使用 SDK 是最快捷的开发方式。SDK 将处理底层细节，让您专注于业务逻辑。您可访问 GitHub 仓库 查看 Aspose.Cells Cloud SDK 的完整列表。

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

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