Ajouter un objet OLE à une feuille de calcul Excel avec l’API Aspose.Cells Cloud
L’API Aspose.Cells Cloud permet la manipulation programmatique de classeurs Excel, notamment la capacité à intégrer directement des objets OLE (par exemple, documents Word, fichiers PDF ou autres fichiers binaires) dans une feuille de calcul.
Cette API REST ajoute un objet OLE à une feuille de calcul Excel.
Prérequis – Vous devez disposer d’un jeton d’authentification JWT valide, et tous les fichiers sources référencés par oleFile ou imageFile doivent être préalablement téléchargés dans l’emplacement de stockage spécifié avant d’invoquer le point de terminaison.
API PutWorksheetOleObject
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects
Sécurité et authentification
Les API Aspose.Cells Cloud sont sécurisées et exigent une authentification basée sur un jeton JWT.
Paramètres de la requête
| Nom du paramètre | Type | Emplacement | Description |
|---|---|---|---|
| name | string | path | Nom du fichier de classeur. |
| sheetName | string | path | Nom de la feuille de calcul. |
| oleObject | object | body | Définition de l’objet OLE. |
| upperLeftRow | integer | query | Index de ligne du coin supérieur gauche (par défaut 0). |
| upperLeftColumn | integer | query | Index de colonne du coin supérieur gauche (par défaut 0). |
| height | integer | query | Hauteur de l’objet OLE (par défaut 0). |
| width | integer | query | Largeur de l’objet OLE (par défaut 0). |
| oleFile | string | query | Nom du fichier source OLE. |
| imageFile | string | query | Nom du fichier d’image d’aperçu. |
| folder | string | query | Dossier contenant le classeur. |
| storageName | string | query | Nom du stockage à utiliser. |
Remarques – upperLeftRow et upperLeftColumn utilisent un indexation à partir de zéro. Le fichier oleFile (et éventuellement imageFile) doit déjà exister dans le stockage cible ; sinon, la requête renverra une erreur.
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 les services web Aspose.Cells. L’exemple ci-dessous montre comment ajouter un objet OLE à l’aide de cURL. HTTPS est requis pour tous les appels en production.
Codes d’état HTTP possibles
| Code | Description |
|---|---|
| 200 | Objet OLE ajouté avec succès. |
| 400 | Requête incorrecte – paramètres manquants ou invalides. |
| 401 | Non autorisé – jeton JWT invalide ou manquant. |
| 404 | Introuvable – le classeur, la feuille de calcul ou le fichier source n’existe pas. |
| 500 | Erreur interne du serveur – échec inattendu. |
Une réponse réussie typique renvoie la charge utile JSON suivante :
{
"Code": 200,
"Status": "OK",
"Data": {
"OleObjectId": "12345",
"UpperLeftRow": 15,
"UpperLeftColumn": 5,
"Width": 400,
"Height": 400,
"SourceFullName": "Sample_Book2.xls",
"ImageSourceFullName": "aspose-logo.png"
}
}
Famille de SDK Cloud
L’utilisation d’un SDK accélère le développement. Un SDK masque les détails de bas niveau, vous permettant de 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 ci-dessous montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :