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

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

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

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

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

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

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

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 στον ελεγκτή, ο πίνακας μετατροπής φαίνεται περίπου έτσι:

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

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

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

2. Εγκαταστήστε το SDK για τη γλώσσα της επιλογής σας:

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

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

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

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

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

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

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

Μπορείτε επίσης να εμβαθύνετε σε ένα μόνο στοιχείο — π.χ. αποδώστε “the 3rd chart on 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 και να ελέγξετε το όνομα αρχείου εξόδου, την αποθήκευση εξόδου, τις προσαρμοσμένες γραμματοσειρές, την περιοχή/γλώσσα, τον κωδικό πρόσβασης, κ.λπ. μέσω παραμέτρων ερωτήματος — περισσότερα για αυτά στα Λεπτομέρειες μηχανικής παρακάτω.

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 έχουν τυποποιημένους περιτυλίγματα που αντιστοιχούν σε αυτές τις διαδρομές v4.0 — ConvertChartToImage (convert/chart/image) και ConvertChartToPdf (convert/chart/pdf). Οι παραλλαγές worksheet/*, range/* και table/* δεν έχουν ακόμη περιτύλιγμα v4.0, οπότε καλέστε τις μέσω απλού REST ακριβώς όπως κάνει το cURL παραπάνω.

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

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

• password — άνοιγμα βιβλίων εργασίας με προστασία κωδικού;
• fontsLocation / custom-font support — διατήρηση σωστών γλύφων κατά την απόδοση PDF/εικόνων;
• auto-fit rows/columns, and whether to print row/column headings (printHeadings), region/page setup (region), etc.; — αυτόματη προσαρμογή γραμμών/στηλών, και αν θα εκτυπωθούν οι επικεφαλίδες γραμμών/στηλών (printHeadings), ρύθμιση περιοχής/σελίδας (region), κ.λπ.;
• output side: outPath / outStorageName decide where the result lands in cloud storage. — πλευρά εξόδου: 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 — τα αρχεία μπορούν να παραμείνουν στο cloud κατά τη μετατροπή για να αποφεύγεται η αποστολή μεγάλων φορτίων· η καθαρή διαδικτυακή μετατροπή δεν απαιτεί καθόλου αποθήκευση στο cloud;
• ✅ Ευέλικτη λεπτομέρεια — βιβλίο εργασίας / φύλλο εργασίας / περιοχή / πίνακας / διάγραμμα: μετατρέψτε ακριβώς το τμήμα που χρειάζεστε;
• ✅ Μία μορφή σε όλα τα SDKs — τα παραδείγματα cURL, .NET, Python και Java αντιστοιχούν 1:1, ώστε να μπορείτε κυριολεκτικά να αντιγράψετε το μοτίβο που σας αρέσει.

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

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