Transformez la conversion de feuilles de calcul en une seule ligne : guide complet de l’API Aspose.Cells Cloud Convert (.NET / Python / Java)

Pas d’installation locale d’Excel. Aucun serveur de conversion à gérer. Convertissez XLSX → PDF, Excel → CSV/JSON/images/HTML en appels REST simples — et faites fonctionner votre premier “convertisseur de feuilles de calcul cloud” en environ trois minutes.

“Convert that spreadsheet to a different format” est l’une des exigences les plus courantes dans le développement quotidien :

• Les équipes financières et juridiques souhaitent un rapport PDF en lecture seule et résistant à la falsification plutôt qu’un .xlsx que tout le monde peut modifier ;
• Les équipes de données ont besoin d’extraire des données tabulaires vers les systèmes en aval au format CSV / JSON ;
• Les applications web et mobiles veulent des feuilles de calcul — et même des graphiques — rendus directement en PNG / SVG ;
• Les portails souhaitent des extraits HTML / HTML-Table propres à intégrer ;
• Quelqu’un doit normaliser un tas de fichiers .xls / .xlsx / .csv / .ods en un seul format.

Les réponses à l’ancienne — une installation locale d’Excel avec des macros, ou un composant COM lourd sur votre propre serveur — sont difficiles à mettre à l’échelle et compliquées à maintenir multiplateforme. Aspose.Cells Cloud remplace tout cela par une API REST pure : téléchargez un fichier, recevez un fichier au nouveau format en retour.

Cet article passe en revue les trois API de conversion exposées par le ConversionController principal du microservice Aspose.Cells Cloud (source : src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs), avec des exemples exécutables en cURL, C# (.NET), Python et Java.

1. Que peut faire la fonctionnalité Convertir ?

ConversionController est le contrôleur dédié à la conversion de format / exportation. Il encapsule la conversion de niveau moteur, à haute fidélité, en trois ensembles d’API HTTP :

Note d’implémentation : les routes source utilisent le préfixe v{version}/cells avec la version d’API 4.0, ainsi les appels en direct ressemblent à https://api.aspose.cloud/v4.0/cells/....

La granularité de la conversion va bien au-delà du “fichier complet”

En plus de convertir un classeur complet, le contrôleur peut exporter un élément unique :

• Une feuille de calcul spécifique → PDF / image / CSV / JSON / HTML
• Une plage de cellules spécifique (par ex. A1:C12) → PDF / image / CSV / JSON / HTML
• Un tableau spécifique → PDF / image / CSV / JSON / HTML
• Un graphique spécifique → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF

Ainsi, vous n’aurez jamais à convertir un classeur complet de 50 Mo simplement pour extraire un graphique — convertissez uniquement ce dont vous avez besoin et économisez la bande passante ainsi que la puissance de calcul.

2. Quels formats sont pris en charge ?

En se basant sur le registre intégré ExportData dans le contrôleur, la matrice de conversion ressemble approximativement à ceci :

En bref : feuille‑de‑calcul‑à‑feuille‑de‑calcul conversions de tous types, plus toute la famille des sorties feuille‑de‑calcul → PDF / image / données web — le tout derrière une seule surface d’API.

3. Deux choses dont vous avez besoin avant de commencer

1. Inscrivez-vous gratuitement sur le Aspose Cloud Dashboard et créez une Application pour obtenir un Client ID et un Client Secret (les SDK échangent ces informations contre un JWT automatiquement — aucune nécessité de créer vous-même les en‑têtes d’authentification).
2. Installez le SDK pour le langage de votre choix :

<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

<!-- Java (Maven) — note: NOT on Maven Central, so the Aspose repo below is required -->
<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <name>Aspose Java API</name>
        <url>https://repository.aspose.cloud/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cells-cloud</artifactId>
    <version>26.8</version>
</dependency>

Pas de SDK requis ? Tout est du REST pur, donc cURL fonctionne tout aussi bien (voir ci‑dessous).

4. Scénario 1 : Convertir un fichier Excel local en ligne (le titre Convert API)

Ceci est PUT /v4.0/cells/convert/spreadsheet — l’API phare “Convert” :

téléversez votre fichier local dans le corps de la requête, le serveur le convertit et renvoie le nouveau fichier en flux. Rien n’est conservé dans le stockage cloud et aucune copie d’envoi ne persiste — parfait pour “juste convertissez cela pour moi” moments.

① cURL

# 1) First, get a token
curl -X POST "https://api.aspose.cloud/connect/token" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

# 2) XLSX -> PDF
curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet?format=pdf" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@Book1.xlsx" \
  -o Book1.pdf

Remplacez format par csv, json, png, xlsx… et vous obtenez ce format. Un paramètre, un format de sortie.

② C# / .NET

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

var cellsApi = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

var request = new ConvertSpreadsheetRequest(
    spreadsheet: "C:/invoices/Book1.xlsx",   // local file path
    format: "pdf");                          // target: pdf / csv / json / png ...

using Stream result = cellsApi.ConvertSpreadsheet(request); // converted file stream
using var outFile = File.Create("C:/invoices/Book1.pdf");
result.CopyTo(outFile);

// Even simpler: point the SDK at an output path and let it write the file
// cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf");

Besoin d’un travail par lots ? Placez ceci dans une boucle sur un répertoire et vous avez “convertir tout le dossier XLSX → PDF”.

③ Python

from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import ConvertSpreadsheetRequest
import os

instance = CellsApi(
    os.getenv('CellsCloudClientId'),
    os.getenv('CellsCloudClientSecret'))

# Local XLSX -> PDF, result written locally
instance.convert_spreadsheet(
    ConvertSpreadsheetRequest("Book1.xlsx", "pdf"),
    local_outpath="Book1.pdf")

# Other formats: just change the parameter — json / csv / xlsx / png ...

④ Java

import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.request.ConvertSpreadsheetRequest;
import java.io.File;

public class ConvertDemo {
    public static void main(String[] args) throws Exception {
        CellsApi api = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

ConvertSpreadsheetRequest req = new ConvertSpreadsheetRequest();
        req.setSpreadsheet("C:/invoices/Book1.xlsx");   // local file path
        req.setFormat("pdf");                           // target: pdf / csv / json / png ...

File out = api.convertSpreadsheet(req);         // converted result as a File
        out.renameTo(new File("C:/invoices/Book1.pdf"));
        System.out.println("Converted: " + out.getAbsolutePath());
    }
}

Quatre langues, une action : donnez un chemin + un paramètre de format → récupérez le fichier cible. C’est le principal argument de vente de l’API Convert — aucune dépendance Excel du côté appelant, pas de modèles, pas de composants COM.

5. Scénario 2 : Convertir directement un fichier stocké dans le cloud

Lorsqu’un fichier est déjà stocké dans Aspose Cloud Storage (ou votre stockage d’objets), vous n’avez pas besoin de télécharger/téléverser de gros fichiers — la conversion se fait dans le cloud, minimisant le transfert de données et améliorant les performances sur les grands classeurs :

# cloud Book1.xlsx -> PDF, downloaded locally
curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "format=pdf" \
  --data-urlencode "folder=Reports" \
  -o Book1.pdf

from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import ExportSpreadsheetAsFormatRequest

instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")

# Convert a cloud-stored workbook straight to PDF
instance.export_spreadsheet_as_format(
    ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports"))

Vous pouvez également extraire un seul élément — par ex. rendre “le 3e graphique sur Sheet1” en PNG (version stockage cloud) :

# chart -> PNG
curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/worksheets/Sheet1/charts/2" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "format=png" \
  -o chart.png

Points de terminaison cloud granulaires en un coup d’œil:

Scénario 3 : SaveAs — écrire le résultat dans le stockage cloud

Lorsque vous souhaitez que le fichier converti soit conservé dans le stockage cloud (plutôt que téléchargé), utilisez PUT /v4.0/cells/{name}/saveas. C’est parfaitement adapté à l’automatisation telle que « exporter le rapport d’aujourd’hui au format PDF pour archivage, chaque jour » :

curl -X PUT "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/saveas?format=pdf" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import SaveSpreadsheetAsRequest

instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")
instance.save_spreadsheet_as(
    SaveSpreadsheetAsRequest("Book1.xlsx", format="pdf", folder="Reports"))
# Result is saved directly in cloud storage; returns CellsCloudResponse(Code=200, Status="OK")

Vous pouvez transmettre des options d’enregistrement détaillées via le corps de la requête SaveOptionsData, et contrôler le nom du fichier de sortie, le stockage de sortie, les polices personnalisées, la région/la locale, le mot de passe, etc. via les paramètres de requête — plus d’informations à ce sujet dans la section Détails techniques ci-dessous.

7. Plus de points de terminaison « online convert » prêts à l’emploi

En plus des conversions au niveau du classeur ci‑dessus, le contrôleur expose un ensemble complet de points de terminaison dédiés local-file → specific-target (téléversement du corps de la requête identique au Scénario 1), qui sont plus granulaires et moins coûteux en bande passante :

Par exemple, « exporter uniquement cette plage au format CSV pour le système en aval » :

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/csv" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "worksheet=Sheet1" \
  --data-urlencode "range=A1:C100" \
  -F "file=@data.xlsx" \
  -o data.csv

Ces points de terminaison utilisent le même modèle de téléchargement dans le corps que convert/spreadsheet. Dans le SDK .NET, les cas chart disposent de wrappers typés qui correspondent à ces routes v4.0 — ConvertChartToImage (convert/chart/image) et ConvertChartToPdf (convert/chart/pdf). Les variantes worksheet/*, range/* et table/* n’ont pas encore de wrapper v4.0, il faut donc les appeler via REST simple exactement comme le cURL ci‑dessus le fait.

8. Détails d’ingénierie et gestion des erreurs

Options de conversion à connaître (paramètres de requête)

• password — ouvrir les classeurs protégés par mot de passe ;
• fontsLocation / prise en charge des polices personnalisées — conserver les glyphes corrects lors du rendu PDF/images ;
• ajustement automatique des lignes/colonnes, et si imprimer les en-têtes de ligne/colonne (printHeadings), configuration de région/page (region), etc.;
• côté sortie : outPath / outStorageName décident où le résultat est stocké dans le stockage cloud.

Codes d’erreur (le contrat que le contrôleur documente)

Authentification

Tous les SDK s’authentifient automatiquement avec OAuth 2.0 client_credentials et un JWT ; lors de l’utilisation de cURL brut, appelez /connect/token une fois d’abord (voir le Scénario 1, ① ci‑dessus).

9. Pourquoi Aspose.Cells Cloud Convert ?

• ✅ Aucune dépendance locale — pas d’Office/Excel, pas de COM. Appelable depuis n’importe quel langage et n’importe quelle plateforme (Linux, conteneurs, serverless);
• ✅ Rendu haute fidélité — propulsé par le moteur Aspose.Cells, de sorte que les formules, graphiques, styles et la pagination sont rendus avec une qualité professionnelle en PDF/images;
• ✅ Natif cloud — les fichiers peuvent rester dans le cloud pendant la conversion afin d’éviter l’envoi de gros volumes ; la conversion purement en ligne ne nécessite aucun stockage cloud ;
• ✅ Granularité flexible — workbook / worksheet / range / table / chart : convertissez exactement la partie dont vous avez besoin ;
• ✅ Une forme unique à travers les SDK — les exemples cURL, .NET, Python et Java correspondent 1:1, vous pouvez donc littéralement copier le modèle qui vous convient.

Commencez dès maintenant: inscrivez‑vous sur le Aspose Cloud Dashboard, créez une Application, déposez vos informations d’identification dans n’importe quel extrait ci‑dessus, et exécutez‑le — vous disposerez de votre propre « convertisseur Excel cloud » en quelques minutes.

Vous avez trouvé cela utile ? Ajoutez une étoile, un signet ou partagez‑le — et dites‑nous quels sont vos propres cas d’utilisation de conversion de feuilles de calcul dans les commentaires.