Prerrequisitos: Antes de llamar a esta API, debe obtener un token JWT válido, asegurarse de que el libro de trabajo objetivo esté subido al almacenamiento especificado y contar con los permisos necesarios para acceder al archivo. Se recomienda utilizar una versión reciente de cURL (7.68 o posterior) para los ejemplos de línea de comandos.
Esta API REST agrega un filtro para una columna específica en una hoja de cálculo de Excel.
API PutWorksheetFilter
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/filter
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 | Descripción |
|---|---|---|---|
| name | string | Path | Nombre del libro de trabajo. |
| sheetName | string | Path | Nombre de la hoja de cálculo. |
| range | string | Query | Rango de celdas que contiene el filtro (por ejemplo, A1:B1). |
| fieldIndex | integer | Query | Índice basado en cero de la columna a la que se aplica el filtro. |
| criteria | string | Query | Criterios del filtro (por ejemplo, un valor o expresión). |
| matchBlanks | boolean | Query | Establecer en true para incluir celdas en blanco en el filtro; de lo contrario, false. |
| refresh | boolean | Query | Establecer en true para actualizar el filtro tras aplicarlo; de lo contrario, false. |
| folder | string | Query | Carpeta donde se almacena el libro de trabajo original. |
| storageName | string | Query | Nombre del servicio de almacenamiento. |
Respuesta
{
"Status":"OK",
"Code":200
}
Códigos de estado HTTP
| Código | Significado | Descripción |
|---|---|---|
| 200 | OK | Filtro aplicado correctamente; la respuesta contiene 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 inválido o ausente. |
| 413 | Carga útil demasiado grande | El archivo subido excede el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado en el servidor. |
Cómo utilizar la API PutWorksheetFilter con SDK
Especificación de la API PutWorksheetFilter
La Especificación OpenAPI define una interfaz de programación públicamente accesible 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 invocar la API mediante cURL.
Utilizar los SDK de Aspose.Cells Cloud
Utilizar un SDK es la forma más rápida de desarrollar. Un SDK maneja los detalles de bajo nivel, permitiéndole 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 invocar los servicios web de Aspose.Cells mediante diversos SDK: