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” kørende på omkring tre minutter.

“Konverter det regneark til et andet format” er et af de mest almindelige krav i den daglige udvikling:

• Finans‑ og juridiske teams ønsker en kun‑læselig, manipulationssikker PDF‑rapport i stedet for en .xlsx, som alle kan redigere;
• Datateams skal hente tabeldata ind i efterfølgende systemer som CSV / JSON;
• Web‑ og mobilapps ønsker regneark — og endda diagrammer — gengivet direkte til PNG / SVG;
• Portaler ønsker rene HTML / HTML‑tabel‑udsnit til indlejring;
• Nogen har brug for at 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 eksponeres af den centrale ConversionController i Aspose.Cells Cloud-mikrotjenesten (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 indpakker 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 controlleren eksportere et enkelt element:

• Et specifikt regneark → PDF / billede / CSV / JSON / HTML
• Et specifikt celleområde (f.eks. A1:C12) → PDF / billede / CSV / JSON / HTML
• Et specifikt tabel → PDF / billede / 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 bare for at hente et diagram — konverter 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: spreadsheet-to-spreadsheet konverteringer af enhver art, plus hele familien af regneark → PDF / billede / web-data output — alt bag én API-overflade.

3. 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 opbygge auth‑headers selv).
2. Installer SDK’en for det sprog, du foretrækker:

<!-- .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: Konvertér 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 der forbliver ingen uploadkopi — perfekt til “bare konverter dette for mig”‑ø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 har “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 — ingen 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 for 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 flavour):

# 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), skal du bruge PUT /v4.0/cells/{name}/saveas. Det er en naturlig løsning til automatisering, såsom “eksporter dagens rapport til PDF til 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 videregive detaljerede gemmeindstillinger gennem SaveOptionsData-anmodningskroppen og kontrollere outputfilnavn, outputlager, brugerdefinerede skrifttyper, region/locale, adgangskode, osv. via forespørgselsparametre — mere om dette under tekniske detaljer nedenfor.

7. Flere færdige “online konverterings” endpoints

Udover de ovenstående konverteringer på arbejdsbogsniveau, eksponerer controlleren et komplet sæt dedikerede local-file → specific-target endpoints (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 nedstrøms 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 slutpunkter bruger det samme upload‑i‑kroppen mønster som convert/spreadsheet. I .NET SDK’en har chart‑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 over ren REST præcis som cURL‑eksemplet ovenfor gør.

8. Ingeniørdetaljer og fejlhåndtering

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

• password — åbne password‑beskyttede arbejdsbøger;
• fontsLocation / custom-font support — sikre at tegnene er korrekte ved rendering af PDF/billeder;
• auto‑tilpasning af rækker/kolonner, og om man skal udskrive række‑/kolonneoverskrifter (printHeadings), region-/sideopsætning (region), osv.;
• output‑side: outPath / outStorageName bestemmer, hvor resultatet placeres 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?

• ✅ Zero local dependencies — ingen Office/Excel, ingen COM. Kan kaldes fra ethvert sprog og enhver platform (Linux, containere, serverløs);
• ✅ High-fidelity rendering — drevet af Aspose.Cells-motoren, så formler, diagrammer, formater og paginering gengives i professionel kvalitet til PDF/images;
• ✅ 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;
• ✅ Flexible granularity — workbook / worksheet / range / table / chart: konverter præcis den del, du har brug for;
• ✅ One shape across SDKs — 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 på Aspose Cloud Dashboard, opret en Application, indsæt dine credentials i et hvilket som helst snippet ovenfor, og kør det — du vil have din egen “cloud Excel‑konverter” på få minutter.

Synes du, dette er nyttigt? Giv en stjerne, bogmærk eller del det — og fortæl os om dine egne regneark‑konverterings‑brugssager i kommentarerne.