Agregar filtro superior 10 a una hoja de cálculo de Excel – Aspose.Cells Cloud

Esta API REST filtra los 10 elementos superiores en una lista.

Requisitos previos
• Obtenga un token JWT válido mediante la autenticación de Aspose.Cells Cloud.
• Cargue el libro de Excel en su almacenamiento de Aspose Cloud (o especifique el almacenamiento/carpeta donde se encuentra).
• Conozca el nombre de la hoja de cálculo y el rango de celdas que desea filtrar.

API PutWorksheetFilterTop10

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

Seguridad y autenticación

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

Parámetros de solicitud

Nombre del parámetro	Tipo	Ubicación	Obligatorio	Valor predeterminado	Descripción
name	string	path	Sí	—	Nombre del archivo de Excel.
sheetName	string	path	Sí	—	Nombre de la hoja de cálculo que contiene los datos.
range	string	query	Sí	—	Rango de celdas al que se aplica el filtro (por ejemplo, `A1:B10`).
fieldIndex	integer	query	Sí	—	Índice de columna (base cero) sobre el que se aplica el filtro.
isTop	boolean	query	Sí	`true`	`true` para filtrar los elementos superiores; `false` para los inferiores.
isPercent	boolean	query	No	`false`	`true` para tratar `itemCount` como un porcentaje; `false` para una cantidad absoluta.
itemCount	integer	query	No	`10`	Número de elementos que se incluirán en el filtro.
matchBlanks	boolean	query	No	`false`	`true` para incluir celdas en blanco en los resultados del filtro.
refresh	boolean	query	No	`false`	`true` para actualizar el filtro tras aplicarlo.
folder	string	query	No	—	Carpeta en el almacenamiento donde se encuentra el archivo de Excel.
storageName	string	query	No	—	Nombre del almacenamiento de Aspose Cloud.

Respuesta

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

Respuestas de error típicas

{
    "Code":400,
    "Message":"Solicitud incorrecta: parámetros ausentes o no válidos."
}

{
    "Code":401,
    "Message":"No autorizado: token JWT no válido o ausente."
}

{
    "Code":413,
    "Message":"Solicitud demasiado grande: el archivo cargado supera el tamaño permitido."
}

{
    "Code":500,
    "Message":"Error interno del servidor: condición inesperada del servidor."
}

Códigos de estado HTTP

Código	Significado	Descripción
200	OK	Filtro aplicado correctamente; la respuesta contiene los detalles de la operación.
400	Solicitud incorrecta	Parámetros ausentes o no válidos (por ejemplo, tipo de archivo no admitido).
401	No autorizado	Token JWT no válido o ausente.
413	Solicitud demasiado grande	El archivo cargado supera el límite de tamaño.
500	Error interno del servidor	Error inesperado del servidor.

Cómo utilizar la API PutWorksheetFilterTop10 con SDK

Especificación de la API PutWorksheetFilterTop10

La Especificación OpenAPI define una interfaz de programación públicamente accesible y le 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 llamar a la API con cURL.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/autoFilter/filterTop10?range=A1:B10&fieldIndex=0&isTop=true&itemCount=10" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Respuesta

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

Utilizar los SDK de Aspose.Cells Cloud

Utilizar un SDK es la forma más rápida de desarrollar. Un SDK gestiona los detalles de bajo nivel para que usted pueda centrarse en 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 llamar a los servicios web de Aspose.Cells mediante diversos SDK:

Agregar un filtro dinámico en una hoja de cálculo de Excel usando la API de Aspose.Cells Cloud AutoFitterOptions – Guía de propiedades y uso | Aspose.Cells Cloud API