გადაიტანეთ ცხრილების კონვერტირება ერთ-ხაზიანად: სრულყოფილი გიდი Aspose.Cells Cloud Convert API-სთვის (.NET / Python / Java)

ლოკალური Excel-ის ინსტალაცია არ არის. კონვერსიის სერვერის შენარჩუნება არ არის საჭირო. გადაიტანეთ XLSX → PDF, Excel → CSV/JSON/გამოსახულებები/HTML მარტივი REST მოთხოვნებით — და მიიღეთ თქვენი პირველი “ღრუბლოვანი ცხრილების კონვერტორი” დაახლოებით სამი წუთის განმავლობაში.

“Convert that spreadsheet to a different format” არის ერთ-ერთი ყველაზე გავრცელებული მოთხოვნა ყოველდღიურ განვითარებაში:

• ფინანსურ და სამართლებრივ გუნდებს სჭირდება მხოლოდ-კითხვის, მანიპულაციაზე არ-მგრძნობიარე PDF ანგარიში, ნაცვლად .xlsx-ის, რომელსაც ყველას შეუძლია რედაქტირება;
• მონაცემთა გუნდებს საჭიროა ცხრილური მონაცემების გადმოტანა ქვედანადგურ სისტემებში როგორც CSV / JSON;
• ვებ- და მობილური აპლიკაციებს სჭირდებათ სამუშაო ფურცლები — და нават დიაგრამები — პირდაპირ PNG / SVG ფორმატში გადამუშავებული;
• პორტალებს სჭირდებათ სუფთა 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
• სპეციფიკური უჯრედის დიაპაზონი (e.g. A1:C12) → PDF / image / CSV / JSON / HTML
• სპეციფიკური ცხრილი → PDF / image / CSV / JSON / HTML
• სპეციფიკური დიაგრამა → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF

ასე რომ, თქვენ არასოდეს მოგიწევთ მთელი 50 მბ სამუშაო წიგნის გადაყვანა, უბრალოდ ერთი გრაფიკის დასამოღებლად — გადაყვანეთ მხოლოდ ის, რაც გჭირდებათ, და დაზოგეთ ქსელის გამტარუნარიანობა და გამოთვლები.

2. რომელი ფორმატებია მხარდაჭერილი?

კონტროლერში არსებული შიდა ExportData რეგისტრის მიხედვით, გადაყვანის მატრიცა დაახლოებით ასე გამოიყურება:

მოკლედ: spreadsheet-to-spreadsheet ყველა ტიპის კონვერსია, და მთელი ოჯახი ელცხრილის → PDF / გამოსახულება / ვებ-მონაცემის გამომუშავება — ყველა ერთ 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 ფაილის ონლაინ კონვერტირება (სათაური Convert API)

This is PUT /v4.0/cells/convert/spreadsheet — მთავარი “Convert” API: ატვირთეთ თქვენი ლოკალური ფაილი მოთხოვნის სხეულში, სერვერი მას გარდაქმნის და ახალი ფაილი უკან აუმუშავებს. არაფერი შენახულია ღრუბლოვან საცავში და ატვირთული ასლი არ დარჩება — იდეალურია “just convert this for me” მომენტებისთვის.

① 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: ღრუბლში შენახული ფაილის პირდაპირ გადაყვანა

როდესაც ფაილი უკვე მდებარეობს 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"))

თქვენ ასევე შეგიძლიათ ერთ ელემენტზე დეტალურად გადახედვა — მაგალითად, “Sheet1-ის 3-ე დიაგრამის” რენდერი PNG (ღრუბლოვანი-საცავის ვარიანტი):

# 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

მიზუსტის მქონე ღრუბლოვანი საბოლოო წერტილები ერთ ნახვით:

6. სცენარი 3: SaveAs — შედეგის შენახვა ღრუბლოვან საცავში

როცა გინდათ გადაყვანილი ფაილი მიმაგრებული იყოს ღრუბლურ საცავში (ისინი გადმოწერილის ნაცვლად), გამოიყენეთ 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” საბოლოო წერტილები

ზემოთ აღნიშნული სამუშაო წიგნის დონეზე კონვერსიების გარდა, კონტროლერი აჩვენებს სრულ ნაკრებს განკუთვნული local-file → specific-target საბოლოო წერტილების (იგივე მოთხოვნის სხეულის ატვირთვა როგორც სცენარი 1), რომლებიც უფრო დეტალურია და ნაკლები ბანდვიდის მოხმარებითა არის:

მაგალითად, “ექსპორტირება მხოლოდ ამ დიაპაზონს CSV ფორმატში ქვედა სისტემისთვის”:

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

ეს საბოლოო წერტილები იყენებენ იგივე ატვირთვის-ტილში შაბლონს, როგორც convert/spreadsheet. .NET SDK-ში chart შემთხვევებს აქვთ ტიპიზირებული გადამტანი, რომელიც ასახავს ამ v4.0 გზებს — ConvertChartToImage (convert/chart/image) და ConvertChartToPdf (convert/chart/pdf). worksheet/*, range/* და table/* ვარიანტებს ჯერ არ აქვთ v4.0 გადამტანი, ამიტომ გადმოძახეთ ისინი ჩვეულებრივი REST‑ით ზუსტად ისე, როგორც ზემოთ მოცემული cURL აკეთებს.

ინჟინერიული დეტალები & შეცდომის დამუშავება

გარდაქმნის პარამეტრები, რომლებიც ღირს იცოდეთ (მოთხოვნის პარამეტრები)

• password — პაროლით დაცული სამუშაო წიგნების გახსნა;
• fontsLocation / custom-font მხარდაჭერა — გლიფების სწორობა PDF/გამოსახულებების რენდერისას;
• რიგებისა/სვეტების ავტომატური ზომის დაყენება, და თუ უნდა ბეჭდოთ რიგის/სვეტის სათაურები (printHeadings), რეგიონის/გვერდის პარამეტრები (region), ა.შ.;
• გამოტანის მხარე: outPath / outStorageName განსაზღვრავს, სად მდებარეობს შედეგი ღრუბლოვან შენახვაში.

შეცდომის კოდები (კონტროლერის დოკუმენტირებული კონტრაქტი)

ავთენტიკაცია

ყველა SDK ავტომატურად აუტენტიფიკაციას აკეთებს OAuth 2.0 client_credentials და JWT-ით; raw cURL-ის გამოყენებისას, პირველ რიგში გამოიძახეთ /connect/token (იხილეთ სცენარი 1, ① ზემოთ).

9. რატომ Aspose.Cells Cloud Convert?

• ✅ ლოკალური დამოკიდებულებები არ არსებობს — Office/Excel-ის გარეშე, COM-ის გარეშე. შეიძლება გამოძახება ნებისმიერი ენისა და ნებისმიერი პლატფორმისგან (Linux, კონტეინერები, სერვერლესი);
• ✅ მაღალი სიზუსტის რენდერი — მუშაობს Aspose.Cells ძრავით, ამიტომ ფორმულები, გრაფიკები, სტილები და პაგინაცია პროფესიონალური ხარისხით რენდერდება PDF/სურათებში;
• ✅ ღრუბლოვანი-ნატივი — ფაილები შეიძლება დარჩნენ ღრუბლში გადაყვანისას, რათა თავიდან აირიდოთ დიდი დატვირთვების გადაცემა; სუფთა ონლაინ გადაყვანა ღრუბლური შენახვა არ საჭიროებს;
• ✅ მოქნილი გრადუსირება — სამუშაო წიგნი / სამუშაო ფურცელი / შუალედი / ცხრილი / გრაფიკი: გადაყვანა ზუსტად იმ ნაწილის, რომელიც გჭირდებათ;
• ✅ ერთიანი ფორმა SDK-ებში — cURL, .NET, Python და Java მაგალითები 1:1 მიბმულია, ასე რომ შეგიძლიათ პირდაპირ დაკოპიროთ თქვენთვის სასურველი შაბლონი.

დაიწყეთ ახლავე: რეგისტრირდით Aspose Cloud Dashboard-ზე, შექმენით აპლიკაცია, ჩასვით თქვენი ავტორიზაციის დეტალები რომელიმე ზემოთ მოცემულ სნიპეტში და გაუშვით — რამდენიმე წუთში მიიღებთ თქვენს საკუთარი “cloud Excel converter”-ს.

მოგეწონა? დასვით ვარსკვლავი, დაამატეთ სანიშნე, ან გააზიარეთ — და გვაცნობეთ თქვენი საკუთარი ცხრილების გადაყვანის გამოყენების შემთხვევები კომენტარებში.