Establecer fórmula en celdas de hojas de cálculo de Excel

Esta API REST establece una fórmula de celda en un archivo de Excel.

API REST

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

Seguridad y autenticación

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

Parámetros de la solicitud

Nombre del parámetro	Tipo	Ubicación	Obligatorio	Descripción
name	string	path	Sí	Nombre del documento de Excel.
sheetName	string	path	Sí	Nombre de la hoja de cálculo.
cellName	string	path	Sí	Dirección de la celda objetivo (por ejemplo, A1).
value	string	query	No	Valor que se asignará a la celda.
type	string	query	No	Tipo de datos del valor (por ejemplo, string).
formula	string	query	No	Fórmula que se aplicará a la celda (por ejemplo, sum(A1,A2)).
folder	string	query	No	Carpeta que contiene el documento.
storageName	string	query	No	Nombre del servicio de almacenamiento.

Respuesta

Devuelve CellResponse.

Resumen de campos de respuesta

Campo	Tipo	Descripción
`Name`	string	Dirección de la celda (por ejemplo, `F341`).
`Row`	integer	Índice de fila (base cero).
`Column`	integer	Índice de columna (base cero).
`Value`	string	Valor mostrado por la celda.
`Type`	string	Tipo de datos de la celda (por ejemplo, `IsString`).
`Formula`	string	Texto de la fórmula si la celda contiene una fórmula.
`IsFormula`	bool	Indica si la celda contiene una fórmula.
`IsMerged`	bool	Indica si la celda forma parte de un rango fusionado.
`IsArrayHeader`	bool	Indica si la celda es un encabezado de matriz.
`IsInArray`	bool	Indica si la celda pertenece a una matriz.
`IsErrorValue`	bool	Indica si la celda contiene un valor de error.
`IsInTable`	bool	Indica si la celda está dentro de una tabla.
`IsStyleSet`	bool	Indica si se ha aplicado un estilo a la celda.
`HtmlString`	string	Representación codificada en HTML del valor de la celda.
`Style.link`	object	Hipervínculo al recurso de estilo.

{
  "Status":"OK",
  "Code":200,
  "Cell":{
    "Name":"A1",
    "Row": 0,
    "Column":0,
    "Value": "",
    "Type":"String",
    "Formula" : "=Sum(A2:A15)",
    ...
  }
}

Códigos de estado HTTP

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

Cómo utilizar la API `PostWorksheetCellSetValue` con SDK

Especificación de la API `PostWorksheetCellSetValue`

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

Utilice la herramienta de línea de comandos cURL para llamar a los servicios web de Aspose.Cells.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/myWorkbook.xlsx/worksheets/Sheet1/cells/A1?value=1234&type=string&formula=sum(A2:A15)" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access‑token>"

Respuesta

{
  "Code": 200,
  "Status": "OK",
  "Cell":{
    "Name":"A1",
    "Row": 0,
    "Column":0,
    "Value": "",
    "Type":"String",
    "Formula" : "=Sum(A2:A15)",
    ...
  }
}

Utilizar los SDK de Aspose.Cells Cloud

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 obtener 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:

// Ejemplo en C# – establecer fórmula en una celda
// Reemplace <access-token>, <file-name>, etc. por sus valores.
var api = new CellsApi("<client-id>", "<client-secret>", "https://api.aspose.cloud");
var response = api.PostWorksheetCellSetValue(
    name: "myWorkbook.xlsx",
    sheetName: "Sheet1",
    cellName: "A3",
    value: "1234",
    type: "string",
    formula: "SUM(A1,A2)",
    folder: null,
    storageName: null);
Console.WriteLine(response.Status);

Java

// Ejemplo en Java – establecer fórmula en una celda
CellsApi api = new CellsApi("<client-id>", "<client-secret>", "https://api.aspose.cloud");
PostWorksheetCellSetValueRequest request = new PostWorksheetCellSetValueRequest()
        .name("myWorkbook.xlsx")
        .sheetName("Sheet1")
        .cellName("A3")
        .value("1234")
        .type("string")
        .formula("SUM(A1,A2)");
CellsResponse response = api.postWorksheetCellSetValue(request);
System.out.println(response.getStatus());

PHP

<?php
// Ejemplo en PHP – establecer fórmula en una celda
require_once('vendor/autoload.php');

$config = new Aspose\Cells\Configuration();
$config->setAppKey('<client-id>');
$config->setAppSid('<client-secret>');
$config->setHost('https://api.aspose.cloud');

$apiInstance = new Aspose\Cells\Api\CellsApi($config);
$result = $apiInstance->postWorksheetCellSetValue(
    "myWorkbook.xlsx",
    "Sheet1",
    "A3",
    "1234",
    "string",
    "SUM(A1,A2)"
);
echo $result->getStatus();
?>

Ruby

# Ejemplo en Ruby – establecer fórmula en una celda
require 'aspose_cells_cloud'

config = AsposeCellsCloud::Configuration.new
config.api_key['client_id'] = '<client-id>'
config.api_key['client_secret'] = '<client-secret>'
config.host = 'https://api.aspose.cloud'

api = AsposeCellsCloud::CellsApi.new
result = api.post_worksheet_cell_set_value(
  name: 'myWorkbook.xlsx',
  sheet_name: 'Sheet1',
  cell_name: 'A3',
  value: '1234',
  type: 'string',
  formula: 'SUM(A1,A2)'
)
puts result.status

Python

# Ejemplo en Python – establecer fórmula en una celda
import asposecellscloud

client = asposecellscloud.CellsApiClient(
    client_id='<client-id>',
    client_secret='<client-secret>',
    base_url='https://api.aspose.cloud'
)

api = asposecellscloud.CellsApi(client)
response = api.post_worksheet_cell_set_value(
    name='myWorkbook.xlsx',
    sheet_name='Sheet1',
    cell_name='A3',
    value='1234',
    type='string',
    formula='SUM(A1,A2)'
)
print(response.status)

Node.js

// Ejemplo en Node.js – establecer fórmula en una celda
const { CellsApi, ApiClient } = require('asposecellscloud');
const client = new ApiClient();
client.config = {
    clientId: '<client-id>',
    clientSecret: '<client-secret>',
    baseUrl: 'https://api.aspose.cloud'
};

const cellsApi = new CellsApi(client);
cellsApi.postWorksheetCellSetValue({
    name: 'myWorkbook.xlsx',
    sheetName: 'Sheet1',
    cellName: 'A3',
    value: '1234',
    type: 'string',
    formula: 'SUM(A1,A2)'
}).then(res => console.log(res.status));

Android

// Ejemplo en Android (Java) – establecer fórmula en una celda
// Similar al ejemplo estándar en Java; asegúrese de utilizar el SDK compatible con Android.

Swift

Ejemplo en Swift no disponible. El SDK para Swift está actualmente en desarrollo.

Perl

# Ejemplo en Perl – establecer fórmula en una celda
use AsposeCellsCloud::CellsApi;
my $api_instance = AsposeCellsCloud::CellsApi->new(
    client_id => '<client-id>',
    client_secret => '<client-secret>',
    base_url => 'https://api.aspose.cloud'
);
my $result = $api_instance->post_worksheet_cell_set_value(
    name => 'myWorkbook.xlsx',
    sheet_name => 'Sheet1',
    cell_name => 'A3',
    value => '1234',
    type => 'string',
    formula => 'SUM(A1,A2)'
);
print $result->{Status};

// Ejemplo en Go – establecer fórmula en una celda
package main

import (
    "fmt"
    "github.com/asposecellscloud/asposecellscloud-go/v3"
)

func main() {
    config := asposecellscloud.NewConfiguration()
    config.ClientId = "<client-id>"
    config.ClientSecret = "<client-secret>"
    config.BasePath = "https://api.aspose.cloud"

    api := asposecellscloud.NewAPIClient(config).CellsApi
    resp, _, err := api.PostWorksheetCellSetValue(
        "myWorkbook.xlsx",
        "Sheet1",
        "A3",
        map[string]string{
            "value":   "1234",
            "type":    "string",
            "formula": "SUM(A1,A2)",
        },
        nil,
        nil,
    )
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(resp.Status)
}

Establecer el valor de una celda – Referencia de la API de Aspose.Cells Cloud (v3.0) Calcular fórmula de celda – API de Aspose.Cells Cloud

Establecer fórmula en celdas de hojas de cálculo de Excel

API REST

Seguridad y autenticación

Respuesta

Cómo utilizar la API PostWorksheetCellSetValue con SDK

Especificación de la API PostWorksheetCellSetValue

Utilizar los SDK de Aspose.Cells Cloud

Cómo utilizar la API `PostWorksheetCellSetValue` con SDK

Especificación de la API `PostWorksheetCellSetValue`