Comentários são usados em documentos do Word, DOCX ou DOC, para sugerir melhorias e modificações. Vamos explorar como inserir comentários, bem como excluir ou remover comentários programaticamente usando Java. Você pode adicionar o nome do autor, iniciais, texto do comentário, data e hora com base em seus requisitos. Iremos realizar todas essas tarefas usando a API Aspose.Words for Java.
Aqui aprenderemos os seguintes casos de uso relacionados a comentários em documentos do Word:
- Inserir comentário em documento do Word existente usando Java
- Inserir comentário em novo documento do Word usando Java
- Excluir comentários específicos do documento do Word usando Java
- Excluir todos os comentários de documentos do Word usando Java
Inserir ou excluir comentários em arquivos do Word (DOCX/DOC) API – Instalação
Você pode baixar a versão mais recente do Aspose.Words for Java API da seção Downloads ou do repositório Maven, conforme as configurações mencionadas abaixo:
Repositório:
<repositories>
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.com/repo/</url>
</repository>
</repositories>
Dependência:
<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>
Portanto, a API foi configurada agora e podemos prosseguir explorando diferentes casos de uso de trabalhar com comentários em documentos do Word.
Inserir comentário em documento do Word existente usando Java
Você pode inserir ou adicionar comentários em arquivos existentes do Microsoft Word, DOCX ou DOC, com Aspose.Words for Java API. Isso pode ser útil ao revisar documentos, como um supervisor pode sugerir várias mudanças ou melhorias em um relatório de viabilidade. Além disso, qualquer pessoa com permissões de edição de um documento do Word pode trabalhar com comentários. Você precisa seguir os passos abaixo para inserir comentários em arquivo word (DOCX/DOC):
- Carregar arquivo DOCX existente com a classe Document
- Criar um comentário
- Salvar arquivo DOCX
O trecho de código a seguir mostra como inserir um comentário em um documento do Word usando Java:
// Carregar documento do word de origem
Document doc = new Document(dataDir + "Comments.docx");
// Inicialize o objeto DocumentBuilder
DocumentBuilder builder = new DocumentBuilder(doc);
// Criar novo comentário
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"));
// Salvar arquivo de saída
doc.save(dataDir + "Comments_Output.docx");
A captura de tela abaixo mostra um comentário de amostra adicionado em documentos do Word existentes:
![Inserir comentário no word](images/CommentExisting-1024x535.png#center)
Inserir comentário em novo documento do Word usando Java
Os comentários também são úteis ao criar um novo documento do Word. Por exemplo, algum texto pode precisar de elaboração que pode ser explicada com a ajuda de comentários. Da mesma forma, pode haver centenas de casos de uso em que os comentários podem ajudar na criação de um novo arquivo DOCX. Você pode facilmente adicionar ou inserir comentários seguindo as etapas abaixo:
- Inicialize o objeto DocumentBuilder
- Adicionar texto de exemplo
- Criar um comentário personalizado
- Salvar arquivo DOCX
O trecho de código abaixo mostra como inserir comentários ao criar um novo documento do Word do zero, usando Java:
// Inicializar novo documento do Word
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Adicione algum texto
builder.write("Some text is added.");
// Criar novo comentário
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"));
// Salvar arquivo DOCX de saída
doc.save(dataDir + "Comments_Output.docx");
A captura de tela abaixo mostra a saída em que o comentário é adicionado no novo documento do Word:
![excluir comentário no word](images/CommentsNew-1024x415.png#center)
Excluir comentários específicos do documento do Word usando Java
Os comentários geralmente são excluídos quando as melhorias ou modificações sugeridas são incorporadas ao documento do Word. Quando você precisar excluir comentários específicos, siga as etapas abaixo:
- Carregar documento do word de origem
- Especifique o nome do autor
- Remover comentários do autor especificado
O trecho de código abaixo mostra como excluir comentários específicos de um arquivo de palavras usando Java:
// Abra o documento.
Document doc = new Document(dataDir + "Comments.docx");
String authorName = "Aspose";
// Colete todos os comentários no documento
NodeCollection comments = doc.getChildNodes(NodeType.COMMENT, true);
// Examine todos os comentários e remova aqueles escritos pelo autor do Aspose.
for (int i = comments.getCount() - 1; i >= 0; i--) {
Comment comment = (Comment) comments.get(i);
if (comment.getAuthor().equals(authorName))
comment.remove();
}
// Salvar arquivo DOCX de saída
doc.save(dataDir + "output.docx");
Excluir todos os comentários de documentos do Word usando Java
Todos os comentários do documento do Word podem ser excluídos de uma só vez. Você pode seguir as etapas abaixo para remover todos os comentários:
- Abrir arquivo docx do word
- Colete todos os comentários no arquivo
- Excluir todos os comentários
O trecho de código a seguir explica como excluir todos os comentários de documentos do Word usando Java:
// Abra o documento.
Document doc = new Document(dataDir + "Comments.docx");
// Colete todos os comentários no documento
NodeCollection comments = doc.getChildNodes(com.aspose.words.NodeType.COMMENT, true);
// Remova todos os comentários.
comments.clear();
doc.save(dataDir + "output.docx");
Conclusão
Para resumir, aprendemos como adicionar, inserir, excluir ou remover comentários de documentos do Word programaticamente com Java. Se você tiver alguma dúvida ou confusão, entre em contato conosco em Free Support Forum.