4 Tùy chọn Bố cục Excel sang PDF được So sánh trong Java

Kho mẫu đi kèm (đang chờ xuất bản): excel-pdf-pagination-java

Phân trang Excel sang PDF là một quy trình làm việc của GroupDocs.Conversion cho Java, quyết định cách các hàng và cột của bảng tính xuất hiện trên các trang đầu ra. Câu hỏi quan trọng không chỉ là việc chuyển đổi có thành công hay không. Mà là liệu báo cáo có đến ở dạng mà người đọc có thể sử dụng hay không. So sánh này chạy cùng một workbook qua bốn chính sách trên phiên bản 26.10 và ghi lại số trang cùng với kích thước vật lý. Hai đo lường này kể các phần khác nhau của câu chuyện.

Giới thiệu

Một worksheet là một nền vẽ linh hoạt; một trang PDF có ranh giới vật lý. Sự khác biệt này trở nên rõ ràng khi một báo cáo đặt các cột liên quan cách nhau xa hoặc sử dụng các hàng trống để tách các phần. Một xuất có thể giữ nguyên khoảng cách và tách bảng theo chiều ngang. Một cài đặt khác có thể đưa mọi cột lại với nhau bằng cách làm trang rộng hơn. Một cài đặt thứ ba có thể loại bỏ các khoảng trống mà tác giả cố ý đặt giữa các khối. Không có kết quả nào trong số này có thể được đánh giá chỉ dựa vào thông báo thành công.

Ví dụ sử dụng một báo cáo hư cấu, chỉ có một sheet để việc so sánh có thể tái tạo. Dữ liệu xuất hiện trong tám cột đã được điền, với các cột trống giữa các nhóm. Các hàng 1, 2, 3, 12, 13 và 40 chứa các dấu hiệu. Workbook chỉ định giấy A4 dọc và lề nguồn một inch. Chúng tôi giữ file này không thay đổi trong khi chạy bốn phương pháp, sau đó kiểm tra các PDF kết quả thay vì giả định rằng ít trang hơn đồng nghĩa với một xuất tốt hơn.

Tại sao việc so sánh bố cục lại quan trọng

Các tùy chọn giải quyết các vấn đề khác nhau. AllColumnsInOnePagePerSheet giải quyết việc nhóm theo chiều ngang. SkipEmptyRowsAndColumns giải quyết khoảng trống trống. OnePagePerSheet yêu cầu một tổng quan cấp sheet. Một chuyển đổi mặc định cung cấp một chuẩn để đánh giá mỗi chính sách. Việc giữ các trường hợp này riêng biệt giúp giải thích các thay đổi dễ dàng hơn cho người phê duyệt báo cáo.

Đối với Java 26.10, các cờ all-columns và skip-empty đều mặc định là false. Điều này quan trọng khi mã dựa vào các cài đặt ngầm thay vì biểu thị một chính sách xuất. Các tùy chọn nền tảng không phải tất cả đều là tính năng mới của bản phát hành này. Bài viết này ghi lại cách chúng tương tác đã được kiểm nghiệm với fixture được bao gồm trên 26.10. Nó không đưa ra benchmark tốc độ hay khẳng định số trang cố định cho bất kỳ workbook nào.

Tùy chọn nào giữ báo cáo Excel trên khổ A4?

Trên fixture được bao gồm, các biến thể mặc định và skip-empty tạo ra các trang A4, trong khi all-columns và one-page-per-sheet tạo ra các kích thước tùy chỉnh. Đó là kết quả đo lường, không phải một bảo đảm A4 chung. Kiểm tra cài đặt trang của workbook và kiểm tra kích thước đầu ra trước khi giao. Nếu hệ thống nhận yêu cầu kích thước giấy cố định, hãy đưa yêu cầu đó vào bài kiểm tra chấp nhận thay vì dựa vào số trang.

Yêu cầu trước

Sử dụng JDK 11 hoặc 17, Maven và GroupDocs.Conversion cho Java 26.10. Dự án bao gồm documents/report.xlsx và tạo Result/ khi chạy. Cần có giấy phép bao phủ bản phát hành để hoàn thành việc xác minh không giới hạn vì giới hạn đánh giá có thể làm gián đoạn đầu ra nhiều trang. Mã nguồn phân phối chứa một placeholder giấy phép; giữ giấy phép thực của bạn bên ngoài dự án. Mỗi phương pháp mở một Converter mới và đóng nó sau khi lưu PDF.

Cài đặt

Dự án hoàn chỉnh cung cấp repository GroupDocs và phụ thuộc Maven này. Chạy lệnh từ thư mục chứa pom.xml để các đường dẫn tài liệu tương đối được giải quyết. Các khối Java bên dưới là các thân phương thức được trích xuất, với các import và thiết lập thư mục được cung cấp bởi dự án đầy đủ. Không có trình soạn thảo bảng tính nào được gọi bởi ví dụ.

<dependency>
  <groupId>com.groupdocs</groupId>
  <artifactId>groupdocs-conversion</artifactId>
  <version>26.10</version>
</dependency>
mvn compile exec:java

Phương pháp 1: Thiết lập xuất mặc định

Bắt đầu với một Converter nhận SpreadsheetLoadOptions không thay đổi. Đây là file tham chiếu cho việc so sánh. Các hàng và cột trống của fixture vẫn có ý nghĩa đối với bố cục, và sheet rộng bị tách theo chiều ngang. Kết quả có ba trang có kích thước khoảng 595.44 x 841.68 points, mà pdfinfo xác định là A4. Giữ lại đầu ra này ngay cả khi nó không phải là phiên bản bạn sẽ cuối cùng giao.

SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
    converter.convert("Result/01-defaults.pdf", new PdfConvertOptions());
}

Cơ sở trả lời một câu hỏi thực tiễn: điều gì thay đổi khi một cờ duy nhất được bật? Nếu không có nó, một báo cáo gọn gàng có thể bị gán cho một chỉnh sửa workbook không liên quan hoặc một file nguồn khác. Tôi sẽ lưu các đầu ra so sánh này với các tên riêng biệt trong quá trình tích hợp, như mẫu đã làm. Điều đó làm cho việc xem xét trực quan ít mơ hồ hơn. Workbook gốc vẫn không thay đổi, vì vậy người xem luôn có cùng điểm khởi đầu.

Phương pháp 2: Giữ tất cả các cột lại với nhau

Phương pháp thứ hai bật AllColumnsInOnePagePerSheet. Trong fixture, các ô từ cột A đến L giờ xuất hiện trên một trang PDF duy nhất, rộng hơn. Khoảng trống vẫn còn vì SkipEmptyRowsAndColumns vẫn là false. PDF có kích thước 1138.32 x 841.68 points. Chiều cao khớp với chiều cao trang cơ sở, nhưng chiều rộng thì không.

SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
options.setAllColumnsInOnePagePerSheet(true);
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
    converter.convert("Result/02-all-columns.pdf", new PdfConvertOptions());
}

Điều này có thể hữu ích cho người xem muốn theo dõi một hàng qua các nhóm cột liên quan. Đánh đổi là kích thước trang vật lý. Một trình xem PDF có thể làm cho kết quả rộng trông thoải mái khi vừa khít vào cửa sổ, nhưng việc in ấn lại đưa ra một quyết định tỷ lệ khác. Cũng nhớ rằng workbook này vừa dọc. Thêm nhiều hàng có thể khiến một báo cáo khác hành xử khác; cài đặt này không thiết lập một quy tắc một trang cho mỗi workbook.

Phương pháp 3: Loại bỏ khoảng trống trống

Xuất gọn bật SkipEmptyRowsAndColumns và để các chính sách khác ở mặc định. Trên fixture, các dấu hiệu hàng đã bị tách bởi các vùng trống lớn di chuyển lại gần nhau hơn. Các khoảng trống cột cũng biến mất. Đầu ra chiếm hai trang A4 thay vì ba trang cơ sở. Nó vẫn có thể tách các cột theo chiều ngang vì chính sách all-columns không được bật trong phương pháp này.

SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
options.setSkipEmptyRowsAndColumns(true);
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
    converter.convert("Result/03-skip-empty.pdf", new PdfConvertOptions());
}

Sử dụng biến thể này khi các khoảng trống chỉ là ngẫu nhiên chứ không phải là một phần của thiết kế báo cáo. Một hàng trống có thể là bộ tách trực quan, một chỗ giữ chỗ cho chữ ký hoặc một phần của mẫu. Việc loại bỏ nó có thể làm cho một báo cáo số ngắn hơn trong khi làm giảm tính hữu ích của một mẫu có cấu trúc. Chúng tôi cố ý giữ điều này như một lần chạy độc lập. Kết hợp ngay lập tức với nhóm all-columns sẽ ẩn đi cài đặt nào gây ra mỗi thay đổi quan sát được.

Phương pháp 4: Đặt toàn bộ sheet trên một trang

OnePagePerSheet nhóm toàn bộ worksheet trên một trang PDF. Đầu vào của chúng tôi chỉ có một sheet, vì vậy kết quả chứa một trang. Kích thước của nó là 1138.32 x 638.237 points, khác cả so với cơ sở và trường hợp all-columns. Đây là một tổng quan sheet với canvas tùy chỉnh. Nó không phải là bằng chứng rằng cùng một báo cáo đã được điều chỉnh cho giấy A4.

SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
options.setOnePagePerSheet(true);
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
    converter.convert("Result/04-one-page.pdf", new PdfConvertOptions());
}

Tôi sẽ chọn chính sách này cho việc xem xét trên màn hình chỉ sau khi mở kết quả ở mức thu phóng mà người đọc sẽ dùng. Một hình thu nhỏ một trang không cho biết nhiều về văn bản nhỏ trên một báo cáo dày đặc. Cài đặt này có thể phù hợp khi ranh giới trang là một yếu tố gây xao lạc, nhưng đầu ra vẫn cần một kiểm tra chấp nhận. Sử dụng một workbook đại diện trước khi áp dụng nó làm mặc định của ứng dụng. Báo cáo hư cấu được bao gồm cung cấp một điểm khởi đầu có thể lặp lại thay vì một quy chuẩn bố cục chung.

So sánh các phương pháp: khi nào nên dùng mỗi phương pháp

Xuất Số trang Kích thước trang, điểm Đánh đổi chính
Mặc định 3 595.44 x 841.68 Các cột liên quan có thể bị tách
Tất cả cột lại với nhau 1 1138.32 x 841.68 Trang vật lý rộng hơn
Bỏ qua các hàng và cột trống 2 595.44 x 841.68 Khoảng trống có chủ đích biến mất
Một trang mỗi sheet 1 1138.32 x 638.237 Tổng quan tùy chỉnh kích thước sheet

Xem trước trang đầu của bốn bố cục Excel PDF đã xác minh

Hình ảnh chỉ hiển thị trang đầu của mỗi đầu ra. Các cột của nó được thu phóng để phù hợp với so sánh, vì vậy các kích thước hiển thị không thiết lập các kích thước giấy vật lý bằng nhau. Hãy sử dụng bảng và các thuộc tính PDF thực tế để đưa ra quyết định đó. Các file hoàn chỉnh được ghi vào Result/ khi dự án chạy. Kiểm tra các trang còn lại của các phiên bản mặc định và gọn gàng trước khi phê duyệt.

Thực hành tốt và mẹo

Ghi lại các yêu cầu của hệ thống nhận trước. Một máy in có thể cần A4, trong khi người xem nội bộ có thể thích một trang rộng. Một mẫu có thể cần không gian trống mà một báo cáo chỉ dữ liệu có thể bỏ qua. Những lựa chọn đó thuộc về chính sách xuất, không phải một giả định rằng PDF ngắn nhất là tốt nhất. Chúng tôi sẽ giữ một workbook đại diện cho mỗi mẫu báo cáo và chạy lại so sánh sau khi thay đổi nó.

Xem kích thước vật lý như dữ liệu kiểm thử. Số trang cho bạn biết bao nhiêu phân trang đã xảy ra, nhưng không cho biết các cột có còn gộp lại hay văn bản có đọc được. Các kích thước đo được trong mẫu đến từ Poppler pdfinfo sau khi thực thi có giấy phép trên Java 11.0.2. Các hình thu nhỏ trang được render riêng biệt. Không bước nào là đo lường hiệu năng, và không bước nào thay thế việc xem xét báo cáo thực tế.

Giữ các tuyên bố về lề riêng biệt với các tuyên bố về nhóm. Một kiểm tra 26.10 riêng biệt đặt lề PdfConvertOptions thành 36 points đã tạo ra các render giống hệt với đầu ra spreadsheet mặc định. Vì vậy so sánh này không hứa hẹn việc ghi đè lề qua đường này. Nếu lề cụ thể là yêu cầu, hãy điều tra và xác minh chúng một cách độc lập trước khi đưa chúng vào giải pháp.

Kết luận

Chạy bốn phương pháp trên workbook được cung cấp, sau đó so sánh với một báo cáo đã được phê duyệt thực tế. Chọn chính sách nhóm dựa trên nhu cầu của người đọc và yêu cầu kích thước trang của hệ thống nhận. Xác nhận khoảng cách và kích thước vật lý trước khi đặt nó làm mặc định. Bảo tồn cơ sở để bản nâng cấp phiên bản tiếp theo có một so sánh cụ thể.

Tài nguyên bổ sung