הסרת מחבר, כותרת ותכונות מותאמות אישית בעת המרת קבצי Office ב-Java

מאגר דוגמה נלווה (בהמתנה לפרסום): remove-office-properties-java

הסרת מטא‑נתוני Office היא זרימת עבודה של GroupDocs.Conversion עבור Java שמוחקת את תכונות המסמך המקוריות בזמן ייצוא קבצי Office. היא מתמודדת עם חלק קטן אך קל להחטיא של אספקת מסמכים: הקובץ עשוי להיראות מוכן בעוד שהמחבר, הכותרת או הפנייה הפנימית עדיין מציינים טיוטה. מאמר זה עוקב אחרי דוח Word דרך ההחלטה הזו, ולאחר מכן מיישם את אותה מדיניות על Excel ו‑PowerPoint. הקוד נעוץ בגרסה 26.10 ומשתמש בקבצים קלט פיקטיביים.

מבוא

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

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

למה ניקוי תכונות חשוב בזמן הייצוא

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

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

מתי עלי לנקות תכונות של Office?

נקה תכונות מקור כאשר מדיניות האספקה שלך מחריגה ממחבר פנימי, כותרות טיוטה או שדות הפנייה מותאמים אישית מהדוח המיוצא. הגדר את אפשרויות הטעינה לפני יצירת ה‑Converter, והשווה פלטים משומרים ונקיים באמצעות סמנים ידועים. הדוגמה מכסה מקורות DOCX, XLSX ו‑PPTX. בדוק תוכן גלוי בנפרד, והתר את שדות PDF שנוצרים על‑ידי המערכת כגון Producer להישאר לאחר הניקוי.

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

הפרויקט המלא משתמש ב‑JDK 11, Maven ו‑GroupDocs.Conversion עבור Java 26.10. תיקיית המסמכים שלו מכילה שלושה דוחות פיקטיביים. נדרשת רישיון המכסה גרסה זו לאימות בלתי מוגבל; מגבלות הערכה עשויות למנוע את סיום ההשוואה המלאה. הקוד משאיר את הגדרת הרישיון מחוץ לשיטות הפונקציונליות ומשתמש במחליף במקור המפוזר. אל תכניס קובץ רישיון לפרויקט.

התקנה

קובץ pom.xml של הפרויקט מצהיר על מאגר Java של GroupDocs והתלות המוצגת למטה. הפעל את פקודת Maven מתיקיית הפרויקט הזו. בלוקים של Java במאמר זה הם גופי שיטות מהדוגמה המאומתת; הם מניחים את ה‑imports הרלוונטיים, תיקיית Result קיימת ופרמטר בוליאני בשם clear.

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

שלב 1: הפיכת מדיניות התכונות למפורשת

שלוש השיטות מקבלות את אותה מדיניות בוליאנית. העברת false משמרת את הגדרות המקור לריצה בקרה; העברת true מבקשת להסיר את שתי הקטגוריות. ב‑WordProcessingLoadOptions, השיטות הן setClearBuiltInDocumentProperties ו‑setClearCustomDocumentProperties. SpreadsheetLoadOptions ו‑PresentationLoadOptions חושפות את הפקדים המתאימים. העקביות מאפשרת לך לבדוק מדיניות אחת על פני שלושה משפחות קלט שונות מבלי להסתיר איזו טוענת פותחת כל קובץ.

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

שלב 2: ייצוא דוח ה‑Word

נתיב ה‑Word מתחיל ב‑documents/report.docx. הוא מכיל תכונות מסמך פיקטיביות ודוח קצר גלוי. convertWord יוצר אפשרויות טיפוסיות, מקצה את המדיניות ומספקת את האפשרויות דרך קונסטרקטור ה‑Converter. השיטה כותבת PDF לאספקה ו‑DOCX לעיון בתכונות. שני הקבצים הם קבצי פלט חדשים; המקור אינו נכתב מחדש על‑ידי דוגמה זו.

WordProcessingLoadOptions options = new WordProcessingLoadOptions();
options.setClearBuiltInDocumentProperties(clear);
options.setClearCustomDocumentProperties(clear);
String target = "Result/docx-" + (clear ? "clean" : "retained");
try (Converter converter = new Converter("documents/report.docx", () -> options)) {
    converter.convert(target + ".pdf", new PdfConvertOptions());
    converter.convert(target + ".docx", new WordProcessingConvertOptions());
}

שם היעד מסתיים ב‑retained או clean, בהתאם לפרמטר הבוליאני. הבחנה זו מונעת מהשתי ריצות לדרוס זו את זו. היא גם מקלה על ביקורת ידנית: פתח את ה‑PDF כדי לבדוק את ההצגה ובדוק את ה‑Office המתאים כדי לבדוק אחסון תכונות. בריצה המאומתת, Author ו‑Title נשארו ב‑PDF המשומר ונעלמו מה‑PDF הנקי. מידע ה‑Producer נשאר, שהוא שדה נפרד שנוצר על‑ידי הפלט.

שלב 3: יישום המדיניות ל‑Excel ול‑PowerPoint

לדו"ח Excel, השתמש ב‑SpreadsheetLoadOptions במקום להשתמש במטען ה‑Word. קוד ההמרה משמר את דגלי התכונות זהים ומשנה את משפחת הקלט ואת אפשרויות הבקרה באותו פורמט. קובץ ה‑XLSX המוכלל כולל רווחים ריקים בכוונה, ולכן הפגינציה שלו אינה חלק מהטענה על מטא‑נתונים. בדוק את דפי ה‑PDF וכן את תוצאת התכונות כאשר אתה מתאים אותו לדוח עסקי. הצלחת התכונה אינה קובעת שגיליון רחב מודפס כמתוכנן.

SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
options.setClearBuiltInDocumentProperties(clear);
options.setClearCustomDocumentProperties(clear);
String target = "Result/xlsx-" + (clear ? "clean" : "retained");
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
    converter.convert(target + ".pdf", new PdfConvertOptions());
    converter.convert(target + ".xlsx", new SpreadsheetConvertOptions());
}

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

PresentationLoadOptions options = new PresentationLoadOptions();
options.setClearBuiltInDocumentProperties(clear);
options.setClearCustomDocumentProperties(clear);
String target = "Result/pptx-" + (clear ? "clean" : "retained");
try (Converter converter = new Converter("documents/report.pptx", () -> options)) {
    converter.convert(target + ".pdf", new PdfConvertOptions());
    converter.convert(target + ".pptx", new PresentationConvertOptions());
}

שלב 4: אימות התוצאה במקום לנחש

PropertyChecks בודק את חלקי התכונות של ששת קבצי ה‑Office הבקרתיים. הוא מחפש את Internal Review Team, Quarterly Review Draft ו‑INTERNAL-REF-2610. עותקים משומרים חייבים להכיל ערכים ידועים אלה, ועותקים נקיים חייבים להשמיטם. היישום מדפיס שורת PASS לכל קובץ שנבדק ומדווח על כשל אם ההשוואה אינה תואמת לציפייה. בדיקה זו קשורה למתקנים הפיקטיביים, ולא לטענה שמטא‑נתונים שרירותיים זוהו ונותחו.

בנוסף, בדקנו את Author ו‑Title של ה‑PDF באמצעות Poppler pdfinfo. שני השדות נעלמו בייצוא הנקי מכל שלושת מקורות ה‑Office. שדה ה‑Producer שנוצר נשאר. תוצאה זו שימושית בדיוק מכיוון שהיא מצמצמת את הטענה: תכונות המקור המבוקשות הוסרו, בעוד שה‑PDF עדיין יכול לזהות את התוכנה שכתבה אותו. אל תהפוך זאת להבטחה של מילון מטא‑נתונים ריק לחלוטין.

דוגמה מלאה עובדת

OfficeMetadataDemo הוא נקודת הכניסה בפרויקט Maven הנלווה. הוא יוצר Result/, מריץ את שלוש שיטות ההמרה עם false ו‑true, ומפעיל PropertyChecks. כלי העזר נשמר נפרד משיטות הפונקציונליות כדי שהקטעי קוד יישארו קריאים. RUN.md מסביר כיצד להחיל רישיון מקומי משלך. המסמכים המוכללים פיקטיביים וניתנים לשימוש ללא תלות בנתוני לקוח.

יישומים בעולם האמיתי

אספקת דוח ללקוח

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

הגשות Office משולבות

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

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

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

פתרון בעיות נפוצות

אם ההדגמה המלאה נעצרת במצב הערכה, החל רישיון המכסה 26.10 בעותק המקומי שלך והרץ אותה שוב. אם סמן נשאר בטקסט גלוי, זה מחוץ לבדיקת אחסון התכונה. אם ניקוי קלט PDF הוא דרישתך, אל תחליף זאת בדוגמה זו: בדיקה נפרדת של 26.10 נכשלה עם CreationDate value is empty כאשר ניקוי מובנה היה מופעל. תחום המקור שנבדק במאמר הוא Office.

סיכום

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

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