Ordenar datos de ListObject en una hoja de cálculo de Excel – API de Aspose.Cells Cloud

Requisitos previos
Para invocar esta API, debe disponer de un token de acceso JWT válido de Aspose Cloud y el libro debe haberse cargado previamente en el almacenamiento de Aspose Cloud. Incluya el encabezado Authorization: Bearer <jwt token> en cada solicitud.

Esta API REST ordena los datos de una tabla en una hoja de cálculo de Excel.
Para utilizar esta operación, proporcione el nombre del libro, el nombre de la hoja de cálculo y el índice del ListObject objetivo, junto con un cuerpo JSON dataSorter que defina los criterios de ordenación.

API PostWorksheetListObjectSortTable

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

Seguridad y autenticación

Las API de Aspose.Cells Cloud son seguras y requieren autenticación mediante token JWT.

Parámetros de solicitud

Nombre del parámetro	Tipo	Ruta / Cadena de consulta / Cuerpo HTTP	Descripción
name	string	path	Nombre del archivo de Excel almacenado en el almacenamiento de Aspose Cloud.
sheetName	string	path	Nombre de la hoja de cálculo que contiene el ListObject.
listObjectIndex	integer	path	Índice de base cero del ListObject (tabla) dentro de la hoja de cálculo.
dataSorter	object	body	Objeto JSON que especifica las opciones de ordenación (por ejemplo, `CaseSensitive`, `HasHeaders`, `KeyList`, `SortLeftToRight`).
folder	string	query	Ruta de carpeta dentro del almacenamiento donde se encuentra el archivo de Excel.
storageName	string	query	Nombre del almacenamiento de Aspose Cloud.

Notas
El cuerpo de la solicitud debe ser un objeto JSON válido que coincida con el esquema dataSorter. Asegúrese de que el libro, la hoja de cálculo y el ListObject existan antes de invocar la operación de ordenación.

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 llamadas a la API en la nube con cURL.

Solicitud

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

Respuesta

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

Códigos de estado HTTP

Código de estado	Descripción
200	OK – ordenación completada correctamente.
400	Solicitud incorrecta – parámetros no válidos.
401	No autorizado – error de autenticación.
404	No encontrado – libro, hoja de cálculo o ListObject no hallado.
500	Error interno del servidor – problema del lado del servidor.

Parámetros de respuesta

Parámetro	Tipo	Descripción
Code	integer	Código de estado HTTP devuelto por la API.
Status	string	Descripción textual del resultado (por ejemplo, “OK”).

Familia de SDK en la nube

Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK gestiona los detalles de bajo nivel y le permite 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:

Volver a la vista general de ListObjects

Convertir objeto de lista a rango: API de Aspose.Cells Cloud