Mover un rango con nombre en una hoja de cálculo de Excel mediante la API de Aspose.Cells Cloud

Mover un rango con nombre es una tarea común cuando necesita reorganizar datos programáticamente. Esta sección explica cómo reubicar un rango definido en una nueva posición dentro de la misma hoja de cálculo mediante la API REST de Aspose.Cells Cloud.

Esta API REST mueve un rango especificado a un rango de destino en una hoja de cálculo de Excel.

API REST

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

Autenticación

La API requiere un token JWT Bearer obtenido mediante el flujo OAuth de Aspose Cloud. Incluya el token en el encabezado Authorization:

Authorization: Bearer <token jwt>

El token debe tener el ámbito Cells.

Requisitos previos

  • El libro debe estar almacenado en el almacenamiento de Aspose Cloud.
  • Proporcione el nombre del almacenamiento (storageName) y la ruta de la carpeta (folder) si el archivo no se encuentra en el directorio raíz.
  • Utilice la versión más reciente del SDK de Aspose.Cells Cloud que admita la versión de la API v3.0.

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 Tipo Ubicación Descripción
name string path Nombre del archivo del libro
sheetName string path Nombre de la hoja de cálculo
destRow integer query Índice de fila inicial del rango de destino (basado en 0)
destColumn integer query Índice de columna inicial del rango de destino (basado en 0)
range object body Definición del rango origen que se va a mover
folder string query Ruta de la carpeta donde se almacena el libro
storageName string query Nombre del almacenamiento de Aspose Cloud

Cuerpo de la solicitud

Campo Tipo Obligatorio Descripción
ColumnCount integer No Número de columnas del rango origen
ColumnWidth integer No Anchura de cada columna (en puntos)
FirstColumn integer No Índice basado en 0 de la primera columna del rango origen
FirstRow integer No Índice basado en 0 de la primera fila del rango origen
Name string No Nombre del rango (si se trata de un rango con nombre)
RefersTo string No Referencia en estilo A1 que define el rango
RowCount integer No Número de filas del rango origen
RowHeight integer No Altura de cada fila (en puntos)
Worksheet string No Hoja de cálculo que contiene el rango origen

Flujo de trabajo

  1. Subir el libro al almacenamiento de Aspose Cloud (si aún no existe).
  2. Generar un token JWT utilizando el endpoint OAuth.
  3. Construir la carga útil JSON que describe el rango origen.
  4. Llamar al endpoint moveto con los parámetros de ruta, query y cuerpo JSON requeridos.
  5. Verificar la respuesta; una llamada correcta devuelve el código de estado 200 OK.

Ejemplo de solicitud / respuesta

Cuando se produce un error, la respuesta incluye un campo opcional ErrorMessage que proporciona detalles adicionales sobre la falla.

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 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 subido excede el límite de tamaño.
500 Error interno del servidor Error inesperado en el servidor.

Esquema de respuesta

Campo Tipo Descripción
Code integer Código de estado similar a HTTP devuelto por la API (por ejemplo, 200)
Status string Descripción textual del resultado (por ejemplo, “OK”)
ErrorMessage string (opcional) Detalles del error legibles por humanos cuando la llamada falla

Familia de SDK en la nube

Utilizar un SDK es la mejor manera de acelerar el desarrollo. Un SDK gestiona los detalles de bajo nivel para que usted se enfoque en las tareas 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 realizar llamadas a los servicios web de Aspose.Cells mediante diversos SDK: