Obtener rangos con nombre en un libro de Excel – Aspose.Cells Cloud API

Esta API REST devuelve información sobre los rangos con nombre definidos dentro de las hojas de cálculo.

Antecedentes – Un rango con nombre es un identificador definido por el usuario que hace referencia a una celda específica o a un bloque de celdas en una hoja de cálculo. Los rangos con nombre simplifican la creación de fórmulas, mejoran la legibilidad y permiten el acceso programático a áreas frecuentemente utilizadas de un libro.

Requisitos previos – El acceso a la API de Aspose.Cells Cloud requiere un token de acceso JWT válido. Obtenga el token autenticándose con su ID de cliente y secreto de cliente de Aspose Cloud a través del punto final del token OAuth 2.0. Incluya el token en el encabezado Authorization: Bearer <jwt token> de cada solicitud.

API GetNamedRanges

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

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	Ruta	El nombre del documento de Excel.
folder	string	Cadena de consulta	La carpeta que contiene el documento.
storageName	string	Cadena de consulta	El nombre del almacenamiento donde reside el documento.

Códigos de estado HTTP

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

La Especificación OpenAPI define una interfaz de programación accesible públicamente que le permite realizar interacciones REST directamente desde un navegador web.

Puede utilizar la herramienta de línea de comandos cURL para invocar los servicios web de Aspose.Cells. El siguiente ejemplo muestra cómo recuperar rangos con nombre mediante cURL.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/ranges" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Respuesta

{
  "Ranges": {
    "RangeList": [
      {
        "ColumnCount": 7,
        "ColumnWidth": 8.428571428571429,
        "FirstColumn": 1,
        "FirstRow": 9,
        "Name": "data",
        "RefersTo": "=Sheet1!$B$10:$H$10",
        "RowCount": 1,
        "RowHeight": 15,
        "Worksheet": "Sheet1"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

Modelo de respuesta

Campo	Tipo	Descripción
`ColumnCount`	integer	Número de columnas en el rango.
`ColumnWidth`	number	Ancho de cada columna (en puntos).
`FirstColumn`	integer	Índice basado en cero de la primera columna del rango.
`FirstRow`	integer	Índice basado en cero de la primera fila del rango.
`Name`	string	Nombre definido por el usuario para el rango.
`RefersTo`	string	Fórmula que define la referencia a la celda (por ejemplo, `=Sheet1!$B$10:$H$10`).
`RowCount`	integer	Número de filas en el rango.
`RowHeight`	number	Altura de cada fila (en puntos).
`Worksheet`	string	Nombre de la hoja de cálculo que contiene el rango.

Familia de SDK en la nube

Utilizar un SDK es la forma más rápida de integrar esta funcionalidad. Los SDK manejan los detalles de bajo nivel para que usted se enfoque en la lógica de su 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 invocar los servicios web de Aspose.Cells mediante diversos SDK:

Obtener datos de celdas según un rango con nombre