Сортировка данных диапазона на листе Excel

REST API позволяет отсортировать данные внутри указанного диапазона на листе Excel.

REST API

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

Параметры запроса

Имя параметра	Тип	Расположение	Обязательный	Описание
name	string	path	Да	Имя рабочей книги.
sheetName	string	path	Да	Имя листа.
cellArea	string	query	Да	Диапазон ячеек, подлежащий сортировке (например, `A5:A10`).
dataSorter	object	body	Да	JSON-объект, определяющий параметры сортировки (см. схему ниже).
folder	string	query	Нет	Папка, содержащая рабочую книгу.
storageName	string	query	Нет	Имя хранилища, в котором находится рабочая книга.

Схема объекта dataSorter — в теле запроса должен содержаться JSON-объект со следующими свойствами:

CaseSensitive (boolean, required) — определяет, учитывается ли регистр при сортировке.
HasHeaders (boolean, required) — указывает, содержит ли диапазон строку заголовков.
KeyList (array, required) — коллекция ключей сортировки. Каждый ключ представляет собой объект со следующими полями:
- Key (integer) — индекс столбца (начиная с 0).
- SortOrder (string) — "ascending" (по возрастанию) или "descending" (по убыванию).
SortLeftToRight (boolean, required) — если true, сортировка выполняется слева направо; в противном случае — сверху вниз.
Дополнительно могут быть указаны параметры CaseOrder, SortLeftToRight и другие в соответствии со спецификацией OpenAPI.

Спецификация OpenAPI предоставляет общедоступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Для доступа к веб-сервисам Aspose.Cells можно использовать утилиту командной строки cURL. В следующем примере показано, как выполнить вызов облачного API с помощью cURL.

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet1/sort?cellArea=A5:A10" \
  -X POST \
  -d '{"CaseSensitive":false,"HasHeaders":false,"KeyList":[{"Key":0,"SortOrder":"descending"}],"SortLeftToRight":false}' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

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

Обработка ошибок — API может возвращать стандартные HTTP-коды ошибок. Типичные ответы включают:

HTTP-статус	Код	Сообщение
400	400	Неверный запрос — отсутствуют или недопустимы параметры.
401	401	Неавторизован — недопустимый или отсутствует JWT-токен.
404	404	Не найдено — рабочая книга или лист не существуют.
500	500	Внутренняя ошибка сервера.

В случае ошибки тело ответа имеет следующий формат: { "Code": <статус>, "Message": "<описание>", "Status": "Error" }.

Семейство облачных SDK

Использование SDK — самый быстрый способ разработки. SDK берёт на себя обработку низкоуровневых деталей, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.

Приведённые ниже примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK: