L’importation d’une image dans une feuille de calcul Excel vous permet d’enrichir vos classeurs avec du contenu visuel, tel que des logos, des graphiques ou des diagrammes. Ce guide explique comment utiliser l’opération ImportPicture d’Aspose.Cells Cloud, le format de requête requis, ainsi que la gestion des réponses.
Prérequis : Vous devez disposer d’un jeton d’authentification JWT valide et d’un classeur existant stocké dans Aspose Cloud Storage avant d’appeler l’opération d’importation.
API PostImportData
POST https://api.aspose.cloud/v3.0/cells/import
Sécurité et authentification
Les API Aspose.Cells Cloud sont sécurisées et nécessitent une authentification basée sur jeton JWT.
Paramètres de la requête
La requête est une POST HTTP avec un contenu multipart/related (voir RFC 2046 ou RFC 1341).
- La première partie contient un objet JSON nommé ImportPictureOption décrivant l’emplacement et la manière d’insérer l’image.
- La deuxième partie contient le fichier image (ou ses données codées en Base64).
ImportPictureOption – définition
{
"UpperLeftRow": 0,
"UpperLeftColumn": 0,
"LowerRightRow": 10,
"LowerRightColumn": 5,
"Filename": "logo.png",
"Data": "iVBORw0KGgoAAAANSUhEUgAA...",
"DestinationWorksheet": "Sheet1",
"IsInsert": true,
"ImportDataType": "Picture",
"Source": { "FileSource": "Storage" }
}
IsInsert est un booléen – true insère une nouvelle image, false remplace une image existante.
Paramètres importants
ImportPictureOption
| Nom du paramètre | Type | Description |
|---|---|---|
| UpperLeftRow | int | Index de ligne du coin supérieur gauche où l’image sera placée. |
| UpperLeftColumn | int | Index de colonne du coin supérieur gauche où l’image sera placée. |
| LowerRightRow | int | Index de ligne du coin inférieur droit définissant les limites de l’image. |
| LowerRightColumn | int | Index de colonne du coin inférieur droit définissant les limites de l’image. |
| Filename | string | Nom du fichier image. |
| Data | string | Données binaires de l’image codées en Base64 (facultatif si le fichier est transmis dans la deuxième partie). |
| DestinationWorksheet | string | Nom de la feuille de calcul dans laquelle l’image sera insérée. |
| IsInsert | boolean | true pour insérer une nouvelle image ; false pour remplacer une image existante. |
| ImportDataType | string | Type de données à importer (par exemple, Picture, IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData). |
| Source | FileSource | Indique l’emplacement du fichier de données lorsque le paramètre BatchData est null. |
Réponse
Une requête réussie renvoie HTTP 200 avec une charge utile JSON similaire à :
{
"Code": 200,
"Status": "OK"
}
Codes de statut possibles :
| Code | Signification |
|---|---|
| 200 | Importation réussie |
| 400 | Requête incorrecte – données manquantes ou invalides |
| 401 | Non autorisé – jeton invalide ou manquant |
| 500 | Erreur interne du serveur |
Comment utiliser l’API PostImportData avec les SDK
Spécification de l’API PostImportData
La spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer des interactions REST directement depuis un navigateur web.
Utilisation des SDK Aspose.Cells Cloud
L’utilisation d’un SDK constitue la méthode optimale pour accélérer le développement. Un SDK gère les détails de bas niveau, vous permettant ainsi de vous concentrer sur les tâches de votre projet. Consultez le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.
Les exemples de code suivants illustrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :