Agregar un objeto de lista (tabla) a una hoja de cálculo de Excel – Documentación de Aspose.Cells Cloud

Esta API REST agrega un objeto de lista (tabla) a una hoja de cálculo de Excel.

Antes de usar este punto de conexión, asegúrese de tener un token JWT válido, de que el libro esté almacenado en un almacenamiento en la nube compatible y de que la hoja de cálculo exista.

API REST

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

Parámetros de la solicitud

Nombre del parámetro	Tipo	Ubicación	Descripción
name	string	path	Nombre del archivo del libro.
sheetName	string	path	Nombre de la hoja de cálculo.
startRow	integer	query	Índice de base cero de la primera fila del rango de la tabla.
startColumn	integer	query	Índice de base cero de la primera columna del rango de la tabla.
endRow	integer	query	Índice de base cero de la última fila del rango de la tabla.
endColumn	integer	query	Índice de base cero de la última columna del rango de la tabla.
hasHeaders	boolean	query	`true` si la primera fila contiene encabezados de columna; de lo contrario, `false`.
listObject	object	body	Definición del objeto de lista (véase Esquema del cuerpo de la solicitud).
folder	string	query	Carpeta que contiene el libro.
storageName	string	query	Nombre del almacenamiento.

Esquema del cuerpo de la solicitud

El objeto listObject describe la tabla que se creará. Solo se muestran las propiedades más comunes; consulte la especificación OpenAPI para obtener la lista completa.

{
  "displayName": "MiTabla",
  "showTotals": false,
  "style": "TableStyleMedium2"
}

Ejemplo de solicitud (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/listobjects?startRow=1&startColumn=1&endRow=10&endColumn=12&hasHeaders=true" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "displayName": "MiTabla",
        "showTotals": false,
        "style": "TableStyleMedium2"
      }'

Ejemplo de respuesta

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

Códigos de error

Estado HTTP	Razón	Descripción
400	Solicitud incorrecta	Parámetros de rango inválidos o cuerpo JSON mal formado.
401	No autorizado	Token JWT ausente o caducado.
404	No encontrado	El libro o la hoja de cálculo especificados no existen.
500	Error interno del servidor	Fallo inesperado del lado del servidor.

Ejemplo de respuesta 400

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Invalid range parameters."
}

Ejemplo de respuesta 401

{
  "Code": 401,
  "Status": "Unauthorized",
  "Message": "Authentication token is missing or expired."
}

La Especificación OpenAPI proporciona el contrato completo para esta operación.

Familia de SDK en la nube

Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK maneja los detalles de bajo nivel y le permite centrarse 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 realizar llamadas a los servicios web de Aspose.Cells mediante diversos SDK:

Aspose.Cells Cloud API – Obtener objeto de lista (tabla) de hoja de cálculo Actualizar un objeto de lista en una hoja de cálculo de Excel