Aggiungi un oggetto OLE a un foglio di calcolo Excel con l'API Aspose.Cells Cloud

L’API Aspose.Cells Cloud consente la manipolazione programmatica di cartelle di lavoro Excel, inclusa la possibilità di incorporare oggetti OLE (ad esempio documenti Word, PDF o altri file binari) direttamente in un foglio di calcolo.

Questa API REST aggiunge un oggetto OLE a un foglio di calcolo Excel.

Prerequisiti – È necessario disporre di un token di autenticazione JWT valido e i file di origine a cui fanno riferimento oleFile o imageFile devono essere caricati nella posizione di archiviazione specificata prima di richiamare l’endpoint.

API PutWorksheetOleObject

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

Sicurezza e autenticazione

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

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file della cartella di lavoro.
sheetName	string	path	Nome del foglio di calcolo.
oleObject	object	body	Definizione dell’oggetto OLE.
upperLeftRow	integer	query	Indice di riga dell’angolo superiore sinistro (default 0).
upperLeftColumn	integer	query	Indice di colonna dell’angolo superiore sinistro (default 0).
height	integer	query	Altezza dell’oggetto OLE (default 0).
width	integer	query	Larghezza dell’oggetto OLE (default 0).
oleFile	string	query	Nome del file sorgente OLE.
imageFile	string	query	Nome del file immagine di anteprima.
folder	string	query	Cartella contenente la cartella di lavoro.
storageName	string	query	Nome dell’archiviazione da utilizzare.

Note – upperLeftRow e upperLeftColumn utilizzano un indicizzazione a base zero. Il file oleFile (e opzionalmente imageFile) deve già esistere nell’archiviazione di destinazione; altrimenti la richiesta restituirà un errore.

La specifiche OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare interazioni REST direttamente da un browser web.

È possibile utilizzare lo strumento a riga di comando cURL per chiamare i servizi web di Aspose.Cells. L’esempio seguente dimostra come aggiungere un oggetto OLE con cURL. Per tutte le chiamate in produzione è obbligatorio HTTPS.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/oleobjects" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{"ImageSourceFullName":"aspose-logo.png", "IsAutoSize":true, "SourceFullName":"Sample_Book2.xls", "UpperLeftRow":15, "Top":10, "UpperLeftColumn":5, "Left":10, "Width":400, "Height":400}'

Risposta

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

Screenshot che mostra un oggetto OLE incorporato in un foglio di calcolo Excel

Codici di stato HTTP possibili

Codice	Descrizione
200	Oggetto OLE aggiunto correttamente.
400	Richiesta non valida – parametri mancanti o non validi.
401	Non autorizzato – token JWT non valido o mancante.
404	Non trovato – la cartella di lavoro, il foglio o il file sorgente non esiste.
500	Errore interno del server – errore imprevisto.

Una tipica risposta positiva restituisce il seguente payload JSON:

{
  "Code": 200,
  "Status": "OK",
  "Data": {
    "OleObjectId": "12345",
    "UpperLeftRow": 15,
    "UpperLeftColumn": 5,
    "Width": 400,
    "Height": 400,
    "SourceFullName": "Sample_Book2.xls",
    "ImageSourceFullName": "aspose-logo.png"
  }
}

Famiglia di SDK per il Cloud

Utilizzare un SDK accelera lo sviluppo. Un SDK astrae i dettagli a basso livello, consentendoti di concentrarti sulla logica di business. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

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

Aggiorna un oggetto OLE in un foglio di calcolo Excel