> Không cần cài đặt Excel cục bộ. Không cần duy trì máy chủ chuyển đổi. Biến XLSX → PDF, Excel → CSV/JSON/hình ảnh/HTML thành các cuộc gọi REST đơn giản — và có “trình chuyển đổi bảng tính đám mây” đầu tiên của bạn hoạt động trong khoảng ba phút. “Chuyển đổi bảng tính đó sang định dạng khác” là một trong những yêu cầu phổ biến nhất trong phát triển hàng ngày: - Các đội tài chính và pháp lý muốn một báo cáo chỉ đọc, không thể thay đổi dưới dạng PDF thay vì một tệp .xlsx mà ai cũng có thể chỉnh sửa; - Các đội dữ liệu cần kéo dữ liệu bảng vào các hệ thống hạ nguồn dưới dạng CSV / JSON; - Các ứng dụng web và di động muốn các bảng tính — và thậm chí cả biểu đồ — được hiển thị trực tiếp dưới dạng PNG / SVG; - Các cổng thông tin muốn các đoạn mã HTML / HTML-Table sạch để nhúng; - Ai đó cần chuẩn hóa một đống tệp .xls / .xlsx / .csv / .ods thành một định dạng. Các câu trả lời cũ — một cài đặt Excel cục bộ với macro, hoặc một thành phần COM nặng trên máy chủ của bạn — rất khó mở rộng và khó duy trì trên nhiều nền tảng. Aspose.Cells Cloud thay thế tất cả những điều đó bằng một API REST thuần túy: tải lên một tệp, nhận lại một tệp định dạng mới. Bài viết này hướng dẫn qua ba API chuyển đổi được công bố bởi ConversionController trong dịch vụ vi mô Aspose.Cells Cloud (nguồn: src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs), với các ví dụ có thể chạy được bằng cURL, C# (.NET), Python và Java. — ## 1. Tính năng Chuyển đổi có thể làm gì? ConversionController là bộ điều khiển dành riêng cho chuyển đổi định dạng / xuất. Nó bao bọc quá trình chuyển đổi chính xác ở cấp độ động cơ thành ba bộ API HTTP: | # | Kịch bản | Điểm cuối điển hình | Chức năng của nó | | — | ———————————————————— | ————————————————– | —————————————————————————————————————————- | | 1 | Tệp đã có trong lưu trữ đám mây → tải xuống định dạng mới | GET /v4.0/cells/{name}?format=pdf | Chuyển đổi một sổ làm việc trực tiếp trong lưu trữ đám mây và truyền kết quả trở lại — các tệp lớn không bao giờ phải di chuyển đến máy của bạn | | 2 | Tệp cục bộ → chuyển đổi trực tuyến (tính năng chính) | PUT /v4.0/cells/convert/spreadsheet?format=pdf | Bạn tải tệp lên trong thân yêu cầu (đa phần); máy chủ chuyển đổi và trả về tệp kết quả trực tiếp | | 3 | Tệp đám mây → lưu dưới dạng định dạng mới, trở lại lưu trữ đám mây | PUT /v4.0/cells/{name}/saveas?format=pdf | Tệp đã chuyển đổi được ghi thẳng trở lại lưu trữ đám mây — lý tưởng cho các quy trình tự động | > Ghi chú thực hiện: các tuyến đường nguồn sử dụng tiền tố v{version}/cells với phiên bản API 4.0, vì vậy các cuộc gọi trực tiếp trông giống như https://api.aspose.cloud/v4.0/cells/.... ### Độ chi tiết chuyển đổi vượt xa “toàn bộ tệp” Ngoài việc chuyển đổi toàn bộ sổ làm việc, bộ điều khiển có thể xuất ra một phần tử đơn: - Một bảng tính cụ thể → PDF / hình ảnh / CSV / JSON / HTML - Một phạm vi ô cụ thể (ví dụ: A1:C12) → PDF / hình ảnh / CSV / JSON / HTML - Một bảng cụ thể → PDF / hình ảnh / CSV / JSON / HTML - Một biểu đồ cụ thể → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF Vì vậy, bạn không bao giờ phải chuyển đổi một sổ làm việc 50 MB chỉ để lấy một biểu đồ — chuyển đổi chỉ những gì bạn cần và tiết kiệm băng thông và tính toán. — ## 2. Các định dạng nào được hỗ trợ? Dựa trên đăng ký ExportData tích hợp trong bộ điều khiển, ma trận chuyển đổi trông đại khái như sau: | Loại | Định dạng | | —————————————– | ———————————————————————————————————————- | | Nhập và xuất (hai chiều) | XLS, XLSX, XLSB, XLSM, CSV, TSV, ODS, TXT | | Chỉ xuất | PDF, OTS, XPS, DIF, HTML / MHTML, JSON, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS, Markdown, DOCX, PPTX, SQL, v.v. | Tóm lại: chuyển đổi bảng tính sang bảng tính của mọi loại, cộng với toàn bộ gia đình đầu ra bảng tính → PDF / hình ảnh / dữ liệu web — tất cả đều nằm sau một bề mặt API duy nhất. — ## 3. Hai điều bạn cần trước khi bắt đầu 1. Đăng ký một tài khoản miễn phí trên Aspose Cloud Dashboard và tạo một Ứng dụng để nhận Client ID và Client Secret (các SDK tự động trao đổi chúng để lấy JWT — không cần xây dựng tiêu đề xác thực cho riêng bạn). 2. Cài đặt SDK cho ngôn ngữ bạn chọn: xml <!-- .NET --> <PackageReference Include="Aspose.Cells-Cloud" Version="25.x" /> bash # Python pip install asposecellscloud xml <!-- Java (Maven) — lưu ý: KHÔNG có trên Maven Central, vì vậy cần kho Aspose bên dưới --> <repositories> <repository> <id>AsposeJavaAPI</id> <name>Aspose Java API</name> <url>https://repository.aspose.cloud/repo/</url> </repository> </repositories> <dependency> <groupId>com.aspose</groupId> <artifactId>aspose-cells-cloud</artifactId> <version>26.8</version> </dependency> > Không cần SDK? Mọi thứ đều là REST thuần túy, vì vậy cURL cũng hoạt động tốt (xem bên dưới). — ## 4. Kịch bản 1: Chuyển đổi một tệp Excel cục bộ trực tuyến (API Chuyển đổi chính) Đây là PUT /v4.0/cells/convert/spreadsheet — API “Chuyển đổi” hàng đầu: tải lên tệp cục bộ của bạn trong thân yêu cầu, máy chủ chuyển đổi và truyền tệp mới trở lại. Không có gì được lưu trữ trong lưu trữ đám mây và không có bản sao tải lên nào tồn tại — hoàn hảo cho những khoảnh khắc “chỉ cần chuyển đổi điều này cho tôi”. ### ① cURL bash # 1) Đầu tiên, lấy mã thông báo 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) XLSX -> PDF curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet?format=pdf" \ -H "Authorization: Bearer $TOKEN" \ -F "file=@Book1.xlsx" \ -o Book1.pdf Thay thế format bằng csv, json, png, xlsx… và bạn sẽ nhận được định dạng đó. Một tham số, một định dạng đầu ra. ### ② C# / .NET csharp using Aspose.Cells.Cloud.SDK.Api; using Aspose.Cells.Cloud.SDK.Request; var cellsApi = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET"); var request = new ConvertSpreadsheetRequest( spreadsheet: "C:/invoices/Book1.xlsx", // đường dẫn tệp cục bộ format: "pdf"); // mục tiêu: pdf / csv / json / png ... using Stream result = cellsApi.ConvertSpreadsheet(request); // luồng tệp đã chuyển đổi using var outFile = File.Create("C:/invoices/Book1.pdf"); result.CopyTo(outFile); // Còn đơn giản hơn: chỉ cần chỉ định SDK vào một đường dẫn đầu ra và để nó ghi tệp // cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf"); > Cần một công việc hàng loạt? Đưa điều này vào một vòng lặp qua một thư mục và bạn có “chuyển đổi toàn bộ thư mục XLSX → PDF”. ### ③ Python python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ConvertSpreadsheetRequest import os instance = CellsApi( os.getenv('CellsCloudClientId'), os.getenv('CellsCloudClientSecret')) # XLSX cục bộ -> PDF, kết quả được ghi cục bộ instance.convert_spreadsheet( ConvertSpreadsheetRequest("Book1.xlsx", "pdf"), local_outpath="Book1.pdf") # Các định dạng khác: chỉ cần thay đổi tham số — json / csv / xlsx / png ... ### ④ Java java import com.aspose.cloud.cells.api.CellsApi; import com.aspose.cloud.cells.request.ConvertSpreadsheetRequest; import java.io.File; public class ConvertDemo { public static void main(String[] args) throws Exception { CellsApi api = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET"); ConvertSpreadsheetRequest req = new ConvertSpreadsheetRequest(); req.setSpreadsheet("C:/invoices/Book1.xlsx"); // đường dẫn tệp cục bộ req.setFormat("pdf"); // mục tiêu: pdf / csv / json / png ... File out = api.convertSpreadsheet(req); // kết quả đã chuyển đổi dưới dạng tệp out.renameTo(new File("C:/invoices/Book1.pdf")); System.out.println("Đã chuyển đổi: " + out.getAbsolutePath()); } } Bốn ngôn ngữ, một hành động: cung cấp một đường dẫn + một tham số định dạng → nhận tệp mục tiêu trở lại. Đó là toàn bộ điểm bán của API Chuyển đổi — không phụ thuộc vào Excel ở phía người gọi, không có mẫu, không có thành phần COM. — ## 5. Kịch bản 2: Chuyển đổi tệp đã lưu trữ trên đám mây trực tiếp Khi một tệp đã sống trong Lưu trữ Đám mây Aspose (hoặc lưu trữ đối tượng của bạn), bạn không cần tải xuống/tải lên các tệp lớn — việc chuyển đổi diễn ra trên đám mây, giảm thiểu việc truyền dữ liệu và cải thiện hiệu suất trên các sổ làm việc lớn: bash # tệp Book1.xlsx trên đám mây -> PDF, tải xuống cục bộ curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "format=pdf" \ --data-urlencode "folder=Reports" \ -o Book1.pdf python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ExportSpreadsheetAsFormatRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") # Chuyển đổi một sổ làm việc đã lưu trữ trên đám mây thẳng sang PDF instance.export_spreadsheet_as_format( ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports")) Bạn cũng có thể đi sâu vào một phần tử đơn — ví dụ, hiển thị “biểu đồ thứ 3 trên Sheet1” dưới dạng PNG (phiên bản lưu trữ đám mây): bash # biểu đồ -> PNG curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/worksheets/Sheet1/charts/2" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "format=png" \ -o chart.png Các điểm cuối đám mây chi tiết nhanh chóng: | Mục tiêu | Điểm cuối | Ví dụ format | | —————- | ——————————————————- | —————————– | | Toàn bộ sổ làm việc | GET /v4.0/cells/{name} | pdf / xlsx / csv / json | | Một bảng tính cụ thể | GET /v4.0/cells/{name}/worksheets/{ws} | pdf / png / svg | | Một phạm vi cụ thể | GET /v4.0/cells/{name}/worksheets/{ws}/ranges/{range} | pdf / csv / json / html / png | | Một bảng cụ thể | GET /v4.0/cells/{name}/worksheets/{ws}/tables/{table} | pdf / csv / json / html / png | | Một biểu đồ cụ thể | GET /v4.0/cells/{name}/worksheets/{ws}/charts/{index} | pdf / png / jpeg / svg / tiff | — ## 6. Kịch bản 3: SaveAs — ghi kết quả trở lại lưu trữ đám mây Khi bạn muốn tệp đã chuyển đổi được lưu trữ trở lại lưu trữ đám mây (thay vì tải xuống), hãy sử dụng PUT /v4.0/cells/{name}/saveas. Đây là một cách tự nhiên cho tự động hóa như “xuất báo cáo hôm nay sang PDF để lưu trữ, mỗi ngày”: bash curl -X PUT "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/saveas?format=pdf" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{}' python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import SaveSpreadsheetAsRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") instance.save_spreadsheet_as( SaveSpreadsheetAsRequest("Book1.xlsx", format="pdf", folder="Reports")) # Kết quả được lưu trực tiếp trong lưu trữ đám mây; trả về CellsCloudResponse(Code=200, Status="OK") Bạn có thể truyền các tùy chọn lưu chi tiết thông qua thân yêu cầu SaveOptionsData, và kiểm soát tên tệp đầu ra, lưu trữ đầu ra, phông chữ tùy chỉnh, vùng/địa phương, mật khẩu, v.v. thông qua các tham số truy vấn — thêm thông tin về những điều này dưới Chi tiết kỹ thuật bên dưới. — ## 7. Nhiều điểm cuối “chuyển đổi trực tuyến” đã sẵn sàng khác Ngoài các chuyển đổi cấp sổ làm việc ở trên, bộ điều khiển cung cấp một bộ đầy đủ các tệp cục bộ → mục tiêu cụ thể điểm cuối (cùng mẫu tải lên trong thân yêu cầu như Kịch bản 1), chi tiết hơn và tiết kiệm băng thông hơn: | Mục tiêu | Điểm cuối (PUT, tiền tố /v4.0/cells/convert/) | | ————————————————– | ——————————————————————————————————– | | Sổ làm việc → PDF / JSON / CSV | spreadsheet/pdf, spreadsheet/json, spreadsheet/csv | | Bảng tính → PDF / JSON / CSV / HTML / HTML-Table | worksheet/pdf, worksheet/json, worksheet/csv, worksheet/html, worksheet/html-table | | Bảng tính → hình ảnh | worksheet/image?worksheet=Sheet1&format=png | | Phạm vi → PDF / CSV / HTML / JSON / hình ảnh | range/pdf, range/csv, range/html, range/json, range/image?worksheet=..&range=A1:C12&format=png | | Bảng → PDF / CSV / HTML / JSON / hình ảnh | table/pdf, table/csv, table/html, table/json, table/image | | Biểu đồ → hình ảnh / PDF | chart/image?worksheet=..&chartIndex=0&format=png, chart/pdf | Ví dụ, “xuất chỉ phạm vi này dưới dạng CSV cho hệ thống hạ nguồn”: bash curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/csv" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "worksheet=Sheet1" \ --data-urlencode "range=A1:C100" \ -F "file=@data.xlsx" \ -o data.csv Các điểm cuối này sử dụng cùng mẫu tải lên trong thân yêu cầu như convert/spreadsheet. Trong SDK .NET, các trường hợp biểu đồ có các lớp bọc kiểu tương ứng với các tuyến đường v4.0 này — ConvertChartToImage (convert/chart/image) và ConvertChartToPdf (convert/chart/pdf). Các biến thể worksheet/*, range/* và table/* vẫn chưa có lớp bọc v4.0, vì vậy hãy gọi chúng qua REST thuần túy giống như cURL ở trên. — ## 8. Chi tiết kỹ thuật & xử lý lỗi ### Các tùy chọn chuyển đổi đáng biết (tham số truy vấn) - password — mở các sổ làm việc được bảo vệ bằng mật khẩu; - fontsLocation / hỗ trợ phông chữ tùy chỉnh — giữ đúng các ký tự khi hiển thị PDF/hình ảnh; - tự động điều chỉnh hàng/cột, và liệu có in tiêu đề hàng/cột (printHeadings), thiết lập vùng/trang (region), v.v.; - phía đầu ra: outPath / outStorageName quyết định nơi kết quả nằm trong lưu trữ đám mây. ### Mã lỗi (hợp đồng mà bộ điều khiển tài liệu) | Trạng thái | Ý nghĩa | Nguyên nhân điển hình | | ——- | ———— | ———————————————————– | | 400 | Yêu cầu không hợp lệ | URL / tham số không hợp lệ, hoặc một format không được hỗ trợ | | 401 | Không được ủy quyền | Xác thực không thành công hoặc không có thông tin xác thực hợp lệ được cung cấp | | 404 | Không tìm thấy | Tệp nguồn không thể truy cập trong lưu trữ đám mây | | 500 | Lỗi máy chủ | Dịch vụ gặp sự cố trong khi lấy dữ liệu chuyển đổi | ### Xác thực Tất cả các SDK tự động xác thực với OAuth 2.0 client_credentials và một JWT; khi sử dụng cURL thô, hãy gọi /connect/token một lần đầu tiên (xem Kịch bản 1, ① ở trên). — ## 9. Tại sao lại là Aspose.Cells Cloud Convert? - ✅ Không có phụ thuộc cục bộ — không cần Office/Excel, không cần COM. Có thể gọi từ bất kỳ ngôn ngữ và nền tảng nào (Linux, container, không máy chủ); - ✅ Hiển thị chất lượng cao — được hỗ trợ bởi động cơ Aspose.Cells, vì vậy công thức, biểu đồ, kiểu dáng và phân trang được hiển thị với chất lượng chuyên nghiệp vào PDF/hình ảnh; - ✅ Gốc đám mây — các tệp có thể ở lại trên đám mây trong quá trình chuyển đổi để tránh việc chuyển tải các tải trọng lớn; chuyển đổi trực tuyến thuần túy không cần lưu trữ đám mây chút nào; - ✅ Độ chi tiết linh hoạt — sổ làm việc / bảng tính / phạm vi / bảng / biểu đồ: chuyển đổi chính xác phần bạn cần; - ✅ Một hình dạng trên tất cả các SDK — các ví dụ cURL, .NET, Python và Java ánh xạ 1:1, vì vậy bạn có thể sao chép mẫu mà bạn thích. Bắt đầu ngay bây giờ: đăng ký trên Aspose Cloud Dashboard, tạo một Ứng dụng, đặt thông tin xác thực của bạn vào bất kỳ đoạn mã nào ở trên và chạy nó — bạn sẽ có “trình chuyển đổi Excel đám mây” của riêng mình trong vài phút. Thấy điều này hữu ích? Đánh dấu, đánh dấu hoặc chia sẻ nó — và cho chúng tôi biết về các trường hợp sử dụng chuyển đổi bảng tính của riêng bạn trong phần bình luận.