สร้าง, จัดการ, บำรุงรักษา: คู่มือปฏิบัติการสำหรับ Aspose.Cells Cloud Management API

การสร้างเวิร์กบุ๊กเปล่า, การเปลี่ยนชื่อชีต, การบีบอัดไฟล์ที่บวม, หรือการซ่อมไฟล์ที่เสีย — สิ่งเหล่านี้เป็นงานเล็ก ๆ ที่ทำทุกวันซึ่งยังคงกินเวลาของนักพัฒนาเมื่อคุณไม่มีเครื่องมือที่เหมาะสม ManagementController ทำให้เป็นบรรทัดเดียว

ทุกแอปพลิเคชันที่ทำงานกับสเปรดชีตในที่สุดก็ต้องเผชิญกับงานที่ไม่น่าตื่นเต้นเดียวกัน:

  • Creating การสร้าง workbook ใหม่ที่ว่างเปล่าทันที — บางครั้งจากเทมเพลตที่มีแบรนด์
  • Rearranging worksheets — การเพิ่ม, เปลี่ยนชื่อ, ลบ, จัดเรียงใหม่ — เนื่องจากรูปแบบของข้อมูลเปลี่ยนแปลงตั้งแต่เมื่อวาน
  • Taming file size — การบีบอัดไฟล์ XLSX ขนาด 40 MB ให้เหลือ 8 MB ก่อนส่งอีเมล
  • Rescuing a corrupted file — ไฟล์ที่ผู้ใช้บันทึกผิดหรือเครื่องมือส่งออกอย่างไม่ถูกต้อง
  • Inspecting structure — การตรวจสอบว่าแผ่นงาน, ตาราง, แผนภูมิ, และช่วงเซลล์ที่รวมกันอยู่ใน workbook มีอะไรบ้างโดยไม่ต้องเปิดไฟล์

The ManagementController ใน Aspose.Cells Cloud microservice (source: src/Aspose.Cells.Cloud.MicroService/Controllers/ManagementController.cs) จัดการทั้งหมดเหล่านี้ผ่าน REST surface ที่สะอาด. โพสต์นี้แนะนำ 15 endpoint ของมันพร้อมตัวอย่าง cURL ที่สามารถรันได้ซึ่งคุณสามารถคัดลอกไปวางใน pipeline ของคุณได้วันนี้.

1. ManagementController ทำอะไร?

ManagementController คือคอนโทรลเลอร์ที่มุ่งเน้นไปที่ วงจรชีวิตและการดูแลรักษา workbook . แตกต่างจาก ConversionController (การแปลงรูปแบบ), DataProcessingController (การรวม/แยก/นำเข้าแบบกลุ่ม), หรือ CellsController (การอ่าน/เขียนระดับเซลล์), คอนโทรลเลอร์นี้เกี่ยวกับ รูปร่าง, สภาพสุขภาพ, และเมตาดาต้า ของ workbook เอง.

ความรับผิดชอบ จุดเชื่อมต่อทั่วไป
สร้าง สมุดงาน, โดยอาจมาจากเทมเพลต spreadsheet/create
ตรวจสอบ โครงสร้าง — worksheets, merged cells, full structure JSON spreadsheet/worksheets, spreadsheet/mergedcells, spreadsheet/structure, {name}/worksheets/{worksheet}/mergedcells, {name}/structure
แก้ไข การจัดวาง worksheet — เพิ่ม, ลบ, เปลี่ยนชื่อ, ย้าย spreadsheet/add/worksheet, spreadsheet/delete/worksheet, spreadsheet/rename/worksheet, spreadsheet/move/worksheet
บำรุงรักษา — บีบอัด, ซ่อมแซม, ยอมรับการแก้ไข spreadsheet/compress, spreadsheet/repair, spreadsheet/accept-all-revisions, {name}/accept-all-revisions

แต่ละ endpoint รับ workbook เป็น multipart input (local) หรืออ้างอิง workbook ที่มีอยู่แล้วใน cloud storage (remote) และส่งคืนสตรีม workbook ที่แก้ไขแล้ว, JSON payload หรือข้อความ OK อย่างง่าย.

2. จุดเชื่อมต่อสิบห้าอย่างในภาพรวม

# HTTP เส้นทาง แหล่งที่มา ทำอะไร
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/....

3. ก่อนที่คุณจะเริ่ม: สองข้อกำหนดเบื้องต้น

  1. รับข้อมูลประจำตัว. ลงทะเบียนที่ Aspose Cloud Dashboard, สร้างแอปพลิเคชัน, รับ Client ID และ Client Secret. SDK จะจัดการการแลกเปลี่ยน JWT ให้คุณ; หากใช้ cURL, คุณต้องแลกเปลี่ยนด้วยตนเองเพื่อรับโทเค็นแบบ bearer
  2. ติดตั้ง 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. ขั้นตอนการทำงาน: จัดการแผ่นงานในสมุดงาน

สี่ endpoint นี้จัดการรูปแบบประจำวันของ workbook. มาดูขั้นตอนที่เป็นจริงกัน: คุณได้อัปโหลด workbook แล้ว และคุณต้องการแสดงรายการ sheet ของมัน, เพิ่ม sheet ใหม่, เปลี่ยนชื่อ sheet ที่มีอยู่, และลบ sheet ที่สาม.

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
Parameter Type Default Meaning
sheetType string Worksheet ประเภทของแผ่นงานใหม่ — Worksheet, Chart เป็นต้น
position int end ตำแหน่งที่นับจากศูนย์เพื่อแทรกแผ่นงานใหม่
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

แต่ละ endpoint เหล่านี้ทำตามรูปแบบเดียวกัน: อัปโหลด workbook ในรูปแบบ multipart, รับ workbook ที่แก้ไขแล้วกลับมา. เชื่อมต่อพวกมันใน pipeline ของคุณ หรือเรียกใช้แบบ ad‑hoc จาก UI.

6. สาธิต: บีบอัดเวิร์กบุ๊กที่บวม

ผู้ใช้ส่งอีเมลไฟล์ XLSX ขนาด 40 MB ที่มี XML ซ้ำซ้อน 90 % ให้คุณ 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
พารามิเตอร์ ประเภท ความหมาย
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, ไม่มีเซิร์ฟเวอร์ให้ดูแล