Ordenar datos de un rango en una hoja de cálculo de Excel

La API REST ordena los datos dentro de un rango especificado en una hoja de cálculo de Excel.

API REST

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

Parámetros de la solicitud

Nombre del parámetro	Tipo	Ubicación	Obligatorio	Descripción
name	string	path	Sí	Nombre del libro de trabajo.
sheetName	string	path	Sí	Nombre de la hoja de cálculo.
cellArea	string	query	Sí	Rango de celdas que se va a ordenar (por ejemplo, `A5:A10`).
dataSorter	object	body	Sí	Objeto JSON que define la configuración de ordenación (véase el esquema a continuación).
folder	string	query	No	Carpeta que contiene el libro de trabajo.
storageName	string	query	No	Nombre del almacenamiento donde se encuentra el libro de trabajo.

Esquema del objeto dataSorter – El cuerpo debe contener un objeto JSON con las siguientes propiedades:

CaseSensitive (booleano, obligatorio) – Determina si la ordenación distingue entre mayúsculas y minúsculas.
HasHeaders (booleano, obligatorio) – Indica si el rango incluye una fila de encabezados.
KeyList (matriz, obligatoria) – Colección de claves de ordenación. Cada objeto clave incluye:
- Key (entero) – Índice de columna en base cero.
- SortOrder (cadena) – "ascending" (ascendente) o "descending" (descendente).
SortLeftToRight (booleano, obligatorio) – Si es true, la ordenación se realiza de izquierda a derecha; de lo contrario, de arriba a abajo.
Opcionalmente, también pueden proporcionarse CaseOrder, SortLeftToRight, etc., según la especificación OpenAPI.

La Especificación OpenAPI define una interfaz de programación accesible públicamente y permite realizar interacciones REST directamente desde un navegador web.

Puede utilizar la herramienta de línea de comandos cURL para acceder fácilmente a los servicios web de Aspose.Cells. El siguiente ejemplo muestra cómo realizar una llamada a la API en la nube mediante cURL.

Solicitud

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>"

Respuesta

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

Manejo de errores – La API puede devolver códigos de error HTTP estándar. Las respuestas típicas incluyen:

Estado HTTP	Código	Mensaje
400	400	Solicitud incorrecta: faltan o son inválidos los parámetros.
401	401	No autorizado: token JWT inválido o ausente.
404	404	No encontrado: el libro de trabajo o la hoja de cálculo no existen.
500	500	Error interno del servidor.

El cuerpo de respuesta sigue el patrón { "Code": <status>, "Message": "<description>", "Status": "Error" } en los casos de error.

Familia de SDK en la nube

Utilizar un SDK es la forma más rápida de desarrollar. Un SDK gestiona los detalles de bajo nivel, permitiéndole centrarse en las tareas de su proyecto. Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud.

Los siguientes ejemplos de código muestran cómo invocar los servicios web de Aspose.Cells mediante diversos SDK: