Mettre à jour un objet OLE dans une feuille de calcul Excel – Guide de l’API Aspose.Cells Cloud

Cette API REST met à jour un objet OLE dans 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 PostUpdateWorksheetOleObject

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

Les paramètres de la requête sont les suivants :

Nom du paramètre	Type	Emplacement du paramètre	Description
name	string	path	Nom du classeur.
sheetName	string	path	Nom de la feuille de calcul.
oleObjectIndex	integer	path	Index de l’objet OLE dans la feuille de calcul.
ole	object	body	Représentation JSON de l’objet OLE à mettre à jour.
folder	string	query	Dossier contenant le classeur.
storageName	string	query	Nom du service de stockage.

Champs du corps de la requête

Champ	Type	Obligatoire	Description
ImageSourceFullName	string	facultatif	Chemin vers le fichier image utilisé pour l’objet OLE.
IsAutoSize	boolean	facultatif	Indique si l’objet OLE doit être redimensionné automatiquement.
SourceFullName	string	obligatoire	Fichier source (par exemple, image ou graphique) de l’OLE.
UpperLeftRow	integer	obligatoire	Index de ligne (à partir de 0) du coin supérieur gauche.
UpperLeftColumn	integer	obligatoire	Index de colonne (à partir de 0) du coin supérieur gauche.
Left	integer	facultatif	Décalage horizontal, en points, par rapport au coin supérieur gauche.
Top	integer	facultatif	Décalage vertical, en points, par rapport au coin supérieur gauche.
Width	integer	obligatoire	Largeur de l’objet OLE, en points.
Height	integer	obligatoire	Hauteur de l’objet OLE, en points.

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 accéder facilement aux services web Aspose.Cells. L’exemple suivant montre comment appeler l’API Cloud avec cURL.

Requête

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

Réponse

{
  "Code": 200,
  "Status": "OK",
  "OLEObject": {
    "Index": 0,
    "ImageSourceFullName": "aspose-logo.png",
    "IsAutoSize": true,
    "SourceFullName": "Sample_Book2.xls",
    "UpperLeftRow": 15,
    "UpperLeftColumn": 5,
    "Left": 10,
    "Top": 10,
    "Width": 400,
    "Height": 400
  }
}

Réponses d’erreur

Statut HTTP	Code	Message
400	4000	Requête incorrecte – paramètres manquants ou non valides.
401	4010	Non autorisé – jeton JWT invalide ou manquant.
404	4040	Introuvable – le classeur, la feuille de calcul ou l’objet OLE n’existe pas.
500	5000	Erreur interne du serveur – échec inattendu côté serveur.

L’API renvoie également un champ personnalisé Code dans le corps de la réponse, qui correspond au statut HTTP (par exemple, 200 → 2000, 400 → 4000, etc.).

Quand utiliser cette API ?

Utilisez ce point de terminaison lorsque vous devez modifier un objet OLE existant — par exemple, une image, un graphique ou un document intégré — sans avoir à réimporter l’ensemble de la feuille de calcul. Les scénarios typiques incluent la mise à jour de la source de l’image, le redimensionnement de l’objet ou le changement de sa position après la génération du classeur. Pour des opérations connexes, voir Ajouter un objet OLE et Supprimer un objet OLE.

Famille de SDK Cloud

L’utilisation d’un SDK est la méthode la plus rapide pour développer. Un SDK abstractise les détails de bas niveau afin que vous puissiez vous concentrer sur votre projet. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

Voici un court exemple en C# qui met à jour un objet OLE à l’aide du SDK Aspose.Cells Cloud :

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;

var config = new Configuration
{
    AppSid = "<votre-app-sid>",
    AppKey = "<votre-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($"Statut : {response.Status}");

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 Convertir un objet OLE en image – Aspose.Cells Cloud REST API