Establecer valor de rango en una hoja de cálculo de Excel – API de Aspose.Cells Cloud
Utilice esta API REST para establecer un valor en el rango especificado. Cuando corresponda, el valor se convierte a otro tipo de datos y se restablece el formato numérico de la celda.
Requisitos previos
- Una cuenta válida de Aspose Cloud.
- Un token JWT que incluya el ámbito
Cells.ReadWrite. - El libro ya debe haberse cargado en la ubicación de almacenamiento de destino.
API PostWorksheetCellsRangeValue
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value
Los parámetros de solicitud son:
| Nombre del parámetro | Tipo | Ubicación | Descripción |
|---|---|---|---|
| name | string | path | Nombre del libro |
| sheetName | string | path | Nombre de la hoja de cálculo |
| value | string | query | Valor de entrada |
| range | object | body | Objeto de rango en la hoja de cálculo |
| isConverted | boolean | query | Indica si el valor de entrada debe convertirse |
| setStyle | boolean | query | Indica si se debe aplicar estilo a las celdas de destino |
| folder | string | query | Carpeta del libro |
| storageName | string | query | Nombre del almacenamiento |
Ejemplo del objeto range que puede enviarse en el cuerpo de la solicitud:
{
"range": {
"FirstRow": 0,
"FirstColumn": 0,
"RowCount": 1,
"ColumnCount": 1
}
}
La Especificación OpenAPI define una interfaz de programación accesible públicamente y le 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 llamar a la API en la nube con cURL. Incluya un token JWT válido en el encabezado Authorization.
Esquema de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| Code | integer | Código de estado HTTP de la operación. |
| Status | string | Descripción breve del resultado (por ejemplo, “OK”). |
| Message | string | Mensaje detallado de error cuando la solicitud falla (opcional). |
| Result | object | Datos adicionales devueltos en llamadas exitosas (opcional). |
Códigos de estado HTTP posibles
- 200 OK – El valor del rango se estableció correctamente.
- 400 Bad Request – Parámetros no válidos o cuerpo de solicitud mal formado.
- 401 Unauthorized – Token JWT faltante o no válido.
- 403 Forbidden – Permisos insuficientes para la operación solicitada.
- 404 Not Found – El libro, la hoja de cálculo o el rango especificados no existen.
- 500 Internal Server Error – Error inesperado del servidor.
Ejemplo de respuesta de error para un 400 Bad Request:
{
"Code": 400,
"Status": "Bad Request",
"Message": "Faltan campos obligatorios en el objeto 'range'."
}
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, lo que 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 utilizando diversos SDK: