Recupera oggetto OLE da foglio di calcolo Excel – Aspose.Cells Cloud API

Questa API REST recupera un oggetto OLE da un foglio di calcolo Excel.

Sicurezza e autenticazione

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

API REST

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects/{objectNumber}?format={format}

Parametri della richiesta

Nome Parametro	Tipo	Posizione	Descrizione
name	stringa	path	Nome del documento.
sheetName	stringa	path	Nome del foglio di calcolo.
objectNumber	intero	path	Numero dell’oggetto all’interno del foglio di calcolo.
format	stringa	query	Formato di esportazione desiderato per l’oggetto (ad esempio, `png`, `jpeg`).
folder	stringa	query	Cartella contenente il documento.
storageName	stringa	query	Nome dello storage da utilizzare.

Opzioni di storage

folder – specifica la sottocartella nello storage predefinito in cui risiede il file di lavoro.
storageName – sovrascrive il nome dello storage predefinito se il file di lavoro è archiviato altrove.

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

Puoi utilizzare lo strumento a riga di comando cURL per chiamare il servizio web di Aspose.Cells. L’esempio seguente mostra come richiedere un oggetto OLE come immagine PNG.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/Embedded_OleObject_Sample_Book1.xlsx/worksheets/Sheet1/oleobjects/0?format=png" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Risposta

Risposta immagine binaria

Quando format è impostato su un tipo di immagine (ad esempio, png), l’API restituisce i dati binari dell’immagine con l’intestazione:

Content-Type: image/png

(Il file immagine viene trasmesso direttamente al client.)

Risposta metadati JSON

Se format viene omesso o impostato su json, l’API restituisce un payload JSON che descrive l’oggetto OLE:

{
  "Code": 200,
  "Status": "OK",
  "OLEObject": {
    "Name": "Object1",
    "Width": 200,
    "Height": 150,
    "Left": 10,
    "Top": 20,
    "IsLocked": false,
    "FileFormat": "png"
  }
}

Risposte di errore

Stato HTTP	Codice errore	Descrizione
400	BadRequest	Parametri mancanti o non validi.
401	Unauthorized	Token JWT non valido o mancante.
404	NotFound	File di lavoro, foglio di calcolo o oggetto OLE non trovato.
500	ServerError	Errore imprevisto del server.

Esempio di risposta 404

{
  "Code": 404,
  "Status": "NotFound",
  "Message": "L'oggetto OLE richiesto con numero 0 non è stato trovato nel foglio 'Sheet1'."
}

Famiglia di SDK cloud

Utilizzare un SDK è il modo più rapido per integrare l’API. Gli SDK gestiscono i dettagli di basso livello, consentendoti di concentrarti sulla logica aziendale. Vedi il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

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

Aggiungi un oggetto OLE in un foglio di calcolo Excel