Видалення автора, назви та користувацьких властивостей під час конвертації офісних файлів у Java

Супутнє репозиторій прикладів (очікує публікації): remove-office-properties-java

Видалення метаданих офісних документів — це робочий процес GroupDocs.Conversion для Java, який очищає властивості вихідного документа під час експорту офісних файлів. Це вирішує невелику, але легко пропускану частину доставки документу: файл може виглядати готовим, хоча його автор, назва чи внутрішнє посилання все ще описують чернетку. У цій статті розглядається Word‑звіт, після чого застосовується те ж саме правило до Excel та PowerPoint. Код прив’язаний до версії 26.10 і використовує вигадані вхідні файли.

Вступ

Уявімо, що звіт проходить внутрішній процес рецензування. Видимий заголовок правильний, цифри схвалені, і PDF відкривається нормально. Жодна з цих перевірок не підказує, що містить поле Author. Робоча книга або презентація також можуть мати користувацьку властивість, яка має сенс у команді, але нічого не додає зовнішньому результату. Ставте цю інформацію як рішення експорту, а не як сюрприз, виявлений одержувачем.

Зразок створює дві версії кожного звіту. Одна зберігає властивості джерела; інша запитує їх видалення (вбудованих і користувацьких). Він також записує копію Office у тому ж форматі для кожного запуску, щоб перевірені значення можна було переглянути окремо. Це навмисно спостережний приклад. Ми хочемо отримати доказ, що налаштування змінили вихід, а не припущення, засноване лише на вигляді першої сторінки.

Чому очищення властивостей важливе під час експорту

Крок експорту — це момент, коли вихідний документ стає артефактом доставки. Це корисне місце, щоб вирішити, чи повинні внутрішні властивості подорожувати разом із вмістом. GroupDocs.Conversion для Java 26.10 надає окремі керування для вбудованих і користувацьких властивостей документа. Ви можете застосувати їх під час завантаження офісного джерела, перед збереженням PDF. Приклад вмикає обидві категорії для варіанту зовнішньої копії.

Це не заміна перегляду самого документа. Ім’я автора може також з’явитися у абзаці, клітинці, нотатці чи вбудованому файлі. Ці місця потребують окремої обробки. Я б описав цю функцію як очищення властивостей у конвеєрі експорту, бо таке формулювання відповідає тому, що код фактично демонструє. Це також запобігає обіцянкам ширшого результату конфіденційності, ніж охоплює тест.

Коли слід очищати властивості Office?

Очищайте властивості джерела, коли ваша політика доставки виключає внутрішнє авторство, назви чернеток або користувацькі поля посилань з експортованого звіту. Налаштуйте параметри завантаження перед створенням Converter і порівняйте збережені та очищені результати, використовуючи відомі маркери. Приклад охоплює джерела DOCX, XLSX і PPTX. Окремо перегляньте видимий вміст і дозволяйте полям PDF, згенерованим під час виводу (наприклад, Producer), залишатися після очищення.

Передумови

Повний проєкт використовує JDK 11, Maven і GroupDocs.Conversion для Java 26.10. У його каталозі documents містяться три вигадані звіти. Потрібна ліцензія, що покриває цей випуск, для необмеженої верифікації; обмеження оцінки можуть завадити завершенню повного порівняння. Код розміщує налаштування ліцензії поза методами функціоналу і використовує заповнювач у розповсюджуваному коді. Не розміщуйте файл ліцензії у проєкті.

Встановлення

У файлі pom.xml проєкту оголошено репозиторій GroupDocs Java і залежність, показану нижче. Запустіть команду Maven у цьому каталозі проєкту. Java‑блоки в статті — це тіла методів із перевіреного зразка; вони передбачають відповідні імпорти, існуючий каталог Result і булевий параметр clear.

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

Крок 1: Зробити політику властивостей явною

Три методи отримують один і той же булевий параметр policy. Передача 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());
}

Назва target закінчується 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 для кожного перевіреного файлу і повідомляє про помилку, якщо порівняння не відповідає очікуванню. Ця перевірка прив’язана до вигаданих фікстур, а не до твердження, що довільні метадані були виявлені та класифіковані.

Ми також інспектували PDF‑поля Author і Title за допомогою Poppler pdfinfo. Обидва поля зникли в очищених експортних файлах усіх трьох джерел Office. Згенероване поле Producer залишилося. Цей результат корисний саме тому, що він уточнює заяву: запитані властивості джерела були видалені, тоді як PDF все ще може ідентифікувати програмне забезпечення, що його створило. Не перетворюйте це на обіцянку повністю порожнього словника метаданих.

Повний робочий приклад

OfficeMetadataDemo — це точка входу у супутньому Maven‑проєкті. Він створює Result/, запускає всі три методи конвертації з false і true, і викликає PropertyChecks. Утиліта розділена від методів функціоналу, щоб фрагменти конвертації залишалися читабельними. RUN.md пояснює, як застосувати власну ліцензію локально. Включені документи вигадані і їх можна використовувати без залежності від даних клієнта.

Реальні сценарії застосування

Доставка звітів клієнтам

Сервіс експорту може створювати зовнішній PDF лише після затвердження звіту. Застосуйте політику властивостей у цьому шляху конвертації і залиште оригінальний офісний документ у його існуючому внутрішньому розташуванні. Уникайте включення збережених контрольних копій у пакет для клієнта. Вони існують лише для того, щоб тест був спостережним.

Змішані офісні подання

Команда може отримувати текстові звіти, таблиці та презентаційні підсумки. Використовуйте типізований завантажувач для кожної сімейства вхідних файлів і послідовно застосовуйте задокументовану політику. Ми залишимо рішення про сімейство файлів видимим у коді, а не будемо робити висновки про підтримку лише з одного успішного прикладу DOCX. Додайте представницькі фікстури при впровадженні іншого шаблону.

Кращі практики та поради

Тримайте очищення і редагування окремо у вимогах. Визначте, які властивості потрібні для provenance, перед їх видаленням. Зберігайте результати доставки окремо від внутрішніх контрольних копій і розглядайте налаштування ліцензії як локальну конфігурацію. При оновленні SDK повторно запускайте як збережені, так і чисті варіанти, щоб неочікувана зміна була видна з обох боків порівняння.

Усунення типових проблем

Якщо повна демонстрація зупиняється в режимі оцінки, застосуйте ліцензію, що покриває 26.10, у вашій локальній копії і запустіть її знову. Якщо маркер залишився у видимому тексті, це поза межами перевірки зберігання властивостей. Якщо очищення вхідного PDF є вашою вимогою, не підмінюйте його в цьому прикладі: окрема перевірка 26.10 завершилася помилкою «CreationDate value is empty» при увімкненому вбудованому очищенні. Область тестованого джерела в статті — це Office.

Висновок

Почніть з наданих фікstur і інспектуйте збережені та очищені пари. Перевірте названі властивості джерела, потім перегляньте фактичний вміст PDF. Замініть фікстури на затверджені шаблони лише після того, як порівняння працює як очікувалося. Тримайте політику експорту близько до параметрів завантаження, щоб наступний розробник міг бачити, які властивості залишають систему.

Додаткові ресурси