Esta API de REST actualiza las propiedades de un objeto de lista (tabla) en una hoja de cálculo de Excel.

Seguridad y autenticación

Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.

Esquema del cuerpo de la solicitud

El DTO listObject contiene los siguientes campos. Solo son obligatorios en el cuerpo de la solicitud los campos que desee modificar.

Campo Tipo Obligatorio Descripción
DisplayName string opcional Nombre que se muestra para la tabla.
StartRow / StartColumn integer opcional Índice en base cero de la primera fila/columna de la tabla.
EndRow / EndColumn integer opcional Índice en base cero de la última fila/columna de la tabla.
Range string opcional Dirección estilo A1 que define el rango de la tabla (por ejemplo, A1:D10).
ShowHeaderRow boolean opcional true para mostrar la fila de encabezados.
ShowTotals boolean opcional true para mostrar la fila de totales.
TableStyleName string opcional Nombre del estilo de tabla integrado que se aplicará.
TableStyleType string opcional Tipo de estilo (TableStyleLight, TableStyleMedium, etc.).
ListColumns matriz de objetos opcional Colección de definiciones de columnas (Name, TotalsCalculation).
Sorter, AutoFilter, ShowTableStyle… objeto opcional Opciones avanzadas de estilo y filtrado (consulte el DTO completo en la especificación OpenAPI).

Ejemplo mínimo de carga útil

{
  "DisplayName": "SalesData",
  "Range": "A1:E20",
  "ShowHeaderRow": true,
  "ShowTotals": false
}

API de REST

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

Parámetros de la solicitud

Nombre del parámetro Tipo Ubicación Descripción
name string path Nombre del documento.
sheetName string path Nombre de la hoja de cálculo.
listObjectIndex integer path Índice del objeto de lista que se va a actualizar.
listObject object body DTO ListObject en el cuerpo de la solicitud.
folder string query Carpeta que contiene el documento.
storageName string query Nombre del almacenamiento.

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

Solicitud

Respuestas de error

Código HTTP Descripción Carga útil de ejemplo
400 Solicitud incorrecta: faltan campos obligatorios o JSON mal formado. { "Code": 400, "Message": "Invalid request body." }
401 No autorizado: el token JWT falta o no es válido. { "Code": 401, "Message": "Authentication failed." }
404 No encontrado: el libro, la hoja de cálculo o el objeto de lista especificados no existen. { "Code": 404, "Message": "Resource not found." }
500 Error interno del servidor: condición inesperada en el lado del servidor. { "Code": 500, "Message": "Server error." }

Preguntas frecuentes

¿Cómo actualizo un objeto de lista mediante la API de Aspose.Cells Cloud?

Utilice el punto de conexión POST /cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}. Incluya un cuerpo JSON con las propiedades que desee modificar (por ejemplo, DisplayName, ShowHeaderRow). Autentíquese mediante un token JWT en el encabezado Authorization.

¿Qué respuesta recibo tras una actualización correcta?

Se devuelve un objeto JSON con Code: 200 y Status: "OK". Si se produce un error, la respuesta incluye el código de estado HTTP correspondiente y un objeto Error que describe el problema.

¿Puedo actualizar solo un subconjunto de las propiedades del objeto de lista?

Sí. Incluya solo los campos que desee modificar en el cuerpo de la solicitud; todos los campos omitidos permanecerán sin cambios.

Documentación relacionada

Familia de SDK en la nube

Utilizar un SDK es la mejor forma 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 ver 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: