Actualizar un objeto OLE en una hoja de cálculo de Excel – Guía de la API de Aspose.Cells Cloud

Esta API REST actualiza un objeto OLE 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.

API PostUpdateWorksheetOleObject

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

Los parámetros de la solicitud son:

Nombre del parámetro Tipo Ubicación del parámetro Descripción
name string path Nombre del libro de trabajo.
sheetName string path Nombre de la hoja de cálculo.
oleObjectIndex integer path Índice del objeto OLE dentro de la hoja de cálculo.
ole object body Representación JSON del objeto OLE que se va a actualizar.
folder string query Carpeta que contiene el libro de trabajo.
storageName string query Nombre del servicio de almacenamiento.

Campos del cuerpo de la solicitud

Campo Tipo Obligatorio Descripción
ImageSourceFullName string opcional Ruta al archivo de imagen utilizado para el objeto OLE.
IsAutoSize boolean opcional Indica si el objeto OLE debe redimensionarse automáticamente.
SourceFullName string obligatorio Archivo fuente (por ejemplo, una imagen o gráfico) del objeto OLE.
UpperLeftRow integer obligatorio Índice de fila (base cero) de la esquina superior izquierda.
UpperLeftColumn integer obligatorio Índice de columna (base cero) de la esquina superior izquierda.
Left integer opcional Desplazamiento horizontal, en puntos, desde la esquina superior izquierda.
Top integer opcional Desplazamiento vertical, en puntos, desde la esquina superior izquierda.
Width integer obligatorio Ancho del objeto OLE, en puntos.
Height integer obligatorio Alto del objeto OLE, en puntos.

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 llamar a la API en la nube mediante cURL.

Respuestas de error

Estado HTTP Código Mensaje
400 4000 Solicitud incorrecta: parámetros faltantes o no válidos.
401 4010 No autorizado: token JWT no válido o faltante.
404 4040 No encontrado: el libro de trabajo, la hoja de cálculo o el objeto OLE no existen.
500 5000 Error interno del servidor: fallo inesperado del lado del servidor.

La API también devuelve un campo personalizado Code en el cuerpo de la respuesta que se corresponde con el estado HTTP (por ejemplo, 200 → 2000, 400 → 4000, etc.).

¿Cuándo utilizar esta API?

Utilice este endpoint cuando necesite modificar un objeto OLE existente —como una imagen, gráfico o documento incrustado— sin volver a cargar toda la hoja de cálculo. Los escenarios típicos incluyen actualizar la fuente de la imagen, cambiar el tamaño del objeto o modificar su posición tras haber generado el libro de trabajo. Para operaciones relacionadas, consulte Agregar un objeto OLE y Eliminar un objeto OLE.

Familia de SDK en la nube

Utilizar un SDK es la forma más rápida de desarrollar. Un SDK abstracte los detalles de bajo nivel para que usted pueda centrarse en su proyecto. Consulte el repositorio de GitHub para ver una lista completa de los SDK de Aspose.Cells Cloud.

A continuación se muestra un ejemplo breve en C# que actualiza un objeto OLE utilizando el SDK de Aspose.Cells Cloud:

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;

var config = new Configuration
{
    AppSid = "<your-app-sid>",
    AppKey = "<your-app-key>"
};
var oleApi = new OleObjectsApi(config);
var request = new OleObjectUpdateRequest
{
    ImageSourceFullName = "aspose-logo.png",
    IsAutoSize = true,
    SourceFullName = "Sample_Book2.xls",
    UpperLeftRow = 15,
    UpperLeftColumn = 5,
    Left = 10,
    Top = 10,
    Width = 400,
    Height = 400
};

var response = oleApi.UpdateWorksheetOleObject("SampleBook.xlsx", "Sheet1", 0, request, folder: "myFolder");
Console.WriteLine($"Status: {response.Status}");

Los siguientes ejemplos de código muestran cómo llamar a los servicios web de Aspose.Cells mediante diversos SDK:

Convertir objeto OLE a imagen – Aspose.Cells Cloud REST API