对 Excel 工作表中的 ListObject 数据进行排序 – Aspose.Cells Cloud API

前置条件
要调用此 API，您必须拥有有效的 Aspose Cloud JWT 访问令牌，并且工作簿必须已上传至 Aspose Cloud 存储空间。请在每个请求中包含请求头 Authorization: Bearer <jwt token>。

此 REST API 用于对 Excel 工作表中表格的数据进行排序。
要使用该操作，请提供工作簿名称、工作表名称以及目标 ListObject 的索引，并附带一个定义排序条件的 dataSorter JSON 请求体。

PostWorksheetListObjectSortTable API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/sort

安全与身份验证

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

请求参数

参数名称	类型	路径/查询字符串/HTTP 请求体	描述
name	string	path	存储在 Aspose Cloud 存储空间中的 Excel 文件名称。
sheetName	string	path	包含 ListObject 的工作表名称。
listObjectIndex	integer	path	工作表内 ListObject（表格）的从零开始的索引。
dataSorter	object	body	指定排序选项的 JSON 对象（例如：`CaseSensitive`、`HasHeaders`、`KeyList`、`SortLeftToRight`）。
folder	string	query	存储空间中 Excel 文件所在的文件夹路径。
storageName	string	query	Aspose Cloud 存储空间的名称。

注意事项
请求体必须是符合 dataSorter 模式的有效 JSON 对象。在调用排序操作前，请确保工作簿、工作表和 ListObject 均已存在。

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

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

请求

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/sheet7/listobjects/1/sort" \
  -X POST \
  -d '{
        "CaseSensitive": true,
        "HasHeaders": true,
        "KeyList": [
          {
            "Key": 1,
            "SortOrder": "Ascending",
            "CustomList": "string"
          }
        ],
        "SortLeftToRight": true
      }' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

响应

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

HTTP 状态码

状态码	描述
200	OK（成功）——排序已完成。
400	Bad Request（错误请求）——参数无效。
401	Unauthorized（未授权）——身份验证失败。
404	Not Found（未找到）——工作簿、工作表或 ListObject 不存在。
500	Internal Server Error（内部服务器错误）——服务端问题。

响应参数

参数名	类型	描述
Code	integer	API 返回的 HTTP 状态码。
Status	string	结果的文本描述（例如：“OK”）。

云 SDK 开发工具包

使用 SDK 是加速开发的最佳方式。SDK 处理底层细节，使您可以专注于项目任务。请查看 GitHub 仓库，获取 Aspose.Cells Cloud SDK 的完整列表。

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

返回 ListObjects 概述

将列表对象转换为区域——Aspose.Cells Cloud API