Aggiorna un oggetto OLE in un foglio di calcolo Excel – Guida all'API di Aspose.Cells Cloud

Questa API REST aggiorna un oggetto OLE in un foglio di calcolo Excel.

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione basata su token JWT.

API PostUpdateWorksheetOleObject

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

I parametri della richiesta sono:

Nome parametro Tipo Posizione parametro Descrizione
name string path Nome del workbook.
sheetName string path Nome del foglio di calcolo.
oleObjectIndex integer path Indice dell’oggetto OLE all’interno del foglio.
ole object body Rappresentazione JSON dell’oggetto OLE da aggiornare.
folder string query Cartella contenente il workbook.
storageName string query Nome del servizio di archiviazione.

Campi del corpo della richiesta

Campo Tipo Obbligatorio Descrizione
ImageSourceFullName string opzionale Percorso del file immagine utilizzato per l’oggetto OLE.
IsAutoSize boolean opzionale Indica se l’oggetto OLE deve essere ridimensionato automaticamente.
SourceFullName string obbligatorio File sorgente (ad esempio, un’immagine o un grafico) per l’oggetto OLE.
UpperLeftRow integer obbligatorio Indice di riga (in base zero) dell’angolo superiore sinistro.
UpperLeftColumn integer obbligatorio Indice di colonna (in base zero) dell’angolo superiore sinistro.
Left integer opzionale Spostamento orizzontale, in punti, dall’angolo superiore sinistro.
Top integer opzionale Spostamento verticale, in punti, dall’angolo superiore sinistro.
Width integer obbligatorio Larghezza dell’oggetto OLE, in punti.
Height integer obbligatorio Altezza dell’oggetto OLE, in punti.

La Specifiche OpenAPI definiscono un’interfaccia di programmazione pubblicamente accessibile e consentono di eseguire interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come chiamare l’API Cloud con cURL.

Risposte di errore

Stato HTTP Codice Messaggio
400 4000 Richiesta non valida – parametri mancanti o non validi.
401 4010 Non autorizzato – token JWT non valido o mancante.
404 4040 Non trovato – workbook, foglio di calcolo o oggetto OLE inesistente.
500 5000 Errore interno del server – errore imprevisto lato server.

L’API restituisce inoltre un campo personalizzato Code nel corpo della risposta che corrisponde allo stato HTTP (ad esempio, 200 → 2000, 400 → 4000, ecc.).

Quando utilizzare questa API?

Utilizzare questo endpoint quando è necessario modificare un oggetto OLE esistente—ad esempio un’immagine, un grafico o un documento incorporato—senza dover caricare nuovamente l’intero foglio di calcolo. Gli scenari tipici includono l’aggiornamento della fonte immagine, il ridimensionamento dell’oggetto o la modifica della sua posizione dopo la generazione del workbook. Per operazioni correlate, vedere Aggiungi un oggetto OLE e Elimina un oggetto OLE.

Famiglia di SDK Cloud

Utilizzare un SDK è il modo più rapido per sviluppare. Un SDK astrae i dettagli a basso livello, consentendoti di concentrarti sul tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

Di seguito è riportato un breve esempio in C# che aggiorna un oggetto OLE utilizzando l’SDK di 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}");

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK:

Convertire OLE Object in Immagine – Aspose.Cells Cloud REST API