4 אפשרויות פריסת Excel ל-PDF מושוות ב-Java

מאגר דוגמה נלווה (בהמתנה לפרסום): excel-pdf-pagination-java

Excel-to-PDF pagination הוא זרימת עבודה של GroupDocs.Conversion עבור Java שמחליטה כיצד שורות ועמודות הגיליון מופיעות בעמודי הפלט. השאלה החשובה אינה רק האם ההמרה מצליחה. אלא האם הדוח מגיע בצורה שהקורא יכול להשתמש בה. השוואה זו מריצה את אותו חוברת עבודה דרך ארבע מדיניות בגרסה 26.10 ומתעדת את מספר העמודים יחד עם הממדים הפיזיים. שני המדדים הללו מספרים חלקים שונים של הסיפור.

מבוא

גיליון עבודה הוא קנבס גמיש; דף PDF בעל גבול פיזי. ההבדל הזה מתגלה כאשר דוח מציב עמודות קשורות רחוקות זו מזו או משתמש בשורות ריקות להפרדת חלקים. ייצוא עשוי לשמר את הריווח ולפצל את הטבלה אופקית. הגדרה אחרת עשויה לאחד את כל העמודות על ידי הרחבת הדף. שלישית יכולה להסיר רווחים שהמחבר הציב במכוון בין בלוקים. אף אחת מהתוצאות הללו לא ניתן לשפוט רק מהודעת הצלחה.

הדוגמה משתמשת בדוח פיקטיבי בעל גיליון יחיד כדי שההשוואה תישאר ניתנת לשחזור. הנתונים מופיעים בשמונה עמודות מלאות, עם עמודות ריקות בין הקבוצות. שורות 1, 2, 3, 12, 13 ו‑40 מכילות סמנים. חוברת העבודה מציינת נייר פורטרט A4 ושוליים של אינץ’ אחד. אנו משאירים קובץ זה ללא שינוי בזמן הרצת ארבע השיטות, ולאחר מכן בודקים את קבצי ה‑PDF המתקבלים במקום להניח שמספר עמודים קטן יותר משמעותו ייצוא טוב יותר.

למה השוואת פריסה חשובה

האפשרויות פותרות בעיות שונות. AllColumnsInOnePagePerSheet מתמודדת עם קיבוץ אופקי. SkipEmptyRowsAndColumns מתמודדת עם ריווח ריק. OnePagePerSheet מבקשת תצוגה כללית ברמת הגיליון. המרה ברירת מחדל מספקת שליטה אליה ניתן לשפוט כל מדיניות. שמירת המקרים בנפרד מקלה על ההסבר לאדם המאשר את הדוח.

עבור Java 26.10, הדגלים all-columns ו‑skip-empty מוגדרים כברירת מחדל ל‑false. זה חשוב כאשר הקוד מסתמך על הגדרות מרומזות במקום לבטא מדיניות ייצוא. האפשרויות הבסיסיות אינן כולן תכונות חדשות של גרסה זו. מאמר זה מתעד את האינטראקציה שנבדקה עם הפיקסור הכלול ב‑26.10. הוא אינו מציג מדד מהירות או טוען למספר עמודים קבוע עבור חוברות עבודה אקראיות.

איזו אפשרות משמרת דוח Excel על A4?

בפיקסור הכלול, גרסאות ברירת המחדל וה‑skip-empty מייצרות דפים בפורמט A4, בעוד שה‑all-columns וה‑one-page-per-sheet מייצרות גדלים מותאמים. זהו תוצאה מדודה, ולא ערובה כללית ל‑A4. בדקו את הגדרות העמוד של חוברת העבודה ובדקו את ממדי הפלט לפני המסירה. אם מערכת קבלה דורשת גודל נייר קבוע, הפכו דרישה זו לחלק מבחן הקבלה במקום להסתמך על מספר העמודים.

דרישות מוקדמות

השתמשו ב‑JDK 11 או 17, Maven ו‑GroupDocs.Conversion עבור Java 26.10. הפרויקט כולל את documents/report.xlsx ויוצר את התיקייה Result/ בעת הריצה. נדרשת רישיון המכסה את הגרסה כדי להשלים אימות בלתי מוגבל מכיוון שמגבלות הערכה יכולות להפריע לפלט מרובה עמודים. המקור המופץ מכיל מציין מקום לרישיון; שמרו את הרישיון האמיתי שלכם מחוץ לפרויקט. כל שיטה פותחת Converter חדש וסוגרת אותו לאחר שמירת קובץ ה‑PDF.

התקנה

הפרויקט המלא מספק את מאגר GroupDocs ואת תלות Maven זו. הריצו את הפקודה מהספרייה שמכילה את pom.xml כך שהנתיבים היחסיים למסמכים ייפתרו. הבלוקים של Java למטה הם גופי שיטות מחולצים, עם ייבוא והגדרת ספריות המסופקים על ידי הפרויקט המלא. אין עורך גיליון אלקטרוני שמופעל על ידי הדוגמה.

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

שיטה 1: קביעת ייצוא ברירת המחדל

התחילו עם Converter שמקבל SpreadsheetLoadOptions שלא שונו. זהו קובץ ההפניה עבור ההשוואה. השורות והעמודות הריקות של הפיקסור נשארות משמעותיות לפריסה שלו, והגיליון הרחב נשבר אופקית. התוצאה מכילה שלושה עמודים בגודל של כ‑595.44 על 841.68 נקודות, ש‑pdfinfo מזהה כ‑A4. שמרו פלט זה גם אם הוא אינו הגרסה שתספקו בסופו של דבר.

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

הבסיס משיב על שאלה מעשית: מה משתנה כאשר דגל יחיד מוחלף? ללא זאת, דוח קומפקטי עשוי להיות משוייך לעריכה בלתי קשורה של חוברת העבודה או לקובץ מקור שונה. הייתי שומר את פלטי ההשוואה האלה עם שמות שונים במהלך האינטגרציה, כפי שהדוגמה עושה. זה עושה את הסקירה הוויזואלית פחות מעורפלת. חוברת העבודה המקורית נשארת ללא שינוי, ולכן הסוקר תמיד מתחיל מאותו נקודת התחלה.

שיטה 2: שמירת כל העמודות יחד

השיטה השנייה מאפשרת AllColumnsInOnePagePerSheet. בפיקסור, תאים בעמודות A עד L מופיעים כעת על דף PDF יחיד ורחב יותר. הריווח הריק נשאר מכיוון ש‑SkipEmptyRowsAndColumns עדיין false. ה‑PDF מודד 1138.32 על 841.68 נקודות. הגובה תואם לגובה העמוד הבסיסי, אך הרוחב אינו תואם.

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());
}

זה יכול להיות שימושי לסוקר שרוצה לעקוב אחרי שורה אחת דרך קבוצות העמודות הקשורות לה. הוויתור הוא גודל העמוד הפיזי. מציג PDF עשוי לגרום לתוצאה הרחבה להיראות נוחה כאשר היא מותאמת לחלון, אך ההדפסה מוסיפה החלטת קנה מידה נוספת. בנוסף, זכרו שחוברת העבודה הזו מתאימה אנכית. יותר שורות יכולות לגרום לדוח שונה להתנהג אחרת; הגדרה זו אינה קובעת כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל כלל

השתמשו בגרסה זו כאשר הרווחים הם מקריים ולא חלק מעיצוב הדוח. שורה ריקה יכולה לשמש כמפריד חזותי, מציין מקום לחתימה או חלק מטופס. הסרתה עשויה לקצר דוח מספרי בעוד שהיא מקטינה את השימושיות של טופס מובנה. אנו משאירים זאת במכוון כהרצה נפרדת. שילוב מיידי עם קיבוץ כל העמודות היה מסתיר איזו הגדרה גרמה לכל שינוי שנצפה.

שיטה 3: הסרת ריווח ריק

הייצוא הקומפקטי מאפשר SkipEmptyRowsAndColumns ומשאיר את המדיניות האחרות בברירת המחדל שלהן. בפיקסור, סמני השורות שהופרדו באזורים ריקים גדולים מתקרבים זה אל זה. רווחי העמודות הריקים גם נעלמים. הפלט תופס שני דפי A4 במקום שלושת העמודים הבסיסיים. הוא עדיין יכול לפצל עמודות אופקית מכיוון שמדיניות all-columns אינה מופעלת בשיטה זו.

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());
}

השתמשו בגרסה זו כאשר הרווחים הם מקריים ולא חלק מעיצוב הדוח. שורה ריקה יכולה לשמש כמפריד חזותי, מציין מקום לחתימה או חלק מטופס. הסרתה עשויה לקצר דוח מספרי בעוד שהיא מקטינה את השימושיות של טופס מובנה. אנו משאירים זאת במכוון כהרצה נפרדת. שילוב מיידי עם קיבוץ כל העמודות היה מסתיר איזו הגדרה גרמה לכל שינוי שנצפה.

שיטה 4: הצבת כל הגיליון על דף אחד

OnePagePerSheet מקבץ את כל הגיליון על דף PDF אחד. הקלט שלנו מכיל גיליון אחד, ולכן התוצאה מכילה דף אחד. ממדיו הם 1138.32 על 638.237 נקודות, שונים משני המקרים של הבסיס וה‑all-columns. זהו תצוגה כללית של הגיליון עם קנבס מותאם. זה אינו הוכחה שהדוח אותו הותאם לנייר 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());
}

הייתי בוחר במדיניות זו לבחינה מבוססת מסך בלבד לאחר פתיחת התוצאה ברמת הזום שהקורא ישתמש בה. תמונה ממוזערת של דף אחד אומרת מעט על טקסט קטן בדוח צפוף. ההגדרה יכולה להיות מתאימה כאשר גבולות העמוד מהווים הסחת דעת, אך הפלט עדיין דורש בדיקת קבלה. השתמשו בחוברת עבודה מייצגת לפני אימוץ המדיניות כברירת מחדל של היישום. הדוח הפיקטיבי הכלול מספק נקודת התחלה ניתנת לשחזור במקום מפרט פריסה אוניברסלי.

השוואת שיטות: מתי להשתמש בכל אחת

ייצוא עמודים גודל עמוד, נקודות הוויתור העיקרי
ברירת מחדל 3 595.44 x 841.68 עמודות קשורות יכולות להתפצל
כל העמודות יחד 1 1138.32 x 841.68 עמוד פיזי רחב יותר
דילוג על שורות ועמודות ריקות 2 595.44 x 841.68 רווחים מכוונים נעלמים
דף אחד לכל גיליון 1 1138.32 x 638.237 תצוגה מותאמת לגיליון

תצוגות של העמוד הראשון של ארבעת פריסות ה‑Excel ל‑PDF המאומתות

התמונה מציגה רק את העמוד הראשון של כל פלט. העמודות ממקמות את התצוגות כך שהגדלים המוצגים אינם קובעים גדלים פיזיים שווים של נייר. השתמשו בטבלה ובמאפייני ה‑PDF האמיתיים לקבלת החלטה. הקבצים המלאים נכתבים לתיקייה Result/ כאשר הפרויקט רץ. בדקו את העמודים הנותרים של הגרסאות ברירת המחדל והקומפקטיות לפני האישור.

שיטות עבודה מומלצות וטיפים

כתבו תחילה את דרישות מערכת הקבלה. מדפסת עשויה לדרוש A4, בעוד שסוקר פנימי עשוי להעדיף דף רחב. טופס עשוי לדרוש רווח ריק שהדוח המורכב רק מנתונים יכול להסיר. הבחירות הללו שייכות למדיניות הייצוא, ולא להנחה שה‑PDF הקצר ביותר הוא הטוב ביותר. היינו משאירים חוברת עבודה מייצגת אחת לכל תבנית דוח ומריצים מחדש את ההשוואה לאחר שינוי.

התייחסו לממדים הפיזיים כנתוני מבחן. מספר העמודים אומר לכם כמה פגינציה התרחשה, אך הוא אינו מציין האם העמודות נשארות יחד או האם הטקסט קריא. הגדלים שנמדדו בדוגמה הגיעו מ‑Poppler pdfinfo לאחר הרצה מורשית על Java 11.0.2. תצוגות העמודים נוצרו בנפרד. אף שלב אינו מדד ביצועים, ואף אחד אינו מחליף סקירה של הדוח האמיתי.

הפרידו טענות על שוליים מטענות על קיבוץ. בדיקה נפרדת ב‑26.10 שהגדירה את השוליים של PdfConvertOptions ל‑36 נקודות יצרה רינדורים זהים לפלט ברירת המחדל של הגיליון. השוואה זו ולכן אינה מבטיחה דריסת שוליים דרך נתיב זה. אם שוליים מפורשים הם דרישה, חקרו ואמתו אותם באופן עצמאי לפני הצגתם כחלק מהפתרון.

סיכום

הריצו את ארבע השיטות על חוברת העבודה המסופקת, ולאחר מכן השוו לדוח מאושר אמיתי. בחרו במדיניות הקיבוץ בהתאם לצרכי הקורא ולדרישות גודל העמוד של מערכת הקבלה. אשרו את הריווח והממדים הפיזיים לפני קביעתם כברירת מחדל. שמרו את הבסיס כך שהשדרוג לגרסה הבאה יכלול השוואה קונקרטית.

משאבים נוספים