Alakítsd a táblázatkonverziót egyetlen sorra: Teljes útmutató az Aspose.Cells Cloud Convert API-hoz (.NET / Python / Java)

Nincs helyi Excel telepítés. Nincs karbantartandó konverziós szerver. Alakítsd át az XLSX → PDF, Excel → CSV/JSON/képek/HTML formátumokat egyszerű REST hívásokkal — és indítsd el az első „felhő alapú táblázatkonvertered” körülbelül három perc alatt.

“Konvertálja azt a táblázatot egy másik formátumba” az egyik leggyakoribb követelmény a mindennapi fejlesztés során:

• A pénzügyi és jogi csapatok csak olvasható, manipulációálló PDF jelentést szeretnének egy .xlsx helyett, amelyet bárki szerkeszthet;
• Az adatcsapatoknak táblázatos adatokat kell lekérniük a downstream rendszerekbe CSV / JSON formátumban;
• A web- és mobilalkalmazások munkalapokat — sőt diagramokat — szeretnének közvetlenül PNG / SVG formátumba renderelni;
• A portálok tiszta HTML / HTML-Table kódrészleteket akarnak beágyazni;
• Valakinek egy .xls / .xlsx / .csv / .ods fájlhalmot kell egységes formátumba normalizálnia.

A régi módszerek — egy helyi Excel telepítés makrókkal, vagy egy nehéz COM komponens a saját szerveren — nehezen skálázhatók és nehéz őket több platformon fenntartani. Aspose.Cells Cloud lecseréli mindezt egy tiszta REST API-ra: tölts fel egy fájlt, kapj vissza egy új formátumú fájlt.

Ez a bejegyzés áttekinti a három konverziós API-t, amelyet a mag ConversionController biztosít az Aspose.Cells Cloud mikro-szolgáltatásban (forrás: src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs), futtatható példákkal cURL, C# (.NET), Python és Java.

1. Mire képes a Convert funkció?

ConversionController a formátum konverzió / export feladatára dedikált vezérlő. Magas hűségű, motor szintű konverziót csomagol három HTTP API készletbe:

Megvalósítási megjegyzés: a forrás útvonalak a v{version}/cells előtagot használják az 4.0 API‑verzióval, így az élő hívások a https://api.aspose.cloud/v4.0/cells/... formában néznek ki.

A konverzió granularitása jóval túlmutat a “teljes fájl”-on

Az egész munkafüzet átalakítása mellett, a vezérlő képes egy egyes elem exportálni:

• Egy adott munkalap → PDF / image / CSV / JSON / HTML
• Egy adott cellatartomány (például A1:C12) → PDF / image / CSV / JSON / HTML
• Egy adott tábla → PDF / image / CSV / JSON / HTML
• Egy adott diagram → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF

Így soha nem kell egy egész 50 MB‑os munkafüzetet konvertálni csak egy diagram megszerzéséhez — csak azt konvertáld, amire szükséged van, és takaríts meg sávszélességet és számítási erőforrást.

2. Milyen formátumok támogatottak?

A vezérlőben beépített ExportData regisztráció alapján a konverziós mátrix nagyjából így néz ki:

Röviden: spreadsheet-to-spreadsheet konverziók mindenféle típusban, plusz a teljes táblázat → PDF / kép / web‑adat kimenetek családja — mind egyetlen API felületen.

3. Két dolog, amire szükséged van, mielőtt elkezdenél

1. Regisztráljon egy ingyenes fiókot az Aspose Cloud Dashboard oldalon, és hozzon létre egy alkalmazást a Client ID és Client Secret megszerzéséhez (az SDK-k automatikusan cserélik ezeket egy JWT-re — nincs szükség saját hitelesítési fejlécek létrehozására).
2. Telepítse a SDK-t a választott nyelvéhez:

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

Nincs szükség SDK-ra? Minden egyszerű REST, így a cURL is ugyanolyan jól működik (lásd alább).

4. Forgatókönyv 1: Helyi Excel-fájl online konvertálása (a Convert API címsor)

Ez a PUT /v4.0/cells/convert/spreadsheet — a zászlóshajó “Convert” API: töltsd fel a helyi fájlt a kérés törzsében, a szerver átalakítja és visszaadja az új fájlt. Semmi sem marad meg a felhő tárolóban, és nincs feltöltött másolat — tökéletes a “csak konvertáld ezt nekem” pillanatokhoz.

① 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

Cseréld le a format-ot csv, json, png, xlsx… értékekre, és megkapod azt a formátumot. Egy paraméter, egy kimeneti formátum.

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

Szüksége van kötegelt feladatra? Helyezze ezt egy könyvtáron végzett ciklusba, és megkapja a “konvertálja az egész mappát 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());
    }
}

Négy nyelv, egy művelet: adjon meg egy útvonalat + egy formátum paramétert → kapja vissza a célfájlt. Ez a Convert API teljes eladási pontja — nulla Excel függőség a hívó oldalán, nincsenek sablonok, nincsenek COM komponensek.

5. Forgatókönyv 2: Felhőben tárolt fájl közvetlen átalakítása

Ha egy fájl már az Aspose Cloud Storage‑ben (vagy az Ön objektumtárolójában) található, nem kell nagy fájlokat letölteni/feltölteni — a konverzió a felhőben történik, minimalizálva az adatátvitelt és javítva a nagy munkafüzetek teljesítményét:

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

Egyetlen elemre is rá tudsz szűkíteni — például a „Sheet1” 3. diagramját PNG formátumban (felhő-alapú változat) renderelheted:

# 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

Részletes felhő végpontok egy pillantásra:

6. 3. forgatókönyv: SaveAs — az eredmény visszaírása a felhő tárolóba

Amikor a konvertált fájlt vissza a felhő tárolóba mentve (a letöltés helyett) szeretné, használja a PUT /v4.0/cells/{name}/saveas parancsot. Ez természetes megoldás az automatizáláshoz, például a “mai jelentés exportálása PDF-be archiválás céljából, naponta”.

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

Finomhangolt mentési beállításokat adhat át a SaveOptionsData kérés törzsén keresztül, és a lekérdezési paraméterek segítségével szabályozhatja a kimeneti fájl nevét, kimeneti tárolót, egyéni betűtípusokat, régiót/helyi beállítást, jelszót, stb. — további részletek az alábbi Műszaki részletek szakaszban.

7. További kész „online convert” végpontok

A fent említett munkafüzet‑szintű konverziókon felül a vezérlő egy teljes dedikált local-file → specific-target végpontkészletet tesz elérhetővé (ugyanaz a request-body feltöltés, mint Scenario 1), amelyek részletesebbek és kevesebb sávszélességet igényelnek.

Például, „exportálja csak ezt a tartományt CSV‑ként a downstream rendszer számára”:

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

Ezek a végpontok ugyanazt a feltöltés‑a‑kérés‑törzsében mintázatot használják, mint a convert/spreadsheet. A .NET SDK‑ben a chart esetek típusos burkolókkal rendelkeznek, amelyek ezekhez a v4.0 útvonalakhoz térképeződnek — ConvertChartToImage (convert/chart/image) és ConvertChartToPdf (convert/chart/pdf). A worksheet/*, range/* és table/* változatoknak még nincs v4.0 burkolója, ezért hívja őket egyszerű REST‑ként, pontosan úgy, ahogy a fenti cURL is teszi.

8. Mérnöki részletek és hibakezelés

Érdemes tudni a konverziós beállításokat (lekérdezési paraméterek)

• password — jelszóval védett munkafüzetek megnyitása;
• fontsLocation / custom-font support — a glifek helyes megjelenítése PDF/képek renderelésekor;
• automatikus sor/oszlop méretezés, valamint hogy nyomtassa-e a sor/oszlop fejléceket (printHeadings), régió/oldal beállítás (region), stb.;
• kimeneti oldal: outPath / outStorageName határozza meg, hogy a végeredmény hová kerül a felhő tárolóban.

Hibakódok (a vezérlő által dokumentált szerződés)

Hitelesítés

Az összes SDK automatikusan hitelesíti magát az OAuth 2.0 client_credentials és egy JWT segítségével; ha raw cURL‑t használ, először egyszer hívja meg a /connect/token végpontot (lásd az 1. szcenáriót, ① fent).

9. Miért Aspose.Cells Cloud Convert?

• ✅ Zero helyi függőség — nincs Office/Excel, nincs COM. Hívható bármely nyelvből és bármely platformról (Linux, konténerek, serverless);
• ✅ Magas hűségű renderelés — az Aspose.Cells motor által hajtva, így a képletek, diagramok, stílusok és oldaltördelés professzionális minőségben jelennek meg PDF/képek formájában;
• ✅ Felhő-natív — a fájlok a konverzió során a felhőben maradhatnak, elkerülve a nagy adatmennyiség átvitelét; a tiszta online konverziónak egyáltalán nincs szüksége felhő tárolásra;
• ✅ Rugalmas granularitás — munkafüzet / munkalap / tartomány / táblázat / diagram: pontosan azt a részt konvertálja, amire szüksége van;
• ✅ Egyforma szerkezet az SDK-k között — a cURL, .NET, Python és Java példák 1:1 leképeződnek, így szó szerint másolhatja a kedvenc mintáját.

Kezdje el most: regisztráljon a Aspose Cloud Dashboard, hozzon létre egy alkalmazást, helyezze be a hitelesítő adatait bármelyik fenti kódrészletbe, és futtassa — percek alatt saját “felhő Excel konverterrel” rendelkezik.

Hasznosnak találtad? Jelöld csillaggal, könyvjelzőzd vagy oszd meg — és mesélj a saját táblázat‑átalakítási felhasználási eseteidről a megjegyzésekben.