> אין צורך בהתקנת Excel מקומית. אין שרת המרה לתחזק. הפוך XLSX → PDF, Excel → CSV/JSON/תמונות/HTML לשיחות REST פשוטות — ותהיה לך את “המרת גיליונות העבודה בענן” הראשונה שלך פועלת תוך כשלוש דקות. “המר את גיליון העבודה לפורמט שונה” היא אחת הדרישות הנפוצות ביותר בפיתוח יומיומי: - צוותי כספים ומשפטים רוצים דוח קריא בלבד, חסין מניפולציות PDF במקום קובץ .xlsx שכל אחד יכול לערוך; - צוותי נתונים צריכים למשוך נתונים טבלאיים למערכות downstream כ- CSV / JSON; - אפליקציות אינטרנט ומובייל רוצות גיליונות עבודה — ואפילו תרשימים — מוקרנים ישירות ל- PNG / SVG; - פורטלים רוצים קטעי HTML / HTML-Table נקיים להטמעה; - מישהו צריך לנרמל ערימה של קבצי .xls / .xlsx / .csv / .ods לפורמט אחד. התשובות הישנות — התקנת Excel מקומית עם מקרואים, או רכיב COM כבד על השרת שלך — כואבות להרחבה וקשות לשמור על פלטפורמות שונות. Aspose.Cells Cloud מחליף את כל זה עם REST API טהור: העלה קובץ, קבל קובץ בפורמט חדש חזרה. פוסט זה עובר על שלוש ה- APIs להמרה המוצגות על ידי ה- ConversionController בליבת שירות המיקרו של Aspose.Cells (מקור: src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs), עם דוגמאות שניתן להריץ ב- cURL, C# (.NET), Python ו- Java. — ## 1. מה יכול תכונת ההמרה לעשות? ConversionController הוא הבקר המוקדש ל- המרה / ייצוא פורמטים. הוא עוטף את ההמרה ברמת המנוע, באיכות גבוהה לשלוש קבוצות של APIs HTTP: | # | תסריט | Endpoint טיפוסי | מה זה עושה | | — | ———————————————————– | ———————————————— | —————————————————————————————————————————- | | 1 | קובץ כבר באחסון הענן → הורד פורמט חדש | GET /v4.0/cells/{name}?format=pdf | ממיר חוברת עבודה ישירות באחסון הענן ומזרים את התוצאה חזרה — קבצים גדולים לא צריכים לעבור למכונה שלך | | 2 | קובץ מקומי → המרה מקוונת (תכונה בולטת) | PUT /v4.0/cells/convert/spreadsheet?format=pdf | אתה מעלה את הקובץ בגוף הבקשה (multipart); השרת ממיר אותו ומחזיר את קובץ התוצאה ישירות | | 3 | קובץ בענן → שמור כפורמט חדש, חזרה לאחסון הענן | PUT /v4.0/cells/{name}/saveas?format=pdf | הקובץ המומר נכתב ישירות חזרה לאחסון הענן — אידיאלי עבור צינורות אוטומטיים | > הערת יישום: המסלולים המקוריים משתמשים בהקדמה v{version}/cells עם גרסת API 4.0, כך שקריאות חיות נראות כמו https://api.aspose.cloud/v4.0/cells/.... ### הגרנולריות של ההמרה עולה הרבה מעבר ל"כל הקובץ" בנוסף להמרת חוברת עבודה שלמה, הבקר יכול לייצא אלמנט אחד: - גיליון עבודה ספציפי → PDF / תמונה / CSV / JSON / HTML - טווח תאים ספציפי (למשל A1:C12) → PDF / תמונה / CSV / JSON / HTML - טבלה ספציפית → PDF / תמונה / CSV / JSON / HTML - תרשים ספציפי → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF כך שאתה אף פעם לא צריך להמיר חוברת עבודה של 50 MB רק כדי לתפוס תרשים אחד — המר רק מה שאתה צריך וחסוך רוחב פס ומחשב. — ## 2. אילו פורמטים נתמכים? בהתבסס על רישום ה- ExportData המובנה בבקר, מטריצת ההמרה נראית בערך כך: | סוג | פורמטים | | —————————————— | ———————————————————————————————————————- | | ייבוא ו- ייצוא (דו-כיווני) | XLS, XLSX, XLSB, XLSM, CSV, TSV, ODS, TXT | | ייצוא בלבד | PDF, OTS, XPS, DIF, HTML / MHTML, JSON, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS, Markdown, DOCX, PPTX, SQL וכו’ | בקצרה: המרות גיליון עבודה לגיליון עבודה מכל סוג, בנוסף לכל משפחת הפלטים של גיליון עבודה → PDF / תמונה / נתוני אינטרנט — הכל מאחורי ממשק API אחד. — ## 3. שני דברים שאתה צריך לפני שאתה מתחיל 1. הירשם לחשבון חינם ב- Aspose Cloud Dashboard וצור אפליקציה כדי לקבל Client ID ו- Client Secret (ה- SDKs מחליפים את אלה עבור JWT באופן אוטומטי — אין צורך לבנות כותרות auth בעצמך). 2. התקן את ה- SDK לשפה המועדפת עליך: xml <!-- .NET --> <PackageReference Include="Aspose.Cells-Cloud" Version="25.x" /> bash # Python pip install asposecellscloud xml <!-- Java (Maven) — שים לב: לא במרכז Maven, כך שהמאגר של Aspose למטה נדרש --> <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 מקומי מקוון (ה- API להמרה הבולט) זהו PUT /v4.0/cells/convert/spreadsheet — ה- API הדגל “המרה”: העלה את הקובץ המקומי שלך בגוף הבקשה, השרת ממיר אותו ומזרים את קובץ החדש חזרה. שום דבר לא נשמר באחסון הענן ואין עותק העלאה נשאר — מושלם עבור רגעים של “פשוט המרת את זה בשבילי”. ### ① cURL bash # 1) קודם כל, קבל אסימון 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 csharp 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", // נתיב קובץ מקומי format: "pdf"); // יעד: pdf / csv / json / png ... using Stream result = cellsApi.ConvertSpreadsheet(request); // זרם קובץ המומר using var outFile = File.Create("C:/invoices/Book1.pdf"); result.CopyTo(outFile); // אפילו פשוט יותר: הפנה את ה- SDK לנתיב פלט ותן לו לכתוב את הקובץ // cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf"); > צריך עבודה קבוצתית? שים את זה בלולאה על תיקייה ויש לך “המר את כל תיקיית XLSX → PDF”. ### ③ Python python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ConvertSpreadsheetRequest import os instance = CellsApi( os.getenv('CellsCloudClientId'), os.getenv('CellsCloudClientSecret')) # XLSX מקומי -> PDF, התוצאה נכתבת מקומית instance.convert_spreadsheet( ConvertSpreadsheetRequest("Book1.xlsx", "pdf"), local_outpath="Book1.pdf") # פורמטים אחרים: פשוט שנה את הפרמטר — json / csv / xlsx / png ... ### ④ Java 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"); // נתיב קובץ מקומי req.setFormat("pdf"); // יעד: pdf / csv / json / png ... File out = api.convertSpreadsheet(req); // תוצאה המומרת כקובץ out.renameTo(new File("C:/invoices/Book1.pdf")); System.out.println("המומר: " + out.getAbsolutePath()); } } ארבע שפות, פעולה אחת: תן נתיב + פרמטר פורמט → קבל את קובץ היעד חזרה. זהו כל הנקודה של API ההמרה — אפס תלות ב- Excel בצד הקורא, ללא תבניות, ללא רכיבי COM. — ## 5. תסריט 2: המרת קובץ מאוחסן בענן ישירות כאשר קובץ כבר נמצא באחסון הענן של Aspose (או אחסון האובייקטים שלך), אינך צריך להוריד/להעלות קבצים גדולים — ההמרה מתבצעת בענן, מה שממזער את העברת הנתונים ומשפר את הביצועים על חוברות עבודה גדולות: bash # cloud Book1.xlsx -> PDF, הורד מקומית 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 python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ExportSpreadsheetAsFormatRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") # המרת חוברת עבודה מאוחסנת בענן ישירות ל- PDF instance.export_spreadsheet_as_format( ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports")) אתה יכול גם לחפור לתוך אלמנט אחד — למשל, להציג “את התרשים ה-3 על Sheet1” כ- PNG (גרסת אחסון בענן): bash # תרשים -> 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 נקודות קצה גרנולריות בענן במבט חטוף: | יעד | Endpoint | דוגמת format | | —————- | ——————————————————- | —————————– | | חוברת עבודה שלמה| GET /v4.0/cells/{name} | pdf / xlsx / csv / json | | גיליון עבודה אחד| GET /v4.0/cells/{name}/worksheets/{ws} | pdf / png / svg | | טווח אחד | GET /v4.0/cells/{name}/worksheets/{ws}/ranges/{range} | pdf / csv / json / html / png | | טבלה אחת | GET /v4.0/cells/{name}/worksheets/{ws}/tables/{table} | pdf / csv / json / html / png | | תרשים אחד | GET /v4.0/cells/{name}/worksheets/{ws}/charts/{index} | pdf / png / jpeg / svg / tiff | — ## 6. תסריט 3: SaveAs — כתוב את התוצאה חזרה לאחסון הענן כאשר אתה רוצה שהקובץ המומר יישמר חזרה לאחסון הענן (במקום להוריד), השתמש ב- PUT /v4.0/cells/{name}/saveas. זהו התאמה טבעית לאוטומציה כמו “ייצא את דוח היום ל- PDF לארכיון, כל יום”: bash 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 '{}' python 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")) # התוצאה נשמרת ישירות באחסון הענן; מחזירה CellsCloudResponse(Code=200, Status="OK") אתה יכול להעביר אפשרויות שמירה מדויקות דרך גוף הבקשה SaveOptionsData, ולשלוט על שם קובץ הפלט, אחסון פלט, גופנים מותאמים אישית, אזור/שפה, סיסמה, וכו’ באמצעות פרמטרי השאילתה — עוד על כך תחת פרטי הנדסה למטה. — ## 7. עוד נקודות קצה “המרה מקוונת” מוכנות בנוסף להמרות ברמת חוברת העבודה למעלה, הבקר מציע סט מלא של קובץ מקומי → יעד ספציפי נקודות קצה (אותו גוף בקשה העלאה כמו בתסריט 1), שהן יותר גרנולריות וזולות על רוחב הפס: | מטרה | Endpoint (PUT, הקדמה /v4.0/cells/convert/) | | ———————————————— | ——————————————————————————————————– | | חוברת עבודה → PDF / JSON / CSV | spreadsheet/pdf, spreadsheet/json, spreadsheet/csv | | גיליון עבודה → PDF / JSON / CSV / HTML / HTML-Table | worksheet/pdf, worksheet/json, worksheet/csv, worksheet/html, worksheet/html-table | | גיליון עבודה → תמונה | worksheet/image?worksheet=Sheet1&format=png | | טווח → PDF / CSV / HTML / JSON / תמונה | range/pdf, range/csv, range/html, range/json, range/image?worksheet=..&range=A1:C12&format=png | | טבלה → PDF / CSV / HTML / JSON / תמונה | table/pdf, table/csv, table/html, table/json, table/image | | תרשים → תמונה / PDF | chart/image?worksheet=..&chartIndex=0&format=png, chart/pdf | למשל, “ייצא רק את הטווח הזה כ- CSV עבור המערכת downstream”: bash 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 המקרים של תרשים כוללים עטיפות טיפוסיות שמתאימות למסלולים הללו ב- 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 קובעים היכן התוצאה נוחתת באחסון הענן. ### קודי שגיאה (החוזה שהבקר מתעד) | סטטוס | משמעות | סיבת שגיאה טיפוסית | | ——- | ———— | ———————————————————– | | 400 | בקשה רעה | URL / פרמטרים לא חוקיים, או פורמט format לא נתמך | | 401 | לא מורשה | האותנטיקציה נכשלה או לא הועברו אישורים תקפים | | 404 | לא נמצא | קובץ המקור אינו נגיש באחסון הענן | | 500 | שגיאת שרת | השירות פגע בתופעה בזמן קבלת נתוני ההמרה | ### אותנטיקציה כל ה- SDKs מאמתים אוטומטית עם OAuth 2.0 client_credentials ו- JWT; כאשר משתמשים ב- cURL גולמי, קרא ל- /connect/token פעם אחת קודם (ראה תסריט 1, ① למעלה). — ## 9. למה Aspose.Cells Cloud Convert? - ✅ אפס תלות מקומית — לא Office/Excel, לא COM. ניתן לקרוא מכל שפה וכל פלטפורמה (Linux, קונטיינרים, ללא שרת); - ✅ רינדור באיכות גבוהה — מופעל על ידי מנוע Aspose.Cells, כך שנוסחאות, תרשימים, סגנונות ודפים רנדרים באיכות מקצועית ל- PDF/תמונות; - ✅ מקורי לענן — קבצים יכולים להישאר בענן במהלך ההמרה כדי להימנע מהעברת מטענים גדולים; המרה מקוונת טהורה אינה זקוקה לאחסון בענן בכלל; - ✅ גרנולריות גמישה — חוברת עבודה / גיליון עבודה / טווח / טבלה / תרשים: המרת בדיוק את החלק שאתה צריך; - ✅ צורת אחת בין SDKs — דוגמאות cURL, .NET, Python ו- Java מתאימות 1:1, כך שאתה יכול פשוט להעתיק את התבנית שאתה אוהב. התחל עכשיו: הירשם ב- Aspose Cloud Dashboard, צור אפליקציה, הכנס את האישורים שלך לכל קטע למעלה, והרץ אותו — תהיה לך “המרת Excel בענן” משלך בתוך דקות. מצא את זה מועיל? תן כוכב, שמור או שתף את זה — וספר לנו על מקרי השימוש שלך בהמרת גיליונות עבודה בתגובות.