Les commentaires sont utilisés dans les documents Word, DOCX ou DOC, pour suggérer des améliorations et des modifications. Explorons comment insérer des commentaires ainsi que supprimer ou supprimer des commentaires par programmation à l’aide de Java. Vous pouvez ajouter le nom de l’auteur, les initiales, le texte du commentaire, la date et l’heure en fonction de vos besoins. Nous effectuerons toutes ces tâches à l’aide de l’API Aspose.Words for Java.
Ici, nous allons apprendre les cas d’utilisation suivants liés aux commentaires dans les documents Word :
- Insérer un commentaire dans un document Word existant à l’aide de Java
- Insérer un commentaire dans un nouveau document Word à l’aide de Java
- Supprimer des commentaires spécifiques d’un document Word à l’aide de Java
- Supprimer tous les commentaires des documents Word à l’aide de Java
Insérer ou supprimer des commentaires dans les fichiers Word (DOCX/DOC) API – Installation
Vous pouvez télécharger la dernière version de l’API Aspose.Words for Java à partir de la section Téléchargements ou du référentiel Maven, selon les configurations mentionnées ci-dessous :
Repository:
<repositories>
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.com/repo/</url>
</repository>
</repositories>
Dependency:
<dependencies>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-words</artifactId>
<version>20.6</version>
<classifier>jdk17</classifier>
</dependency>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-words</artifactId>
<version>20.7</version>
<classifier>javadoc</classifier>
</dependency>
</dependencies>
L’API a donc été configurée maintenant et nous pouvons continuer à explorer différents cas d’utilisation de l’utilisation de commentaires dans des documents Word.
Insérer un commentaire dans un document Word existant à l’aide de Java
Vous pouvez insérer ou ajouter des commentaires dans des fichiers Microsoft Word existants, DOCX ou DOC, avec l’API Aspose.Words for Java. Cela peut être utile lors de l’examen de documents, comme un superviseur peut suggérer plusieurs changements ou améliorations sur un rapport de faisabilité. De plus, toute personne disposant des autorisations de modification d’un document Word peut travailler avec des commentaires. Vous devez suivre les étapes ci-dessous pour insérer des commentaires dans un fichier Word (DOCX/DOC) :
- Charger le fichier DOCX existant avec la classe Document
- Créer un commentaire
- Enregistrer le fichier DOCX
L’extrait de code suivant montre comment insérer un commentaire dans un document Word à l’aide de Java :
// Charger le document word source
Document doc = new Document(dataDir + "Comments.docx");
// Initialiser l'objet DocumentBuilder
DocumentBuilder builder = new DocumentBuilder(doc);
// Créer un nouveau commentaire
Comment comment = new Comment(doc, "Aspose", "Initials", new java.util.Date());
builder.getCurrentParagraph().appendChild(comment);
comment.getParagraphs().add(new com.aspose.words.Paragraph(doc));
comment.getFirstParagraph().getRuns().add(new com.aspose.words.Run(doc, "Sample Comment"));
// Enregistrer le fichier de sortie
doc.save(dataDir + "Comments_Output.docx");
La capture d’écran ci-dessous montre un exemple de commentaire ajouté dans des documents Word existants :
Insérer un commentaire dans un nouveau document Word à l’aide de Java
Les commentaires sont également utiles lors de la création d’un nouveau document Word. Par exemple, certains textes peuvent nécessiter une élaboration qui peut être expliquée à l’aide de commentaires. De même, il pourrait y avoir des centaines de cas d’utilisation où les commentaires peuvent aider lors de la création d’un nouveau fichier DOCX. Vous pouvez facilement ajouter ou insérer des commentaires en suivant les étapes ci-dessous :
- Initialiser l’objet DocumentBuilder
- Ajouter un exemple de texte
- Créer un commentaire personnalisé
- Enregistrer le fichier DOCX
L’extrait de code ci-dessous montre comment insérer des commentaires lors de la création d’un nouveau document Word à partir de zéro, en utilisant Java :
// Initialiser un nouveau document word
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Ajouter du texte
builder.write("Some text is added.");
// Créer un nouveau commentaire
Comment comment = new Comment(doc, "Aspose", "Initials", new java.util.Date());
builder.getCurrentParagraph().appendChild(comment);
comment.getParagraphs().add(new com.aspose.words.Paragraph(doc));
comment.getFirstParagraph().getRuns().add(new com.aspose.words.Run(doc, "Sample Comment"));
// Enregistrer le fichier DOCX de sortie
doc.save(dataDir + "Comments_Output.docx");
La capture d’écran ci-dessous montre la sortie où le commentaire est ajouté sur le nouveau document Word :
Supprimer des commentaires spécifiques d’un document Word à l’aide de Java
Les commentaires sont souvent supprimés lorsque des améliorations ou des modifications suggérées sont incorporées dans le document Word. Lorsque vous devez supprimer des commentaires spécifiques, vous pouvez suivre les étapes ci-dessous :
- Charger le document word source
- Spécifiez le nom de l’auteur
- Supprimer les commentaires de l’auteur spécifié
L’extrait de code ci-dessous montre comment supprimer des commentaires spécifiques d’un fichier Word à l’aide de Java :
// Ouvrez le document.
Document doc = new Document(dataDir + "Comments.docx");
String authorName = "Aspose";
// Recueillir tous les commentaires dans le document
NodeCollection comments = doc.getChildNodes(NodeType.COMMENT, true);
// Parcourez tous les commentaires et supprimez ceux écrits par l'auteur Aspose.
for (int i = comments.getCount() - 1; i >= 0; i--) {
Comment comment = (Comment) comments.get(i);
if (comment.getAuthor().equals(authorName))
comment.remove();
}
// Enregistrer le fichier DOCX de sortie
doc.save(dataDir + "output.docx");
Supprimer tous les commentaires des documents Word à l’aide de Java
Tous les commentaires du document Word peuvent être supprimés à la fois. Vous pouvez suivre les étapes ci-dessous pour supprimer tous les commentaires :
- Ouvrir le fichier word docx
- Collecter tous les commentaires dans le fichier
- Supprimer tous les commentaires
L’extrait de code suivant explique comment supprimer tous les commentaires des documents Word à l’aide de Java :
// Ouvrez le document.
Document doc = new Document(dataDir + "Comments.docx");
// Recueillir tous les commentaires dans le document
NodeCollection comments = doc.getChildNodes(com.aspose.words.NodeType.COMMENT, true);
// Supprimer tous les commentaires.
comments.clear();
doc.save(dataDir + "output.docx");
Conclusion
Pour résumer, nous avons appris à ajouter, insérer, supprimer ou supprimer des commentaires de documents Word par programmation avec Java. En cas de doute ou de confusion, veuillez nous contacter sur Forum d’assistance gratuit.