Obtener datos de celdas según un rango con nombre – Aspose.Cells Cloud API

Prerrequisitos

  • Un token de acceso JWT válido con el alcance adecuado.
  • El libro debe estar cargado en el almacenamiento en la nube de Aspose (o en una carpeta especificada).
  • Asegúrese de proporcionar el nombre del almacenamiento objetivo si utiliza un almacenamiento no predeterminado.

Esta API REST devuelve una lista de celdas dentro de un rango identificado por un rango con nombre o por índices de fila y columna.

Esta operación permite a los desarrolladores recuperar programáticamente los valores de las celdas que pertenecen a un rango con nombre específico en una hoja de cálculo de Excel. Al proporcionar el identificador namedRange o los índices explícitos de fila y columna, la API devuelve una lista detallada de celdas, incluyendo su dirección, fila, columna, valor, tipo de datos e información de formato. La respuesta puede utilizarse para impulsar aplicaciones basadas en datos, generar informes o realizar cálculos adicionales del lado del servidor. El servicio Aspose.Cells Cloud admite múltiples lenguajes de programación mediante sus SDK, garantizando una integración fluida independientemente de la plataforma de desarrollo. El uso de HTTPS garantiza la transmisión segura de los datos, y la API sigue los principios REST, devolviendo códigos de estado HTTP estándar para condiciones de éxito y error.

API REST

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value

Parámetros de la solicitud

Nombre del parámetro Tipo Ubicación Descripción
name string path Nombre del archivo del libro.
sheetName string path Nombre de la hoja de cálculo dentro del libro.
namedRange string query Rango con nombre a recuperar, por ejemplo, A1:B2 o range_name1.
firstRow integer query Índice de fila (basado en cero) de la primera fila del rango (se utiliza cuando no se proporciona namedRange).
firstColumn integer query Índice de columna (basado en cero) de la primera columna del rango (se utiliza cuando no se proporciona namedRange).
rowCount integer query Número de filas incluidas en el rango.
columnCount integer query Número de columnas incluidas en el rango.
folder string query Carpeta que contiene el libro.
storageName string query Nombre del almacenamiento en la nube donde reside el libro.

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 llamar fácilmente a los servicios web de Aspose.Cells. El ejemplo siguiente muestra cómo solicitar valores de celda desde un rango con nombre.

Nota de seguridad: Utilice siempre HTTPS al llamar a la API. El servicio no admite HTTP sin cifrar; el uso de HTTPS garantiza que la solicitud esté cifrada y cumpla con las mejores prácticas de seguridad.

Códigos de estado HTTP

Código Significado Descripción
200 Correcto 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 Payload demasiado grande El archivo cargado excede el límite de tamaño.
500 Error interno del servidor Error inesperado en el servidor.

Ejemplo de respuesta de error (400 Bad Request)

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "El parámetro 'namedRange' está ausente o no es válido."
}

Consejo: La API utiliza índices basados en cero para firstRow y firstColumn. Por ejemplo, la primera fila de la hoja de cálculo es 0.

Familia de SDK en la nube

Utilizar un SDK es la forma más eficiente de acelerar el desarrollo. Un SDK abstrae los detalles de bajo nivel, permitiéndole centrarse en la lógica de negocio. 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 utilizando diversos SDK:

Obtener rangos con nombre en un libro de Excel