Supprimer l’auteur, le titre et les propriétés personnalisées lors de la conversion de fichiers Office en Java
Dépôt d’exemple compagnon (publication en attente) : remove-office-properties-java
La suppression des métadonnées Office est un flux de travail GroupDocs.Conversion pour Java qui efface les propriétés du document source lors de l’exportation des fichiers Office. Il traite d’une petite partie souvent négligée de la livraison de documents : le fichier peut sembler prêt alors que son auteur, son titre ou sa référence interne décrivent encore un brouillon. Cet article suit un rapport Word à travers cette décision, puis applique la même politique à Excel et PowerPoint. Le code est fixé à la version 26.10 et utilise des fichiers d’entrée fictifs.
Introduction
Supposons qu’un rapport quitte un processus de révision interne. L’en-tête visible est correct, les figures sont approuvées et le PDF s’ouvre normalement. Aucun de ces contrôles ne vous indique ce que contient le champ Auteur. Un classeur ou une présentation peut également contenir une propriété personnalisée qui a du sens au sein d’une équipe mais n’ajoute rien au livrable externe. Considérez cette information comme une décision d’exportation plutôt que comme une surprise découverte par le destinataire.
L’exemple produit deux versions de chaque rapport. L’une conserve les propriétés source ; l’autre demande la suppression des propriétés intégrées et personnalisées. Il écrit également une copie Office au même format pour chaque exécution afin que les valeurs vérifiées puissent être inspectées indépendamment. Il s’agit d’un exemple délibérément observable. Nous voulons des preuves que les paramètres ont modifié la sortie, et non une supposition basée sur l’apparence de la première page.
Pourquoi le nettoyage des propriétés est important lors de l’exportation
L’étape d’exportation est celle où un document source devient un artefact de livraison. Cela en fait un endroit utile pour décider si les propriétés internes doivent accompagner le contenu. GroupDocs.Conversion pour Java 26.10 expose des contrôles séparés pour les propriétés de document intégrées et personnalisées. Vous pouvez les appliquer lors du chargement d’une source Office, avant d’enregistrer le PDF. L’exemple active les deux catégories pour la variante de copie externe.
Ce n’est pas un substitut à la révision du document lui-même. Un nom d’auteur peut également apparaître dans un paragraphe, une cellule, une note ou un fichier intégré. Ces emplacements nécessitent une prise en charge séparée. Je décrirais la fonctionnalité comme un nettoyage des propriétés dans un pipeline d’exportation, car cette formulation correspond à ce que le code prouve réellement. Cela évite également de promettre un résultat de confidentialité plus large que le test ne couvre.
Quand devrais-je effacer les propriétés Office ?
Effacez les propriétés source lorsque votre politique de livraison exclut la paternité interne, les titres de brouillon ou les champs de référence personnalisés du rapport exporté. Configurez les options de chargement avant de créer le Converter, et comparez les sorties conservées et nettoyées à l’aide de marqueurs connus. L’exemple couvre les sources DOCX, XLSX et PPTX. Examinez le contenu visible séparément, et autorisez les champs PDF générés tels que Producer à rester après le nettoyage.
Prérequis
Le projet complet utilise JDK 11, Maven et GroupDocs.Conversion pour Java 26.10. Son répertoire documents contient trois rapports fictifs. Une licence couvrant cette version est nécessaire pour une vérification sans restriction ; les limites d’évaluation peuvent empêcher la comparaison complète de se terminer. Le code maintient la configuration de licence en dehors des méthodes fonctionnelles et utilise un espace réservé dans le code distribué. Ne placez pas de fichier de licence dans le projet.
Installation
Le pom.xml du projet déclare le dépôt Java GroupDocs et la dépendance indiquée ci-dessous. Exécutez la commande Maven depuis ce répertoire de projet. Les blocs Java de cet article sont des corps de méthode provenant de l’exemple vérifié ; ils supposent les importations pertinentes, un répertoire Result existant et un paramètre booléen nommé clear.
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion</artifactId>
<version>26.10</version>
</dependency>
mvn compile exec:java
Étape 1 : Rendre la politique de propriétés explicite
Les trois méthodes reçoivent la même politique booléenne. Passer false conserve les paramètres source pour une exécution de contrôle ; passer true demande la suppression des deux catégories. Dans WordProcessingLoadOptions, les méthodes sont setClearBuiltInDocumentProperties et setClearCustomDocumentProperties. SpreadsheetLoadOptions et PresentationLoadOptions exposent les contrôles correspondants. Cette cohérence vous permet de réviser une même politique à travers trois familles d’entrées distinctes sans masquer quel chargeur ouvre chaque fichier.
L’exécution avec propriétés conservées est importante. Si le marqueur source n’atteint jamais une sortie ordinaire, une sortie nettoyée vide constitue une preuve faible. La démonstration vérifie donc chaque marqueur dans la copie Office conservée et son absence dans la copie nettoyée. Cela fournit à la comparaison un contrôle positif. Conservez un test similaire lorsque vous introduisez un nouveau modèle de document ou modifiez la version de la dépendance.
Étape 2 : Exporter le rapport Word
Le chemin Word commence par documents/report.docx. Il possède des propriétés de document fictives et un court rapport visible. convertWord crée des options typées, assigne la politique et fournit ces options via le constructeur Converter. La méthode écrit un PDF pour la livraison et une copie DOCX pour l’inspection des propriétés. Les deux sont de nouveaux fichiers de sortie ; la source n’est pas réécrite par cet exemple.
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());
}
Le nom de la cible se termine par retained ou clean, selon l’argument booléen. Cette distinction empêche les deux exécutions de s’écraser mutuellement. Elle facilite également la révision manuelle : ouvrez le PDF pour inspecter la présentation et inspectez le contrôle Office correspondant pour vérifier le stockage des propriétés. Dans l’exécution vérifiée, Author et Title sont restés dans le PDF conservé et ont disparu du PDF nettoyé. L’information Producer est restée, ce qui est un champ généré séparément.
Étape 3 : Appliquer la politique à Excel et PowerPoint
Pour un rapport Excel, utilisez SpreadsheetLoadOptions plutôt que de réutiliser le chargeur Word. Le code de conversion conserve les mêmes indicateurs de propriétés et change la famille d’entrée ainsi que les options de contrôle au même format. Le XLSX inclus possède des espaces vides délibérés, donc sa pagination ne fait pas partie de l’assertion de métadonnées. Vérifiez les pages PDF ainsi que le résultat des propriétés lors de l’adaptation à un rapport d’affaires. Le succès des propriétés n’établit pas qu’une feuille large s’imprime comme prévu.
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 suit la même politique de chargement avec PresentationLoadOptions. La diapositive d’exemple contient du texte de rapport fictif, tandis que son auteur, son titre et sa référence personnalisée résident dans les parties de propriétés du document. La méthode enregistre le PDF ainsi que le PPTX afin que la comparaison des propriétés reste indépendante du rendu des diapositives. Elle n’inspecte pas les notes du présentateur ni les objets intégrés. Si ceux-ci sont importants pour votre processus de livraison, incluez-les dans une révision séparée avant la publication.
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());
}
Étape 4 : Vérifier le résultat au lieu de deviner
PropertyChecks inspecte les parties de propriétés des six fichiers de contrôle Office. Il recherche Internal Review Team, Quarterly Review Draft et INTERNAL-REF-2610. Les copies conservées doivent contenir ces valeurs connues, et les copies nettoyées doivent les omettre. L’application affiche une ligne PASS pour chaque fichier vérifié et échoue si une comparaison ne correspond pas à cette attente. Cette vérification est liée aux fixtures fictives, et non à une affirmation selon laquelle des métadonnées arbitraires auraient été découvertes et classées.
Nous avons également inspecté les champs PDF Author et Title avec Poppler pdfinfo. Les deux champs ont disparu dans les exportations nettoyées de toutes les trois sources Office. Le champ Producer généré est resté. Ce résultat est utile précisément parce qu’il restreint la revendication : les propriétés source demandées ont été supprimées, tandis que le PDF peut toujours identifier le logiciel qui l’a créé. Ne transformez pas cela en une promesse d’un dictionnaire de métadonnées entièrement vide.
Exemple complet fonctionnel
OfficeMetadataDemo est le point d’entrée du projet Maven compagnon. Il crée Result/, exécute les trois méthodes de conversion avec false et true, et invoque PropertyChecks. L’utilitaire est maintenu séparé des méthodes fonctionnelles afin que les extraits de conversion restent lisibles. RUN.md explique comment appliquer votre propre licence localement. Les documents inclus sont fictifs et peuvent être utilisés sans dépendance aux données client.
Applications réelles
Livraison de rapports client
Un service d’exportation peut produire le PDF externe uniquement après l’approbation d’un rapport. Appliquez la politique de propriétés dans ce chemin de conversion et conservez le document Office original à son emplacement interne existant. Évitez d’inclure les contrôles conservés dans le paquet client. Ils existent ici pour rendre les tests observables.
Soumissions Office mixtes
Une équipe peut recevoir des rapports narratifs, des feuilles de calcul et des résumés de présentations. Utilisez un chargeur typé pour chaque famille d’entrée et appliquez une politique documentée de manière cohérente. Nous garderions la décision de la famille de fichiers visible dans le code plutôt que d’inférer le support à partir d’un exemple DOCX réussi. Ajoutez des fixtures représentatives lors de l’introduction d’un autre modèle.
Bonnes pratiques et astuces
Séparez le nettoyage et la rédaction dans vos exigences. Décidez quelles propriétés sont nécessaires pour la provenance avant de les effacer. Stockez les sorties de livraison séparément des contrôles internes et traitez la configuration de licence comme une configuration locale. Lors de la mise à jour du SDK, relancez les variantes conservées et nettoyées afin qu’un changement inattendu soit visible de chaque côté de la comparaison.
Dépannage des problèmes courants
Si la démonstration complète s’arrête en mode évaluation, appliquez une licence couvrant la version 26.10 dans votre copie locale et relancez-la. Si un marqueur reste dans le texte visible, cela dépasse le contrôle de stockage de cette propriété. Si le nettoyage d’entrée PDF est votre exigence, ne le substituez pas dans cet exemple : un contrôle séparé 26.10 a échoué avec la valeur CreationDate vide lorsque le nettoyage intégré était activé. Le périmètre source testé de l’article est Office.
Conclusion
Commencez avec les fixtures fournies et inspectez les paires conservées et nettoyées. Vérifiez les propriétés source nommées, puis examinez le contenu réel du PDF. Remplacez les fixtures par des modèles approuvés uniquement après que cette comparaison se comporte comme prévu. Gardez la politique d’exportation proche des options de chargement afin que le développeur suivant puisse voir quelles propriétés quittent le système.