Opret, administrer, vedligehold: En praktisk guide til Aspose.Cells Cloud Management API
At oprette en tom arbejdsbog, omdøbe et ark, komprimere en oppustet fil eller reparere en beskadiget — dette er de små, daglige opgaver, der stadig spiser udviklerens tid, når du ikke har det rette værktøj.
ManagementControllergør dem til en‑linjer.
Alle programmer, der arbejder med regneark, støder på de samme kedelige opgaver efterhånden:
- Oprettelse af en ny, tom projektmappe på farten — nogle gange fra en mærket skabelon.
- Omarrangering af regneark — tilføjelse, omdøbning, sletning, omrokering — fordi dataskemaet har ændret sig siden i går.
- Tæmme filstørrelsen — komprimering af en 40 MB XLSX ned til 8 MB før den sendes via e‑mail.
- Redde en beskadiget fil — den, som en bruger gemte forkert, eller et værktøj eksporterede dårligt.
- Undersøge strukturen — finde ud af hvilke ark, tabeller, diagrammer og sammensatte celleområder der findes i en projektmappe uden at åbne den.
ManagementController i Aspose.Cells Cloud‑mikrotjenesten (kilde: src/Aspose.Cells.Cloud.MicroService/Controllers/ManagementController.cs) håndterer alle disse bag en ren REST‑overflade. Dette indlæg introducerer dens 15 endpoints med kørbare cURL‑eksempler, som du kan indsætte i din pipeline i dag.
1. Hvad gør ManagementController?
ManagementController er controlleren, der er dedikeret til arbejdsbogens livscyklus og vedligeholdelse. I modsætning til ConversionController (formatkonvertering), DataProcessingController (bulk sammensmeltning/opdeling/import), eller CellsController (celle-niveau læs/skriv), handler denne controller om formen, sundheden og metadata for selve arbejdsbogen.
| Ansvar | Typiske slutpunkter |
|---|---|
| Opret regneark, eventuelt fra en skabelon | spreadsheet/create |
| Undersøg struktur — regneark, flettede celler, fuld struktur JSON | spreadsheet/worksheets, spreadsheet/mergedcells, spreadsheet/structure, {name}/worksheets/{worksheet}/mergedcells, {name}/structure |
| Modificer regnearkslayout — tilføj, slet, omdøb, flyt | spreadsheet/add/worksheet, spreadsheet/delete/worksheet, spreadsheet/rename/worksheet, spreadsheet/move/worksheet |
| Vedligehold — komprimer, reparer, accepter revisioner | spreadsheet/compress, spreadsheet/repair, spreadsheet/accept-all-revisions, {name}/accept-all-revisions |
Hvert endpoint tager en arbejdsbog som multipart‑input (lokal) eller refererer til en, der allerede er i cloud‑lager (fjern), og returnerer enten en modificeret arbejdsbog‑stream, en JSON‑payload eller en simpel OK.
2. De femten endepunkter i et overblik
| # | HTTP | Route | Source | Hvad den gør |
|---|---|---|---|---|
| 1 | PUT | /v4.0/cells/spreadsheet/create |
— | Opret en ny projektmappe, eventuelt fra en skabelon |
| 2 | PUT | /v4.0/cells/spreadsheet/worksheets |
Local | Vis alle regneark (navn + type) |
| 3 | PUT | /v4.0/cells/spreadsheet/add/worksheet |
Local | Tilføj et regneark med type, navn, position |
| 4 | PUT | /v4.0/cells/spreadsheet/delete/worksheet |
Local | Fjern et regneark efter navn |
| 5 | PUT | /v4.0/cells/spreadsheet/rename/worksheet |
Local | Omdøb et regneark |
| 6 | PUT | /v4.0/cells/spreadsheet/move/worksheet |
Local | Flyt et regneark til en ny indeksposition |
| 7 | PUT | /v4.0/cells/spreadsheet/compress |
Local | Komprimer projektmappen for at reducere størrelsen |
| 8 | PUT | /v4.0/cells/spreadsheet/repair |
Local | Reparer en beskadiget projektmappe |
| 9 | GET | /v4.0/cells/{name}/worksheets/{worksheet}/mergedcells |
Cloud | Vis sammensatte celleområder i et fjernregneark |
| 10 | PUT | /v4.0/cells/spreadsheet/mergedcells |
Local | Vis sammensatte celleområder i et lokalt regneark |
| 11 | PUT | /v4.0/cells/spreadsheet/accept-all-revisions |
Local | Accepter alle sporede ændringer |
| 12 | PUT | /v4.0/cells/{name}/accept-all-revisions |
Cloud | Accepter alle sporede ændringer i en fjernfil |
| 13 | PUT | /v4.0/cells/spreadsheet/structure |
Local | Hent fuld struktur som JSON |
| 14 | GET | /v4.0/cells/{name}/structure |
Cloud | Hent fuld struktur af en fjernfil som JSON |
| 15 | PUT | /v4.0/cells/spreadsheet/create |
— | (alias — se #1) |
Ruter antager værten
https://api.aspose.cloud. Live‑opkald ser sådan udhttps://api.aspose.cloud/v4.0/cells/....
3. Før du begynder: to forudsætninger
- Få legitimationsoplysninger. Tilmeld dig på Aspose Cloud Dashboard, opret en applikation, og hent
Client IDogClient Secret. SDK’er håndterer JWT‑udvekslingen for dig; med cURL udveksler du dem manuelt for en bearer token. - Installer et SDK — eller brug blot cURL. Alt er ren REST.
<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />
# Python
pip install asposecellscloud
4. Hurtig start: opret en ny arbejdsbog
PUT /v4.0/cells/spreadsheet/create er den simpleste ting, controlleren gør — og en af de mest nyttige. Den returnerer en splinterny arbejdsbogfil.
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
| Parameter | Type | Standard | Betydning |
|---|---|---|---|
format |
string | xlsx |
Outputfilformat — xlsx, xlsm, xlsb, ods, etc. |
template |
string | null |
Valgfri skabelonfilsti. Når den er angivet, initialiseres den nye projektmappe med skabelonens indhold og formatering. |
Brug af en skabelon
Hvis du har en brandet skabelon — logo i headeren, brandfarver i temaet, forudformateret “Invoice”-tabel — upload den én gang til cloud-lagring, og send derefter dens sti som 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
Nu kan din applikation oprette friske fakturaer, der allerede ser korrekte ud, uden at indlejre nogen stylinglogik.
5. Gennemgang: administrer regneark i en projektmappe
Disse fire endpoints håndterer den daglige struktur af en projektmappe. Lad os gå igennem en realistisk sekvens: du har uploadet en projektmappe, og du skal liste dens ark, tilføje et nyt, omdøbe et eksisterende og slette et tredje.
5a. Liste over regneark
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. Tilføj et nyt regneark
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
| Parameter | Type | Standard | Betydning |
|---|---|---|---|
sheetType |
string | Worksheet |
Typen af det nye ark — Worksheet, Chart, osv. |
position |
int | end | 0-indekseret position for at indsætte det nye ark |
sheetName |
string | auto | Navn, der skal gives til det nye ark |
5c. Omdøb et regneark
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. Slet et regneark
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. Flyt et regneark
# 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
Hver af disse endpoints følger det samme mønster: upload regneark i multipart, få det modificerede regneark tilbage. Kæd dem sammen i din pipeline, eller kald dem ad‑hoc fra en UI.
6. Gennemgang: komprimer en overfyldt projektmappe
En bruger e‑mailede dig en 40 MB XLSX, der er 90 % overflødig XML. PUT /v4.0/cells/spreadsheet/compress komprimerer den.
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 | Betydning |
|---|---|---|
level |
int | Komprimeringsaggressivitet. 0 = ingen komprimering, 9 = maksimal. |
Et niveau på 9 i en typisk 40 MB projektmappe resulterer ofte i området 6–10 MB. Indholdet er identisk; kun ZIP‑komprimeringen af XLSX‑containeren er strammet.
7. Gennemgang: reparer en beskadiget projektmappe
Nogle gange modtager du en fil, som Excel nægter at åbne. PUT /v4.0/cells/spreadsheet/repair kører motorens gendannelsesrutine og returnerer en ren version.
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
Ingen parametre. Controlleren genserialiserer projektmappen gennem motoren, som kasserer korrupte dele og skriver en strukturelt gyldig fil. Ikke al korruption er genoprettelig, men dette håndterer de almindelige tilfælde — afkortede ZIP-poster, ugyldige cellehenvisninger, fejlformede delte strenge.
8. Opsummering af nøglefordele
- Én controller til livscyklus‑operationer. Opret, omstrukturér, komprimer, reparer, inspicér — alt under én godkendelsesmodel og én fejlkontrakt.
- Skabelon‑bevidst oprettelse. Genskab ikke styling i din app; lad serveren indlejre en skabelon i hver ny arbejdsbog.
- Lokale og fjern‑varianter. Samme logik, uanset om filerne er i brugerens browser eller allerede i cloud‑lagring.
- Struktur‑introspektion.
structure‑endpointet returnerer et komplet JSON‑kort over ark, tabeller, pivottabeller, diagrammer og former — perfekt til at drive en UI eller en validerings‑pipeline. - Ingen infrastruktur. Ingen Excel‑installation, ingen COM, ingen server at vedligeholde.