Μετατρέψτε τη μετατροπή φύλλων εργασίας σε μία γραμμή: Ένας πλήρης οδηγός για το Aspose.Cells Cloud Convert API (.NET / Python / Java)

Χωρίς τοπική εγκατάσταση του Excel. Χωρίς διακομιστή μετατροπής για συντήρηση. Μετατρέψτε XLSX → PDF, Excel → CSV/JSON/εικόνες/HTML σε απλές κλήσεις REST — και έχετε τον πρώτο σας «μετατροπέα υπολογιστικών φύλλων στο cloud» σε λειτουργία σε περίπου τρία λεπτά.

“Μετατρέψτε αυτό το υπολογιστικό φύλλο σε διαφορετική μορφή” είναι μία από τις πιο συνηθισμένες απαιτήσεις στην καθημερινή ανάπτυξη:

• Οι ομάδες οικονομικών και νομικών θέλουν μια αναγνώσιμη μόνο για ανάγνωση, ανθεκτική σε παραποίηση PDF αναφορά αντί για ένα .xlsx που μπορεί να επεξεργαστεί οποιοσδήποτε;
• Οι ομάδες δεδομένων χρειάζονται να εξάγουν δομημένα δεδομένα σε downstream συστήματα ως CSV / JSON;
• Οι web και mobile εφαρμογές θέλουν φύλλα εργασίας — και ακόμη γράφημα — να αποδίδονται απευθείας σε PNG / SVG;
• Τα portals θέλουν καθαρά αποσπάσματα HTML / HTML-Table για ενσωμάτωση;
• Κάποιος χρειάζεται να κανονικοποιήσει ένα σωρό αρχείων .xls / .xlsx / .csv / .ods σε μία μορφή.

Οι παλαιές λύσεις — μια τοπική εγκατάσταση του Excel με μακροεντολές ή ένα βαρέως τύπου COM στοιχείο στον δικό σας διακομιστή — είναι δύσκολες στην κλιμάκωση και δύσκολο να παραμείνουν διαπλατφορμικές. Aspose.Cells Cloud αντικαθιστά όλα αυτά με ένα καθαρό REST API: ανεβάστε ένα αρχείο, λάβετε ένα αρχείο νέας μορφής.

Αυτή η ανάρτηση περιηγείται στις τρεις APIs μετατροπής που εκτίθενται από τον πυρήνα ConversionController στην μικροϋπηρεσία Aspose.Cells Cloud (πηγή: src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs), με παραδείγματα εκτέλεσης σε cURL, C# (.NET), Python, and Java.

1. Τι μπορεί να κάνει η λειτουργία Μετατροπής;

ConversionController είναι ο ελεγκτής αφιερωμένος στη μετατροπή μορφής / εξαγωγή. Περιλαμβάνει τη μετατροπή επιπέδου μηχανής υψηλής πιστότητας σε τρία σύνολα HTTP API:

Σημείωση υλοποίησης: οι διαδρομές πηγής χρησιμοποιούν το πρόθεμα v{version}/cells με έκδοση API 4.0, έτσι οι ζωντανές κλήσεις φαίνονται όπως https://api.aspose.cloud/v4.0/cells/....

Η λεπτομέρεια της μετατροπής πηγαίνει πολύ πέρα από το “ολόκληρο αρχείο”

Εκτός από τη μετατροπή ολόκληρου βιβλίου εργασίας, ο ελεγκτής μπορεί να εξάγει ένα μεμονωμένο στοιχείο:

• Ένα συγκεκριμένο φύλλο εργασίας → PDF / image / CSV / JSON / HTML
• Μια συγκεκριμένη περιοχή κελιών (π.χ. A1:C12) → PDF / image / CSV / JSON / HTML
• Ένας συγκεκριμένος πίνακας → PDF / image / CSV / JSON / HTML
• Ένα συγκεκριμένο διάγραμμα → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF

Έτσι δεν χρειάζεται ποτέ να μετατρέψετε ολόκληρο το βιβλίο εργασίας 50 MB μόνο για να πάρετε ένα γράφημα — μετατρέψτε μόνο ό,τι χρειάζεστε και εξοικονομήστε εύρος ζώνης και υπολογιστική ισχύ.

2. Ποια μορφές υποστηρίζονται;

Βάσει του ενσωματωμένου μητρώου ExportData στον ελεγκτή, η μήτρα μετατροπής φαίνεται περίπου ως εξής:

Συνοπτικά: υπολογιστικό-φύλλο-σε-υπολογιστικό-φύλλο μετατροπές κάθε είδους, συν ολόκληρη η οικογένεια των εξόδων υπολογιστικού φύλλου → PDF / εικόνα / web-data — όλα πίσω από μία επιφάνεια API.

3. Δύο πράγματα που χρειάζεστε πριν ξεκινήσετε

1. Εγγραφείτε δωρεάν στο Aspose Cloud Dashboard και δημιουργήστε μια Εφαρμογή για να λάβετε ένα Client ID και ένα Client Secret (τα SDK ανταλλάσσουν αυτά αυτόματα για ένα JWT — δεν χρειάζεται να δημιουργήσετε εσείς τις κεφαλίδες εξουσιοδότησης).
2. Εγκαταστήστε το SDK για τη γλώσσα της επιλογής σας:

<!-- .NET -->
<PackageReference Include="Aspize.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>

Δεν απαιτείται SDK; Όλα είναι απλό REST, έτσι το cURL λειτουργεί εξίσου καλά (δείτε παρακάτω).

4. Σενάριο 1: Μετατροπή τοπικού αρχείου Excel online (ο τίτλος Convert API)

Αυτή είναι PUT /v4.0/cells/convert/spreadsheet — η κορυφαία “Convert” API: ανεβάστε το τοπικό σας αρχείο στο σώμα του αιτήματος, ο διακομιστής το μετατρέπει και μεταδίδει το νέο αρχείο πίσω. Τίποτα δεν αποθηκεύεται σε αποθήκη cloud και δεν παραμένει αντίγραφο μεταφόρτωσης — τέλειο για “απλώς μετατρέψτε αυτό για μένα” στιγμές.

① 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

Αντικαταστήστε το format με csv, json, png, xlsx… και θα λάβετε αυτή τη μορφή. Μία παράμετρος, μία μορφή εξόδου.

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

Χρειάζεστε μια εργασία batch; Τοποθετήστε το σε έναν βρόχο πάνω σε έναν φάκελο και θα έχετε “μετατρέψτε ολόκληρο το φάκελο 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());
    }
}

Τέσσερις γλώσσες, μία ενέργεια: δώστε μια διαδρομή + μια παράμετρο μορφής → λάβετε το αρχείο-στόχο πίσω. Αυτό είναι το κύριο πλεονέκτημα του Convert API — μηδενική εξάρτηση από το Excel στην πλευρά του καλούντος, χωρίς πρότυπα, χωρίς COM components.

5. Σενάριο 2: Μετατροπή αρχείου αποθηκευμένου στο cloud απευθείας

Όταν ένα αρχείο βρίσκεται ήδη στο Aspose Cloud Storage (ή στην αποθήκη αντικειμένων σας), δεν χρειάζεται να κατεβάσετε/ανεβάσετε μεγάλα αρχεία — η μετατροπή γίνεται στο σύννεφο, ελαχιστοποιώντας τη μεταφορά δεδομένων και βελτιώνοντας την απόδοση σε μεγάλα βιβλία εργασίας:

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

Μπορείτε επίσης να εμβαθύνετε σε ένα μόνο στοιχείο — π.χ. αποδώσετε “το 3ο γράφημα στο Sheet1” ως 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

Λεπτομερείς τελικές διευθύνσεις cloud με μια ματιά:

6. Σενάριο 3: SaveAs — γράψτε το αποτέλεσμα πίσω στην αποθήκευση cloud

Όταν θέλετε το μετατρεπόμενο αρχείο αποθηκευμένο ξανά στο cloud storage (αντί για λήψη), χρησιμοποιήστε PUT /v4.0/cells/{name}/saveas. Είναι ιδανικό για αυτοματοποίηση, όπως η «εξαγωγή της σημερινής αναφοράς σε PDF για αρχειοθέτηση, κάθε μέρα»:

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

Μπορείτε να περάσετε λεπτομερείς επιλογές αποθήκευσης μέσω του σώματος του αιτήματος SaveOptionsData, και να ελέγξετε το όνομα του αρχείου εξόδου, την αποθήκευση εξόδου, προσαρμοσμένες γραμματοσειρές, περιοχή/locale, κωδικό πρόσβασης, κ.λ. μέσω παραμέτρων ερωτήματος — περισσότερα για αυτά στο Λεπτομέρειες μηχανικής παρακάτω.

7. Περισσότερα έτοιμα “online convert” endpoints

Εκτός από τις μετατροπές σε επίπεδο βιβλίου εργασίας που αναφέρθηκαν παραπάνω, ο ελεγκτής εκθέτει ένα πλήρες σύνολο αφιερωμένων local-file → specific-target σημείων λήψης (με το ίδιο ανέβασμα σώματος αιτήματος όπως στο Σενάριο 1), που είναι πιο λεπτομερή και φθηνότερα σε εύρος ζώνης:

Για παράδειγμα, “εξαγωγή μόνο αυτού του εύρους ως CSV για το σύστημα downstream”:

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

Αυτά τα endpoints χρησιμοποιούν το ίδιο μοτίβο upload‑in‑the‑body όπως το convert/spreadsheet. Στο .NET SDK οι περιπτώσεις chart έχουν typed wrappers που αντιστοιχούν σε αυτές τις διαδρομές v4.0 — ConvertChartToImage (convert/chart/image) και ConvertChartToPdf (convert/chart/pdf). Οι παραλλαγές worksheet/*, range/* και table/* δεν έχουν ακόμη wrapper v4.0, οπότε καλέστε τις μέσω απλού REST ακριβώς όπως κάνει το cURL παραπάνω.

8. Λεπτομέρειες μηχανικής & διαχείριση σφαλμάτων

Επιλογές μετατροπής που αξίζει να γνωρίζετε (παράμετροι ερωτήματος)

• password — άνοιγμα βιβλίων εργασίας που προστατεύονται με κωδικό πρόσβασης;
• fontsLocation / custom-font support — διατήρηση σωστών γλυφών κατά την απόδοση PDF/εικόνων;
• αυτόματη προσαρμογή γραμμών/στηλών, και αν θα εκτυπωθούν οι επικεφαλίδες γραμμών/στηλών (printHeadings), ρύθμιση περιοχής/σελίδας (region), κ.λπ.;
• πλευρά εξόδου: outPath / outStorageName καθορίζουν πού το αποτέλεσμα αποθηκεύεται στην αποθήκη cloud.

Κωδικοί σφάλματος (η σύμβαση που τεκμηριώνει ο ελεγκτής)

Αυθεντικοποίηση

Όλα τα SDKs πιστοποιούνται αυτόματα με OAuth 2.0 client_credentials και JWT· όταν χρησιμοποιείτε raw cURL, καλέστε το /connect/token μία φορά πρώτα (δείτε το Σενάριο 1, ① παραπάνω).

9. Γιατί Aspose.Cells Cloud Convert?

• ✅ Μηδενικές τοπικές εξαρτήσεις — χωρίς Office/Excel, χωρίς COM. Κλήσιμη από οποιαδήποτε γλώσσα και οποιαδήποτε πλατφόρμα (Linux, containers, serverless);
• ✅ Απόδοση υψηλής πιστότητας — τροφοδοτείται από τη μηχανή Aspose.Cells, έτσι τύποι, διαγράμματα, στυλ και σελιδοποίηση αποδίδουν σε επαγγελματική ποιότητα σε PDF/εικόνες;
• ✅ Cloud-native — τα αρχεία μπορούν να παραμείνουν στο σύννεφο κατά τη μετατροπή για να αποφεύγεται η αποστολή μεγάλων φορτίων· η καθαρή διαδικτυακή μετατροπή δεν χρειάζεται καθόλου αποθήκευση στο σύννεφο;
• ✅ Ευέλικτη λεπτομέρεια — workbook / worksheet / range / table / chart: μετατρέψτε ακριβώς το τμήμα που χρειάζεστε;
• ✅ Μία μορφή σε όλα τα SDK — τα παραδείγματα cURL, .NET, Python και Java αντιστοιχούν 1:1, ώστε μπορείτε κυριολεκτικά να αντιγράψετε το μοτίβο που σας αρέσει.

Ξεκινήστε τώρα: εγγραφείτε στο Aspose Cloud Dashboard, δημιουργήστε μια Εφαρμογή, τοποθετήστε τα διαπιστευτήριά σας σε οποιοδήποτε απόσπασμα παραπάνω και εκτελέστε το — θα έχετε το δικό σας “cloud Excel converter” σε λίγα λεπτά.

Βρήκατε αυτό χρήσιμο; Αστέρι, σελιδοδείκτης ή κοινή χρήση — και πείτε μας για τις δικές σας περιπτώσεις χρήσης μετατροπής υπολογιστικών φύλλων στα σχόλια.