יצירה, ניהול, תחזוקה: מדריך פרקטי ל-API לניהול ענן של Aspose.Cells
יצירת חוברת עבודה ריקה, שינוי שם של גיליון, דחיסת קובץ נפוח, או תיקון קובץ פגום — אלו המשימות הקטנות היומיומיות שעדיין גוזלות זמן מהמפתחים כשאין לך את הכלי המתאים.
ManagementControllerהופך אותן לשורות קוד בודדות.
כל יישום שעובד עם גיליונות אלקטרוניים נתקל בסופו של דבר באותן משימות הלא מרהיבות:
- יצירת חוברת עבודה חדשה וריקה בזמן אמת — לעיתים מתבנית ממותגת.
- סידור מחדש של גיליונות — הוספה, שינוי שם, מחיקה, שינוי סדר — מכיוון שהמבנה של הנתונים השתנה מאז אתמול.
- הפחתת גודל קובץ — דחיסת קובץ XLSX של 40 MB ל‑8 MB לפני שליחתו במייל.
- הצלת קובץ פגום — הקובץ שמשתמש שמר בטעות, או כלי שייצא באופן שגוי.
- בדיקת מבנה — זיהוי אילו גיליונות, טבלאות, תרשימים ואזורי תאים ממוזגים קיימים בתוך חוברת העבודה מבלי לפתוח אותה.
ה-ManagementController במיקרו‑שירות Aspose.Cells Cloud (מקור: src/Aspose.Cells.Cloud.MicroService/Controllers/ManagementController.cs) מטפל בכל אלה מאחורי ממשק REST נקי. פוסט זה מציג את 15 נקודות הקצה שלו עם דוגמאות cURL שניתן להריץ ולהדביק בצינור העבודה שלכם כבר היום.
1. מה עושה ManagementController?
ManagementController הוא הבקר המוקדש ל_מחזור החיים של חוברת העבודה והתחזוקה_. בניגוד ל-ConversionController (המרת פורמט), DataProcessingController (מיזוג/פיצול/ייבוא בכמות גדולה), או CellsController (קריאה/כתיבה ברמת התא), בקר זה מתמקד בצורה, בריאות ונתוני מטא של חוברת העבודה עצמה.
| אחריות | נקודות קצה טיפוסיות |
|---|---|
| Create חוברות עבודה, באופן אופציונלי מתבנית | spreadsheet/create |
| Inspect מבנה — גיליונות עבודה, תאים ממוזגים, JSON של המבנה המלא | spreadsheet/worksheets, spreadsheet/mergedcells, spreadsheet/structure, {name}/worksheets/{worksheet}/mergedcells, {name}/structure |
| Modify פריסת גיליון עבודה — הוספה, מחיקה, שינוי שם, העברה | spreadsheet/add/worksheet, spreadsheet/delete/worksheet, spreadsheet/rename/worksheet, spreadsheet/move/worksheet |
| Maintain — דחיסה, תיקון, קבלת תיקונים | spreadsheet/compress, spreadsheet/repair, spreadsheet/accept-all-revisions, {name}/accept-all-revisions |
כל נקודת קצה מקבלת חוברת עבודה כקלט multipart (מקומי) או מתייחסת לאחת שכבר נמצאת באחסון בענן (מרוחק), ומחזירה או זרם חוברת עבודה משוכתב, או מטען JSON, או פשוט OK.
2. חמישה עשר נקודות קצה במבט כולל
| # | HTTP | Route | Source | What it does |
|---|---|---|---|---|
| 1 | PUT | /v4.0/cells/spreadsheet/create |
— | יצירת חוברת עבודה חדשה, באופן אופציונלי מתבנית |
| 2 | PUT | /v4.0/cells/spreadsheet/worksheets |
Local | רשימת כל גיליונות העבודה (שם + סוג) |
| 3 | PUT | /v4.0/cells/spreadsheet/add/worksheet |
Local | הוספת גיליון עבודה עם סוג, שם, מיקום |
| 4 | PUT | /v4.0/cells/spreadsheet/delete/worksheet |
Local | הסרת גיליון עבודה לפי שם |
| 5 | PUT | /v4.0/cells/spreadsheet/rename/worksheet |
Local | שינוי שם של גיליון עבודה |
| 6 | PUT | /v4.0/cells/spreadsheet/move/worksheet |
Local | הזזת גיליון עבודה לאינדקס חדש |
| 7 | PUT | /v4.0/cells/spreadsheet/compress |
Local | דחיסת חוברת העבודה להפחתת הגודל |
| 8 | PUT | /v4.0/cells/spreadsheet/repair |
Local | תיקון חוברת עבודה פגומה |
| 9 | GET | /v4.0/cells/{name}/worksheets/{worksheet}/mergedcells |
Cloud | רשימת אזורי תאים ממוזגים בגיליון עבודה מרוחק |
| 10 | PUT | /v4.0/cells/spreadsheet/mergedcells |
Local | רשימת אזורי תאים ממוזגים בגיליון עבודה מקומי |
| 11 | PUT | /v4.0/cells/spreadsheet/accept-all-revisions |
Local | קבלת כל השינויים המעקביים |
| 12 | PUT | /v4.0/cells/{name}/accept-all-revisions |
Cloud | קבלת כל השינויים המעקביים בקובץ מרוחק |
| 13 | PUT | /v4.0/cells/spreadsheet/structure |
Local | קבלת המבנה המלא כ‑JSON |
| 14 | GET | /v4.0/cells/{name}/structure |
Cloud | קבלת המבנה המלא של קובץ מרוחק כ‑JSON |
| 15 | PUT | /v4.0/cells/spreadsheet/create |
— | (כינוי — ראה #1) |
ההנתיבים מניחים שהמארח הוא
https://api.aspose.cloud. קריאות חיות נראות כךhttps://api.aspose.cloud/v4.0/cells/....
לפני ההתחלה: שני תנאים מוקדמים
- קבל אישורים. הירשם בAspose Cloud Dashboard, צור יישום, קבל
Client IDו-Client Secret. ה-SDKs מטפלים בהחלפת JWT עבורך; עם cURL, אתה מחליף אותם בטוקן נושא באופן ידני. - התקן SDK — או השתמש רק ב-cURL. הכל הוא REST פשוט.
<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />
# Python
pip install asposecellscloud
4. התחלה מהירה: יצירת חוברת עבודה חדשה
PUT /v4.0/cells/spreadsheet/create הוא הדבר הפשוט ביותר שהבקר עושה — ואחד מהשימושיים ביותר. הוא מחזיר קובץ חוברת עבודה חדש לחלוטין.
cURL
# 1) Get a bearer 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) Create an empty XLSX
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/create?format=xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
--output new_workbook.xlsx
| פרמטר | סוג | ברירת מחדל | משמעות |
|---|---|---|---|
format |
string | xlsx |
פורמט קובץ הפלט — xlsx, xlsm, xlsb, ods, וכו'. |
template |
string | null |
נתיב קובץ תבנית אופציונלי. כאשר מסופק, חוברת העבודה החדשה מאותחלת עם תוכן ועיצוב של התבנית. |
שימוש בתבנית
אם יש לך תבנית ממותגת — לוגו בכותרת, צבעי מותג בערכת הנושא, טבלת “Invoice” מעוצבת מראש — העלה אותה פעם אחת לאחסון בענן, ואז העבר את הנתיב שלה כ‑template.
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/create?format=xlsx&template=templates/invoice_branded.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
--output invoice_2026_09_001.xlsx
כעת היישום שלך יכול ליצור חשבוניות חדשות שכבר נראות נכונות, ללא הטמעת לוגיקת עיצוב.
5. מדריך: ניהול גיליונות עבודה בחוברת
ארבעת נקודות הקצה האלה מנהלות את הצורה היומיומית של חוברת עבודה. בואו נעבור על רצף ריאלי: העליתם חוברת עבודה, ואתם צריכים לרשום את הגליונות שלה, להוסיף אחד חדש, לשנות שם של קיים, ולמחוק שלישי.
5a. רשימת גיליונות עבודה
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/worksheets" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: multipart/form-data" \
-F "file=@my_workbook.xlsx"
Response:
[
{ "WorksheetName": "Sheet1", "SheetType": "Worksheet" },
{ "WorksheetName": "Data", "SheetType": "Worksheet" },
{ "WorksheetName": "Chart1", "SheetType": "Chart" }
]
5b. הוסף גיליון עבודה חדש
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/add/worksheet?sheetType=Worksheet&position=1&sheetName=Summary" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@my_workbook.xlsx" \
--output updated.xlsx
| פרמטר | סוג | ברירת מחדל | משמעות |
|---|---|---|---|
sheetType |
string | Worksheet |
סוג הגיליון החדש — Worksheet, Chart, וכו' |
position |
int | end | מיקום באינדקס 0 להוספת הגיליון החדש |
sheetName |
string | auto | שם לתת לגיליון החדש |
5c. שינוי שם גיליון
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName=Sheet1&targetName=Overview" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@my_workbook.xlsx" \
--output updated.xlsx
5d. מחק גיליון עבודה
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/delete/worksheet?sheetName=Chart1" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@my_workbook.xlsx" \
--output updated.xlsx
5e. הזז גיליון עבודה
# Move "Data" to position 0 (front of the workbook)
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/move/worksheet?worksheet=Data&position=0" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@my_workbook.xlsx" \
--output updated.xlsx
כל אחד מנקודות הקצה האלה פועל לפי אותו דפוס: העלאת חוברת עבודה במצב multipart, קבלת חוברת עבודה משוכתבת בחזרה. שרשר אותם בצינור העבודה שלך, או קרא להם באופן ad‑hoc מממשק UI.
6. מדריך: דחיסת חוברת עבודה נפוחה
משתמש שלח לך קובץ XLSX של 40 MB שבו 90 % מה‑XML מיותר. PUT /v4.0/cells/spreadsheet/compress מצמצם אותו.
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/compress?level=9" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@bloated.xlsx" \
--output slim.xlsx
| Parameter | Type | Meaning |
|---|---|---|
level |
int | אגרסיביות הדחיסה. 0 = ללא דחיסה, 9 = מקסימלי. |
רמה של 9 בחוברת עבודה טיפוסית של 40 MB לעתים קרובות מגיעה לטווח של 6–10 MB. התוכן זהה; רק דחיסת ה‑ZIP של מכולת ה‑XLSX מצומצמת.
7. מדריך: תיקון חוברת עבודה פגומה
לפעמים אתה מקבל קובץ ש‑Excel מסרב לפתוח. PUT /v4.0/cells/spreadsheet/repair מריץ את שגרת השחזור של המנוע ומחזיר גרסה נקייה.
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/repair" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@broken.xlsx" \
--output repaired.xlsx
אין פרמטרים. הבקר ממחזיר את חוברת העבודה דרך המנוע, שמסלק חלקים פגומים וכותב קובץ תקין מבחינה מבנית. לא כל הפגמים ניתנים לשחזור, אך זה מטפל במקרים הנפוצים — ערכי ZIP קצרים, הפניות תאים לא חוקיות, מחרוזות משותפות פגומות.
8. סיכום היתרונות המרכזיים
- בקר אחד לפעולות מחזור החיים. צור, ארגן מחדש, דחס, תקן, בחן — הכל תחת מודל אימות אחד וחוזה שגיאות אחד.
- יצירה מודעת לתבנית. אל תיישם מחדש עיצוב באפליקציה שלך; תן לשרת לשלב תבנית בכל חוברת עבודה חדשה.
- גרסאות מקומיות ומרוחקות. אותה לוגיקה בין אם הקבצים בדפדפן של המשתמש שלך או כבר באחסון בענן.
- אינטרוספקציה של מבנה. נקודת הקצה
structureמחזירה מפת JSON מלאה של גיליונות, טבלאות, טבלאות ציר, תרשימים וצורות — מושלם להנעת UI או צינור אימות. - אפס תשתית. אין צורך בהתקנת Excel, אין COM, אין שרת לתחזוקה.