Récupérer un objet OLE à partir d'une feuille Excel – Aspose.Cells Cloud API

Cette API REST permet de récupérer un objet OLE à partir d’une feuille de calcul Excel.

Sécurité et authentification

Les API Aspose.Cells Cloud sont sécurisées et nécessitent une authentification basée sur un jeton JWT.

API REST

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

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	path	Nom du document.
sheetName	string	path	Nom de la feuille de calcul.
objectNumber	integer	path	Numéro de l’objet dans la feuille de calcul.
format	string	query	Format d’export souhaité pour l’objet (par ex. `png`, `jpeg`).
folder	string	query	Dossier contenant le document.
storageName	string	query	Nom du stockage à utiliser.

Options de stockage

folder – spécifie le sous-dossier dans le stockage par défaut où se trouve le classeur.
storageName – remplace le nom du stockage par défaut si le classeur est stocké ailleurs.

La Spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer des interactions REST directement depuis un navigateur web.

Vous pouvez utiliser l’outil en ligne de commande cURL pour appeler le service web Aspose.Cells. L’exemple ci-dessous montre comment demander un objet OLE sous forme d’image PNG.

Requête

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 <jeton jwt>"

Réponse

Réponse binaire (image)

Lorsque le paramètre format est défini sur un type d’image (par ex. png), l’API renvoie les données binaires de l’image avec l’en-tête :

Content-Type: image/png

(Le fichier image est transmis en flux direct au client.)

Réponse JSON (méta-données)

Si format est omis ou défini sur json, l’API renvoie une charge utile JSON décrivant l’objet OLE :

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

Réponses d’erreur

Statut HTTP	Code d’erreur	Description
400	BadRequest	Paramètres manquants ou non valides.
401	Unauthorized	Jeton JWT invalide ou manquant.
404	NotFound	Classeur, feuille de calcul ou objet OLE introuvable.
500	ServerError	Erreur serveur inattendue.

Exemple de réponse 404

{
  "Code": 404,
  "Status": "NotFound",
  "Message": "L'objet OLE numéro 0 n'a pas été trouvé dans la feuille 'Sheet1'."
}

Famille de SDK Cloud

Utiliser un SDK est la méthode la plus rapide pour intégrer l’API. Les SDK gèrent les détails de bas niveau afin que vous puissiez vous concentrer sur votre logique métier. Consultez le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

Les exemples de code suivants montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :

Ajouter un objet OLE dans une feuille de calcul Excel