Cómo agregar una tabla dinámica en una hoja de cálculo de Excel mediante Aspose.Cells Cloud

Esta API REST agrega una tabla dinámica en una hoja de cálculo.

Prerrequisitos:

Una cuenta de Aspose.Cells Cloud con un token de acceso JWT válido.
El libro objetivo debe estar almacenado en una ubicación de almacenamiento compatible (almacenamiento predeterminado o un almacenamiento especificado por el usuario).
La hoja de cálculo especificada mediante sheetName debe existir en el libro.

API PutWorksheetPivotTable

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

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	El nombre del documento de Excel.
sheetName	string	path	El nombre de la hoja de cálculo donde se creará la tabla dinámica.
request	object	body	DTO `CreatePivotTableRequest` que contiene la definición de la tabla dinámica.
folder	string	query	La carpeta que contiene el documento.
storageName	string	query	El nombre del almacenamiento donde se encuentra el documento.
sourceData	string	query	El rango que proporciona los datos de origen para la nueva memoria caché de la tabla dinámica (por ejemplo, `A5:E10`).
destCellName	string	query	La dirección de la celda superior izquierda del rango de destino del informe de la tabla dinámica.
tableName	string	query	El nombre asignado a la nueva tabla dinámica.
useSameSource	boolean	query	Cuando es `true`, la nueva tabla dinámica reutiliza una fuente de datos existente, ahorrando memoria si otra tabla dinámica ya ha usado esta fuente.

La Especificación de 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 acceder fácilmente a los servicios web de Aspose.Cells. El siguiente ejemplo muestra cómo invocar la API en la nube mediante cURL.

Nota de seguridad: Utilice siempre https:// al invocar la API y mantenga su token JWT confidencial; transmitirlo mediante HTTP sin cifrar puede exponerlo a interceptaciones.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet1/pivottables" \
-X PUT \
-d '{"Name":"MyPivot","SourceData":"A5:E10","DestCellName":"H20","UseSameSource":true,"PivotFieldRows":[1],"PivotFieldColumns":[1],"PivotFieldData":[1]}' \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Respuesta

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

Códigos de estado HTTP

Código	Significado	Descripción
200	Correcto	Filtro aplicado correctamente; la respuesta contiene detalles de la operación.
400	Solicitud incorrecta	Parámetros ausentes o no válidos (por ejemplo, tipo de archivo no admitido).
401	No autorizado	Token JWT inválido o ausente.
413	Payload demasiado grande	El archivo cargado excede el límite de tamaño.
500	Error interno del servidor	Error inesperado en el servidor.

Familia de SDK en la nube

Utilizar un SDK es la mejor manera 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 invocar los servicios web de Aspose.Cells mediante diversos SDK:

Para obtener más operaciones, consulte las páginas de API relacionadas: Obtener una tabla dinámica, Eliminar una tabla dinámica y Actualizar una tabla dinámica.

Eliminar todas las tablas dinámicas en una hoja de cálculo de Excel Agregar un campo de pivote a una tabla dinámica