Létrehozás, kezelés, karbantartás: Gyakorlati útmutató az Aspose.Cells Cloud Management API-hoz

Üres munkafüzet létrehozása, egy lap átnevezése, egy túlnagy fájl tömörítése vagy egy sérült fájl javítása – ezek a kis, mindennapi feladatok, amelyek még mindig fejlesztői időt rabolnak, ha nincs a megfelelő eszköz. ManagementController egy sorba sűríti őket.

Minden táblázatkezelő alkalmazás, amely a táblázatokkal dolgozik, végül ugyanazokba a kevésbé vonzó feladatokba ütközik:

• Létrehozás egy új, üres munkafüzetet útközben — néha egy márkás sablonból.
• Munkalapok átrendezése — hozzáadás, átnevezés, törlés, átrendezés — mert az adatok formája tegnap óta megváltozott.
• Fájlméret csökkentése — 40 MB‑os XLSX tömörítése 8 MB‑ra, mielőtt e‑mailben elküldenénk.
• Sérült fájl helyreállítása — azt, amelyet a felhasználó rosszul mentett el, vagy egy eszköz hibásan exportált.
• Struktúra ellenőrzése — kideríteni, mely munkalapok, táblázatok, diagramok és egyesített cellás területek találhatók egy munkafüzetben anélkül, hogy megnyitnánk.

Az ManagementController az Aspose.Cells Cloud mikroservice‑ben (forrás: src/Aspose.Cells.Cloud.MicroService/Controllers/ManagementController.cs) kezeli mindezeket egy tiszta REST felület mögött. Ez a bejegyzés bemutatja a 15 végpontját futtatható cURL példákkal, amelyeket még ma beilleszthetsz a pipeline‑odba.

1. Mit csinál a ManagementController?

ManagementController a vezérlő, amely a munkafüzet életciklus és karbantartás feladatokra van dedikálva. A ConversionController (formátumkonverzió), a DataProcessingController (tömeges egyesítés/felbontás/import) vagy a CellsController (cellaszintű olvasás/írás) ellenkezőjétől eltérően, ez a vezérlő a munkafüzet alak, állapot és metaadatok témájával foglalkozik.

Minden végpont egy munkafüzetet fogad multipart bemenetként (helyi) vagy hivatkozik egy már felhő tárolóban lévőre (távoli), és visszaadja vagy egy módosított munkafüzet adatfolyamot, egy JSON payload-ot, vagy egy egyszerű OK-t.

2. A tizenöt végpont egy pillantásra

Az útvonalak a https://api.aspose.cloud hostot feltételezik. Az élő hívások így néznek ki: https://api.aspose.cloud/v4.0/cells/....

3. Mielőtt elkezdenél: két előfeltétel

1. Szerezze be a hitelesítő adatokat. Regisztráljon a Aspose Cloud Dashboard, hozzon létre egy alkalmazást, szerezze meg a Client ID és a Client Secret értékeket. SDK-k kezelik a JWT cserét Ön helyett; cURL használatával manuálisan cserélheti őket egy bearer tokenre.
2. Telepítsen egy SDK-t — vagy egyszerűen használja a cURL-t. Minden egyszerű REST.

<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

4. Gyors kezdés: új munkafüzet létrehozása

PUT /v4.0/cells/spreadsheet/create a legegyszerűbb dolog, amit a vezérlő végrehajt — és egyben a leghasznosabbak közé tartozik. Egy vadonatúj munkafüzet fájlt ad vissza.

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

Sablon használata

Ha van egy márkázott sablon — logó a fejlécben, márkaszínek a témában, előre formázott “Invoice” táblázat — töltsd fel egyszer a felhő tárolóba, majd add meg az útvonalát template-ként:

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

Most az alkalmazásod képes új, már megfelelően kinéző számlákat létrehozni, anélkül, hogy beágyazná a stíluslogikát.

5. Gyakorlati útmutató: munkalapok kezelése egy munkafüzetben

E négy végpont kezeli egy munkafüzet mindennapi alakját. Nézzük meg egy valósághű sorozatot: feltöltöttél egy munkafüzetet, és szükséged van a lapjainak listázására, egy új hozzáadására, egy meglévő átnevezésére, valamint egy harmadik törlésére.

5a. Munkalapok listázása

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. Új munkalap hozzáadása

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

5c. Munkalap átnevezése

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. Munkalap törlése

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. Munkalap áthelyezése

# 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

Az egyes végpontok ugyanazt a mintát követik: a munkafüzet feltöltése multipart formában, a módosított munkafüzet visszakapása. Láncolja őket a csővezetékében, vagy hívja őket ad‑hoc módon egy felhasználói felületről.

6. Bemutató: egy túlsúlyos munkafüzet tömörítése

Egy felhasználó 40 MB‑os XLSX fájlt küldött e‑mailben, amely 90 %-ban redundáns XML‑t tartalmaz. A PUT /v4.0/cells/spreadsheet/compress összenyomja.

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

A tipikus 40 MB-os munkafüzeten a 9 szint gyakran 6–10 MB tartományba esik. A tartalom azonos; csak az XLSX konténer ZIP tömörítése szigorodik.

7. Lépésről‑lépésre: sérült munkafüzet javítása

Néha olyan fájlt kap, amelyet az Excel nem nyit meg. PUT /v4.0/cells/spreadsheet/repair a motor helyreállítási rutinját futtatja, és egy tiszta verziót ad vissza.

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

Nincs paraméter. A vezérlő újrasorozza a munkafüzetet a motoron keresztül, amely eldobja a sérült részeket, és strukturálisan érvényes fájlt ír. Nem minden sérülés helyreállítható, de ez kezeli a gyakori eseteket — csonkolt ZIP bejegyzések, érvénytelen cellahivatkozások, hibás megosztott karakterláncok.

8. Fő előnyök összefoglalása

• Egy vezérlő az életciklus műveletekhez. Létrehozás, átalakítás, tömörítés, javítás, ellenőrzés — mind egy hitelesítési modell és egy hiba szerződés alatt.
• Sablonérzékeny létrehozás. Ne implementáld újra a stílusokat az alkalmazásodban; hagyd, hogy a szerver egy sablont beágyazzon minden új munkafüzetbe.
• Helyi és távoli változatok. Ugyanaz a logika, függetlenül attól, hogy a fájlok a felhasználó böngészőjében vannak vagy már a felhő tárolóban.
• Struktúra introspekció. A structure végpont egy teljes JSON térképet ad vissza a lapokról, táblázatokról, pivot táblákról, diagramokról és alakzatokról — tökéletes UI vagy validációs folyamat vezérléséhez.
• Nulla infrastruktúra. Nincs Excel telepítés, nincs COM, nincs karbantartandó szerver.