Agrupar Columnas – Documentación de la API en la Nube Aspise.Cells

Agrupar Columnas en una Hoja de Cálculo de Excel

Versión de la API: v3.0
Operación: PostGroupWorksheetColumns – Agrupa columnas de la hoja de cálculo en la hoja de cálculo.

Descripción General

Esta API REST le permite agrupar un rango de columnas en una hoja de cálculo. Las columnas agrupadas pueden mostrarse u ocultarse, lo que le permite crear secciones plegables similares a las de Microsoft Excel.

Requisitos Previos

  • Un token de acceso JWT válido obtenido desde el servicio de autenticación de Aspose Cloud.
  • El libro debe estar almacenado en una ubicación accesible para Aspose.Cells Cloud (almacén predeterminado o un nombre de almacenamiento personalizado).
  • Versión necesaria del SDK (si se utiliza un SDK): la última versión que soporte la API versión v3.0.

Autenticación

Todas las solicitudes requieren autenticación mediante token Bearer.

Authorization: Bearer <access_token>

Para más detalles sobre cómo obtener un token, consulte la guía de autenticación JWT.

Solicitud HTTP

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/group
Parámetro Ubicación Obligatorio Descripción
name Ruta Sí Nombre del archivo del libro (por ejemplo, test.xlsx).
sheetName Ruta Sí Hoja de cálculo que contiene las columnas que se van a agrupar.
firstIndex Consulta Sí Índice de base cero de la primera columna que se incluirá en el grupo.
lastIndex Consulta Sí Índice de base cero de la última columna que se incluirá en el grupo.
hide Consulta No Si es true, las columnas agrupadas se ocultan; de lo contrario, permanecen visibles.
folder Consulta No Ruta de la carpeta que contiene el libro.
storageName Consulta No Nombre del servicio de almacenamiento donde se encuentra el archivo.

Ejemplo de Solicitud (cURL)

curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/group?firstIndex=1&lastIndex=2&hide=true" \
     -H "accept: application/json" \
     -H "Authorization: Bearer <access_token>"

Nota: La solicitud utiliza HTTPS para garantizar una comunicación cifrada.

Respuesta

Éxito (200)

Campo Tipo Descripción
Code entero Código de estado HTTP (200).
Status cadena Estado textual de la operación (OK).

Ejemplo

{
  "Code": 200,
  "Status": "OK"
}

Error (por ejemplo, 400 Solicitud Incorrecta)

Campo Tipo Descripción
Code entero Código de estado HTTP (400, 401, 404, 500, …).
Status cadena Estado textual (Error).
ErrorMessage cadena Descripción legible por humanos del problema.
ErrorCode cadena Identificador programático del error.

Ejemplo – Solicitud Incorrecta

{
  "Code": 400,
  "Status": "Error",
  "ErrorMessage": "Índice de columna no válido.",
  "ErrorCode": "InvalidParameter"
}

Ejemplos de SDK

Los fragmentos siguientes muestran cómo llamar a la operación Agrupar Columnas de la Hoja de Cálculo utilizando los SDK admitidos.

Observaciones

  • Comportamiento de agrupación: La API crea un grupo de columnas que puede expandirse o contraerse en Excel. Configurar hide=true contrae inmediatamente el grupo.
  • Indexación base cero: Tanto firstIndex como lastIndex comienzan en 0; la primera columna de una hoja de cálculo tiene el índice 0.
  • Consideraciones sobre almacenamiento: Si el libro reside en un almacenamiento no predeterminado, proporcione ambos parámetros de consulta folder y storageName.

Consulte también

Ilustración: Captura de pantalla que muestra columnas agrupadas en una hoja de cálculo de Excel{: .img-fluid alt=“Captura de pantalla que muestra columnas agrupadas en una hoja de cálculo de Excel” }

La imagen de marcador de posición anterior debe reemplazarse por una captura de pantalla real que muestre el resultado visual de agrupar columnas.

Obtener detalles de columna – Referencia de la API en la nube de Aspose.Cells (v4.0)