Agregar una columna vacía a una hoja de cálculo de Excel mediante la API de Aspose.Cells Cloud

Esta API REST inserta una o más columnas en una hoja de cálculo.

Prerrequisitos
Antes de llamar a este punto final, asegúrese de haber completado los siguientes pasos:

  • Obtenga un token de acceso válido de OAuth 2.0 e inclúyalo en el encabezado Authorization.
  • Almacene el libro de trabajo objetivo en el almacenamiento seleccionado (predeterminado = “Default”) o especifique los parámetros adecuados folder y storageName.
  • Verifique que el nombre de la hoja de cálculo proporcionado en sheetName exista en el libro de trabajo.

API PutInsertWorksheetColumns

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/{columnIndex}?totalColumns=1

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 del libro de trabajo.
sheetName string path Nombre de la hoja de cálculo.
columnIndex integer path Índice de base cero de la columna donde comienza la inserción.
totalColumns integer query Número de columnas a insertar.
updateReference boolean query Si es true, se actualizan las referencias de celdas para reflejar la inserción.
folder string query Ruta a la carpeta que contiene el libro de trabajo.
storageName string query Nombre del servicio de almacenamiento.

Notas

  • El valor de columnIndex debe estar entre 0 y el número actual de columnas en la hoja de cálculo. Insertar más allá del rango existente expandirá automáticamente la hoja.
  • Insertar varias columnas (totalColumns > 1) desplaza las columnas existentes hacia la derecha.
  • El indicador updateReference tiene como valor predeterminado false; configúrelo como true para actualizar fórmulas y rangos con nombre.

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 llamar a los servicios web de Aspose.Cells. El siguiente ejemplo muestra una solicitud completa, incluida la autenticación y el parámetro de ruta correcto.

Códigos de respuesta

Código Descripción
200 Columna(s) insertada(s) correctamente.
400 Solicitud incorrecta: parámetros faltantes o no válidos.
401 No autorizado: token inválido o faltante.
404 Libro de trabajo o hoja de cálculo no encontrado.
500 Error interno del servidor.

Ejemplos de respuestas de error

// 400 Bad Request – parámetros faltantes o no válidos
{
  "Code": 400,
  "Message": "Parámetro no válido: totalColumns debe ser un entero positivo."
}

// 401 Unauthorized – token inválido o faltante
{
  "Code": 401,
  "Message": "La autenticación falló. El token de acceso falta o no es válido."
}

// 404 Not Found – el libro de trabajo o la hoja de cálculo no existe
{
  "Code": 404,
  "Message": "Libro de trabajo 'test.xlsx' no encontrado."
}

// 500 Internal Server Error
{
  "Code": 500,
  "Message": "Se produjo un error inesperado en el servidor."
}

Familia de SDK en la nube

Utilizar un SDK es la forma más rápida de desarrollar. Un SDK maneja los detalles de bajo nivel para que pueda centrarse 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 llamar a los servicios web de Aspose.Cells mediante diversos SDK:

Obtener detalles de columna – Referencia de la API en la nube de Aspose.Cells (v4.0) Copiar columnas en una hoja de cálculo de Excel