Gør regnearkskonvertering til en enkelt linje: En komplet guide til Aspose.Cells Cloud Convert API (.NET / Python / Java)

Ingen lokal Excel‑installation. Ingen konverteringsserver at vedligeholde. Konverter XLSX → PDF, Excel → CSV/JSON/billeder/HTML til enkle REST‑kald — og få din første “cloud spreadsheet converter” i gang på omkring tre minutter.

“Convert that spreadsheet to a different format” er et af de mest almindelige krav i hverdagsudvikling:

• Finans- og juridiske teams ønsker en kun‑læse, manipulationssikker PDF‑rapport i stedet for en .xlsx, som alle kan redigere;
• Datateams har brug for at trække tabeldata ind i downstream‑systemer som CSV / JSON;
• Web‑ og mobilapps vil have regneark — og endda diagrammer — gengivet direkte til PNG / SVG;
• Portaler ønsker rene HTML / HTML-Table‑udsnit til indlejring;
• En eller anden skal normalisere en bunke .xls / .xlsx / .csv / .ods‑filer til ét format.

De gammeldags svar — en lokal Excel‑installation med makroer, eller en tung COM‑komponent på din egen server — er vanskelige at skalere og svære at holde tværplatform. Aspose.Cells Cloud erstatter alt dette med en ren REST API: upload en fil, få en fil i nyt format tilbage.

Dette indlæg gennemgår de tre konverterings‑API’er, som den centrale ConversionController i Aspose.Cells Cloud‑mikrotjeneste eksponerer (kilde: src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs), med eksekverbare eksempler i cURL, C# (.NET), Python og Java.

1. Hvad kan Convert-funktionen gøre?

ConversionController er controlleren, der er dedikeret til formatkonvertering / eksport. Den omslutter konverteringen på motor-niveau med høj nøjagtighed i tre sæt af HTTP API’er:

Implementationsnote: kilde‑ruterne bruger præfikset v{version}/cells med API‑version 4.0, så live‑kald ser sådan ud: https://api.aspose.cloud/v4.0/cells/....

Konverteringsgranularitet går langt ud over “hele filen”

Udover at konvertere en hel projektmappe, kan kontrolleren eksportere et enkelt element:

• Et specifikt regneark → PDF / image / CSV / JSON / HTML
• Et specifikt celleområde (f.eks. A1:C12) → PDF / image / CSV / JSON / HTML
• Et specifikt tabel → PDF / image / CSV / JSON / HTML
• Et specifikt diagram → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF

Så behøver du aldrig at konvertere en hel 50 MB‑projektmappe blot for at hente et enkelt diagram — konvertér kun det, du har brug for, og spar båndbredde og beregning.

2. Hvilke formater understøttes?

Baseret på den indbyggede ExportData-register i controlleren, ser konverteringsmatricen omtrent sådan ud:

Kort sagt: regneark-til-regneark konverteringer af enhver art, plus hele familien af regneark → PDF / billede / web-data output — alt bag én API‑grænseflade.

To ting du har brug for, før du starter

1. Registrer en gratis konto på Aspose Cloud Dashboard og opret en applikation for at få en Client ID og Client Secret (SDK’erne udveksler disse for en JWT automatisk — ingen grund til at bygge auth‑headers selv).
2. Installer SDK’en for dit foretrukne sprog:

<!-- .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>

Ingen SDK påkrævet? Alt er ren REST, så cURL fungerer lige så godt (se nedenfor).

4. Scenario 1: Konverter en lokal Excel-fil online (overskriften Convert API)

Dette er PUT /v4.0/cells/convert/spreadsheet — den førende “Convert” API: upload din lokale fil i anmodningskroppen, serveren konverterer den og streamer den nye fil tilbage. Intet gemmes i cloud-lagring, og ingen uploadkopi hænger — perfekt til “just convert this for me” øjeblikke.

① 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

Udskift format med csv, json, png, xlsx… og du får det format. Én parameter, ét outputformat.

② 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");

Har du brug for et batch-job? Smid dette i en løkke over en mappe, og du får “konverter hele mappen 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());
    }
}

Fire sprog, én handling: giv en sti + en formatparameter → få målfilen tilbage. Det er hele salgsargumentet for Convert API — nul Excel‑afhængighed på kaldersiden, ingen skabeloner, ingen COM‑komponenter.

5. Scenario 2: Konverter en cloud‑lagret fil direkte

Når en fil allerede findes i Aspose Cloud Storage (eller din objektlagring), behøver du ikke at downloade/upload store filer — konverteringen sker i skyen, hvilket minimerer dataoverførsel og forbedrer ydeevnen på store regneark:

# 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"))

Du kan også dykke ned i et enkelt element — f.eks. gengive “the 3rd chart on Sheet1” som PNG (cloud-storage-variant):

# 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

Granulære cloud-endpoints på et overblik:

6. Scenario 3: SaveAs — skriv resultatet tilbage til cloud-lagring

Når du vil have den konverterede fil gemt tilbage i cloud‑lagringen (i stedet for at downloade den), brug PUT /v4.0/cells/{name}/saveas. Det er en naturlig løsning til automatisering såsom “eksporter dagens rapport til PDF for arkivering, hver dag”:

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")

Du kan sende detaljerede gemmeindstillinger gennem SaveOptionsData‑anmodningskroppen og styre outputfilnavn, outputlager, brugerdefinerede skrifttyper, region/locale, adgangskode, osv. via forespørgselsparametre — mere om dem under Ingeniørdetaljer nedenfor.

7. Flere færdiglavede “online konverterings” endpoints

Udover de ovenstående konverteringer på arbejdsbogsniveau, eksponerer controlleren et komplet sæt dedikerede local-file → specific-target endepunkter (samme request-body upload som Scenario 1), som er mere granulære og billigere på båndbredde:

For eksempel, “eksporter kun dette område som CSV til det efterfølgende system”:

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

Disse endpoints bruger det samme upload-i-body-mønster som convert/spreadsheet. I .NET SDK’en har diagram-tilfældene typede wrappers, der kortlægger til disse v4.0-ruter — ConvertChartToImage (convert/chart/image) og ConvertChartToPdf (convert/chart/pdf). worksheet/*, range/* og table/*-varianterne har endnu ingen v4.0-wrapper, så kald dem via almindelig REST præcis som cURL-kommandoen ovenfor gør.

8. Ingeniørdetaljer & fejlhåndtering

Konverteringsmuligheder, der er værd at kende (forespørgselsparametre)

• password — åbne password‑beskyttede regneark;
• fontsLocation / custom-font support — sikre at tegnene er korrekte, når PDF/billeder renderes;
• auto‑tilpas rækker/kolonner, og om man skal udskrive række‑/kolonneoverskrifter (printHeadings), region‑/sideopsætning (region), osv.;
• output‑side: outPath / outStorageName bestemmer, hvor resultatet gemmes i cloud‑lagring.

Fejlkoder (kontrakten som controlleren dokumenterer)

Godkendelse

Alle SDK’er autentificerer automatisk med OAuth 2.0 client_credentials og en JWT; når du bruger rå cURL, skal du først kalde /connect/token én gang (se Scenario 1, ① ovenfor).

9. Hvorfor Aspose.Cells Cloud Convert?

• ✅ Ingen lokale afhængigheder — ingen Office/Excel, ingen COM. Kan kaldes fra ethvert sprog og enhver platform (Linux, containere, serverless);
• ✅ Højpræcis gengivelse — drevet af Aspose.Cells-motoren, så formler, diagrammer, stilarter og sideinddeling gengives i professionel kvalitet til PDF/billeder;
• ✅ Cloud-native — filer kan forblive i skyen under konvertering for at undgå at sende store payloads; ren online‑konvertering kræver overhovedet ingen cloud‑lagring;
• ✅ Fleksibel granularitet — projektmappe / regneark / område / tabel / diagram: konverter præcis den del, du har brug for;
• ✅ Ens form på tværs af SDK’er — cURL-, .NET-, Python- og Java‑eksemplerne svarer 1:1, så du bogstaveligt kan kopiere det mønster, du kan lide.

Kom i gang nu: registrer dig på Aspose Cloud Dashboard, opret en applikation, indsæt dine legitimationsoplysninger i et hvilket som helst snippet ovenfor, og kør den — du vil have din egen “cloud Excel converter” på få minutter.

Fandt du dette nyttigt? Stjernemarkér, bogmærk eller del det — og fortæl os om dine egne regnearks‑konverterings‑brugssager i kommentarerne.