Tạo, Quản lý, Bảo trì: Hướng dẫn thực tế về API Quản lý Aspose.Cells Cloud

Tạo một workbook trống, đổi tên một sheet, nén một tệp phình to, hoặc sửa chữa một tệp bị hỏng — đây là những công việc nhỏ, hàng ngày vẫn tiêu tốn thời gian của nhà phát triển khi bạn không có công cụ phù hợp. ManagementController biến chúng thành các dòng lệnh ngắn gọn.

Mỗi ứng dụng làm việc với bảng tính cuối cùng cũng sẽ gặp phải những nhiệm vụ không hấp dẫn giống nhau:

  • Tạo một workbook mới, trống ngay lập tức — đôi khi từ một mẫu có thương hiệu.
  • Sắp xếp lại các worksheet — thêm, đổi tên, xóa, sắp xếp lại — vì cấu trúc dữ liệu đã thay đổi so với hôm qua.
  • Kiểm soát kích thước tệp — nén một file XLSX 40 MB xuống còn 8 MB trước khi gửi email.
  • Khôi phục tệp bị hỏng — tệp mà người dùng lưu sai, hoặc công cụ xuất ra không đúng.
  • Kiểm tra cấu trúc — xác định các sheet, bảng, biểu đồ và vùng ô đã hợp nhất nằm trong workbook mà không cần mở nó.

The ManagementController trong microservice Aspose.Cells Cloud (nguồn: src/Aspose.Cells.Cloud.MicroService/Controllers/ManagementController.cs) xử lý tất cả các chức năng này phía sau một giao diện REST sạch sẽ. Bài viết này giới thiệu 15 endpoint của nó kèm theo các ví dụ cURL có thể chạy được mà bạn có thể dán vào pipeline của mình ngay hôm nay.

1. ManagementController làm gì?

ManagementController là bộ điều khiển chuyên trách cho vòng đời và công việc bảo trì của workbook. Không giống như ConversionController (chuyển đổi định dạng), DataProcessingController (hợp nhất/ tách/ nhập hàng loạt), hoặc CellsController (đọc/ghi ở mức ô), bộ điều khiển này liên quan đến hình dạng, sức khỏe và siêu dữ liệu của chính workbook.

Trách nhiệm Các endpoint điển hình
Tạo workbook, tùy chọn từ mẫu spreadsheet/create
Kiểm tra cấu trúc — worksheets, merged cells, full structure JSON spreadsheet/worksheets, spreadsheet/mergedcells, spreadsheet/structure, {name}/worksheets/{worksheet}/mergedcells, {name}/structure
Sửa đổi bố cục worksheet — add, delete, rename, move spreadsheet/add/worksheet, spreadsheet/delete/worksheet, spreadsheet/rename/worksheet, spreadsheet/move/worksheet
Bảo trì — compress, repair, accept revisions spreadsheet/compress, spreadsheet/repair, spreadsheet/accept-all-revisions, {name}/accept-all-revisions

Mỗi endpoint nhận một workbook dưới dạng multipart input (cục bộ) hoặc tham chiếu tới một workbook đã có trong lưu trữ đám mây (từ xa), và trả về hoặc là một luồng workbook đã được chỉnh sửa, một payload JSON, hoặc một thông báo OK đơn giản.

2. Mười lăm điểm cuối một cách tổng quan

# HTTP Route Nguồn Chức năng
1 PUT /v4.0/cells/spreadsheet/create — Tạo một workbook mới, tùy chọn từ mẫu
2 PUT /v4.0/cells/spreadsheet/worksheets Cục bộ Liệt kê tất cả các worksheet (tên + loại)
3 PUT /v4.0/cells/spreadsheet/add/worksheet Cục bộ Thêm một worksheet với loại, tên, vị trí
4 PUT /v4.0/cells/spreadsheet/delete/worksheet Cục bộ Xóa một worksheet theo tên
5 PUT /v4.0/cells/spreadsheet/rename/worksheet Cục bộ Đổi tên một worksheet
6 PUT /v4.0/cells/spreadsheet/move/worksheet Cục bộ Di chuyển một worksheet tới chỉ mục mới
7 PUT /v4.0/cells/spreadsheet/compress Cục bộ Nén workbook để giảm kích thước
8 PUT /v4.0/cells/spreadsheet/repair Cục bộ Sửa chữa workbook bị hỏng
9 GET /v4.0/cells/{name}/worksheets/{worksheet}/mergedcells Đám mây Liệt kê các vùng ô đã hợp nhất trong một worksheet từ xa
10 PUT /v4.0/cells/spreadsheet/mergedcells Cục bộ Liệt kê các vùng ô đã hợp nhất trong một worksheet cục bộ
11 PUT /v4.0/cells/spreadsheet/accept-all-revisions Cục bộ Chấp nhận tất cả các thay đổi được theo dõi
12 PUT /v4.0/cells/{name}/accept-all-revisions Đám mây Chấp nhận tất cả các thay đổi được theo dõi trong tệp từ xa
13 PUT /v4.0/cells/spreadsheet/structure Cục bộ Lấy cấu trúc đầy đủ dưới dạng JSON
14 GET /v4.0/cells/{name}/structure Đám mây Lấy cấu trúc đầy đủ của tệp từ xa dưới dạng JSON
15 PUT /v4.0/cells/spreadsheet/create — (bí danh — xem #1)

Các tuyến giả định máy chủ https://api.aspose.cloud. Các cuộc gọi thực tế trông giống như https://api.aspose.cloud/v4.0/cells/....

3. Trước khi bắt đầu: hai điều kiện tiên quyết

  1. Lấy thông tin xác thực. Đăng ký tại Aspose Cloud Dashboard, tạo một ứng dụng, lấy Client ID và Client Secret. SDKs xử lý việc trao đổi JWT cho bạn; với cURL, bạn tự đổi chúng để nhận token bearer một cách thủ công.
  2. Cài đặt SDK — hoặc chỉ dùng cURL. Mọi thứ đều là REST thuần.
<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

4. Bắt đầu nhanh: tạo một workbook mới

PUT /v4.0/cells/spreadsheet/create là hành động đơn giản nhất mà controller thực hiện — và cũng là một trong những hành động hữu ích nhất. Nó trả về một tệp workbook mới hoàn toàn.

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 Default Meaning
format string xlsx Định dạng tệp đầu ra — xlsx, xlsm, xlsb, ods, v.v.
template string null Đường dẫn tệp mẫu tùy chọn. Khi được cung cấp, sổ làm việc mới sẽ được khởi tạo với nội dung và định dạng của mẫu.

Sử dụng mẫu

Nếu bạn có một mẫu có thương hiệu — logo trong tiêu đề, màu sắc thương hiệu trong giao diện, bảng “Invoice” đã được định dạng sẵn — hãy tải lên một lần lên lưu trữ đám mây, sau đó truyền đường dẫn của nó dưới dạng 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

Bây giờ ứng dụng của bạn có thể tạo ra các hoá đơn mới đã có giao diện đúng, mà không cần nhúng bất kỳ logic định dạng nào.

5. Hướng dẫn: quản lý worksheets trong một workbook

Bốn endpoint này xử lý các thao tác hàng ngày của một workbook. Hãy cùng đi qua một chuỗi thao tác thực tế: bạn đã tải lên một workbook, và bạn cần liệt kê các sheet của nó, thêm một sheet mới, đổi tên một sheet hiện có, và xóa một sheet thứ ba.

5a. Liệt kê các trang tính

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. Thêm một bảng tính mới

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
Tham số Kiểu Mặc định Ý nghĩa
sheetType string Worksheet Loại của sheet mới — Worksheet, Chart, v.v.
position int end Vị trí được đánh chỉ số 0 để chèn sheet mới
sheetName string auto Tên sẽ đặt cho sheet mới

5c. Đổi tên worksheet

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. Xóa một worksheet

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. Di chuyển một bảng tính

# 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

Mỗi endpoint này đều tuân theo cùng một mẫu: tải lên workbook dưới dạng multipart, nhận lại workbook đã được chỉnh sửa. Kết nối chúng trong pipeline của bạn, hoặc gọi chúng một cách ad‑hoc từ giao diện người dùng.

6. Hướng dẫn: nén một workbook phình to

Một người dùng đã gửi cho bạn một tệp XLSX 40 MB mà 90 % là XML dư thừa. PUT /v4.0/cells/spreadsheet/compress làm giảm kích thước của nó.

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
Tham số Kiểu Ý nghĩa
level int Mức độ nén. 0 = không nén, 9 = tối đa.

Mức 9 trên một workbook thường có dung lượng 40 MB thường sẽ rơi vào khoảng 6–10 MB. Nội dung vẫn giống nhau; chỉ có việc nén ZIP của container XLSX được siết chặt hơn.

7. Hướng dẫn: sửa workbook bị hỏng

Đôi khi bạn nhận được một tệp mà Excel từ chối mở. PUT /v4.0/cells/spreadsheet/repair chạy quy trình khôi phục của engine và trả về một phiên bản sạch.

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

Không có tham số. Bộ điều khiển tái tuần tự hoá workbook thông qua engine, loại bỏ các phần bị hỏng và ghi một tệp hợp lệ về cấu trúc. Không phải mọi sự hỏng hóc đều có thể khôi phục, nhưng cách này xử lý các trường hợp phổ biến — các mục ZIP bị cắt ngắn, tham chiếu ô không hợp lệ, chuỗi chia sẻ bị sai định dạng.

8. Tóm tắt các lợi ích chính

  • Một bộ điều khiển cho các thao tác vòng đời. Tạo, tái cấu trúc, nén, sửa chữa, kiểm tra — tất cả dưới một mô hình xác thực và một hợp đồng lỗi.
  • Tạo có nhận thức mẫu. Đừng tự triển khai lại kiểu dáng trong ứng dụng của bạn; hãy để máy chủ chèn một mẫu vào mỗi workbook mới.
  • Biến thể cục bộ và từ xa. Cùng một logic bất kể tệp nằm trong trình duyệt của người dùng hay đã có trong lưu trữ đám mây.
  • Kiểm tra cấu trúc. Endpoint structure trả về một bản đồ JSON đầy đủ của các sheet, bảng, pivot table, biểu đồ và hình dạng — hoàn hảo để điều khiển UI hoặc quy trình kiểm tra.
  • Không cần hạ tầng. Không cần cài đặt Excel, không COM, không máy chủ cần bảo trì.