הפוך המרת גיליונות לשורת קוד אחת: מדריך מלא ל‑Aspose.Cells Cloud Convert API (.NET / Python / Java)

אין צורך בהתקנת Excel מקומית. אין צורך לנהל שרת המרות. הפוך XLSX → PDF, Excel → CSV/JSON/תמונות/HTML לקריאות REST פשוטות — והפעל את “ממיר הגליונות האלקטרוניים בענן” הראשון שלך תוך כשלוש דקות.

“המר את הגיליון האלקטרוני לפורמט שונה” הוא אחד הדרישות הנפוצות ביותר בפיתוח היומיומי:

• צוותי הפיננסים והמשפט רוצים דוח 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, and Java.

1. מה תכונת ההמרה יכולה לעשות?

ConversionController הוא הבקר המוקדש ל_המרת פורמט / יצוא_. הוא עוטף את ההמרה ברמת המנוע, בעלת דיוק גבוה, בשלושה סטים של API של HTTP:

הערת יישום: הנתיבים המקוריים משתמשים בקידומת 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 MB רק כדי לתפוס גרף אחד — המר רק את מה שאתה צריך וחסוך ברוחב פס ובחישוב.

2. אילו פורמטים נתמכים?

בהתבסס על רישום ExportData המובנה בבקר, מטריצת ההמרה נראית בערך כך:

בקיצור: המרות spreadsheet-to-spreadsheet מכל סוג, בנוסף לכל משפחת הפלטים של spreadsheet → PDF / image / web-data — הכל מאחורי ממשק API אחד.

3. שני דברים שאתה צריך לפני שאתה מתחיל

1. הירשם לחשבון חינמי ב-Aspose Cloud Dashboard וצור יישום כדי לקבל Client ID ו-Client Secret (ה‑SDKs מחליפים את אלה עבור 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)

זהו PUT /v4.0/cells/convert/spreadsheet — ה‑API הראשי “Convert”: העלה את הקובץ המקומי שלך בגוף הבקשה, השרת ממיר אותו ומשדר את הקובץ החדש חזרה. שום דבר אינו נשמר באחסון ענן ואין עותק העלאה שנשאר — מושלם עבור “just convert this for me” moments.

① 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”.

③ פייתון

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

אתה יכול גם לצלול לתוך אלמנט יחיד — למשל, לייצא “the 3rd chart on Sheet1” כ‑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”

בנוסף להמרות ברמת חוברת העבודה שהוזכרו למעלה, הבקר חושף סט מלא של נקודות קצה ייעודיות קובץ-מקומי → יעד-ספציפי (העלאה של גוף הבקשה זהה לתרחיש 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 למעלה עושה זאת.

8. פרטי הנדסה וטיפול בטעויות

אפשרויות המרה שכדאי לדעת (פרמטרים של שאילתה)

• password — פותח חוברות עבודה המוגנות בסיסמה;
• fontsLocation / תמיכה בגופנים מותאמים — שומר על הצגת הגליפים נכונה בעת רינדור PDF/תמונות;
• התאמה אוטומטית של שורות/עמודות, והאם להדפיס כותרות שורה/עמודה (printHeadings), הגדרת אזור/דף (region), וכדומה;
• צד הפלט: outPath / outStorageName מגדירים היכן התוצאה נשמרת באחסון בענן.

קודי שגיאה (החוזה שהבקר מתעד)

אימות

כל ערכות הפיתוח (SDKs) מאמתות אוטומטית עם OAuth 2.0 client_credentials ו‑JWT; כאשר משתמשים ב‑cURL גולמי, יש לקרוא ל‑/connect/token פעם אחת תחילה (ראו תרחיש 1, ① למעלה).

9. למה Aspose.Cells Cloud Convert?

• ✅ אפס תלות מקומית — ללא Office/Excel, ללא COM. ניתן לקריאה מכל שפה וכל פלטפורמה (Linux, containers, serverless);
• ✅ הצגה באיכות גבוהה — מבוסס על מנוע Aspose.Cells, כך שנוסחאות, תרשימים, סגנונות, והפגנות עימוד מוצגים באיכות מקצועית ל‑PDF/images;
• ✅ מבוסס ענן — קבצים יכולים להישאר בענן במהלך ההמרה כדי למנוע שליחת מטענים גדולים; המרה מקוונת טהורה אינה דורשת אחסון בענן כלל;
• ✅ גרנולריות גמישה — חוברת עבודה / גיליון עבודה / טווח / טבלה / תרשים: המר בדיוק את החלק שאתה צריך;
• ✅ צורה אחידה בין SDKs — הדוגמאות ב‑cURL, .NET, Python ו‑Java ממפות 1:1, כך שאתה יכול פשוט להעתיק את התבנית שאתה אוהב.

התחל עכשיו: הירשם ב- Aspose Cloud Dashboard, צור יישום, הצמד את האישורים שלך לכל קטע קוד למעלה, והפעל אותו — יהיה לך “ממיר Excel בענן” משלך בתוך דקות.

מצאת זאת מועילה? תנו כוכב, סימון, או שתפו זאת — וספרו לנו על מקרי השימוש שלכם בהמרת גיליונות אלקטרוניים בתגובות.