Agregar un criterio personalizado en una hoja de cálculo de Excel – API de Aspose.Cells Cloud

Esta API REST filtra una lista utilizando un criterio personalizado.

API PutWorksheetCustomFilter

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

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 archivo de Excel.
sheetName	string	path	Nombre de la hoja de cálculo que contiene los datos que se van a filtrar.
range	string	query	Rango de celdas al que se aplicará el filtro (por ejemplo, `A1:B1`).
fieldIndex	integer	query	Índice de columna basado en cero sobre el que se aplica el filtro.
operatorType1	string	query	Primer operador de comparación (por ejemplo, `LessOrEqual`, `Equal`).
criteria1	string	query	Primer valor o expresión de filtro.
isAnd	boolean	query	Si es `true`, combina ambos criterios con Y; de lo contrario, con O.
operatorType2	string	query	Segundo operador de comparación (opcional).
criteria2	string	query	Segundo valor o expresión de filtro (opcional).
matchBlanks	boolean	query	Cuando es `true`, se incluyen las celdas vacías en los resultados del filtro.
refresh	boolean	query	Si es `true`, fuerza la actualización de la hoja de cálculo tras aplicar el filtro.
folder	string	query	Ruta de carpeta en el almacenamiento donde se encuentra el archivo.
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 no vá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 PutWorksheetCustomFilter con SDKs

Especificación de la API PutWorksheetCustomFilter

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

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/autoFilter/custom?range=A1:B1&fieldIndex=0&operatorType1=LessOrEqual&criteria1=1" \
  -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 maneja los detalles de bajo nivel para que usted se enfoque en la lógica 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 utilizando diversos SDK:

Para otras operaciones de AutoFilter, como agregar un filtro estándar o un filtro de fecha, consulte las páginas de documentación relacionadas dentro de la sección AutoFilter.

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