Los comentarios se utilizan en documentos de Word, DOCX o DOC, para sugerir mejoras y modificaciones. Exploremos cómo insertar comentarios, así como eliminar o eliminar comentarios mediante programación usando Java. Puede agregar el nombre del autor, las iniciales, el texto del comentario, la fecha y la hora según sus requisitos. Realizaremos todas estas tareas utilizando Aspose.Words for Java API.
Aquí aprenderemos los siguientes casos de uso relacionados con comentarios en documentos de Word:
- Insertar comentario en un documento de Word existente usando Java
- Insertar comentario en un nuevo documento de Word usando Java
- Eliminar comentarios específicos de un documento de Word usando Java
- Eliminar todos los comentarios de documentos de Word usando Java
Insertar o eliminar comentarios en archivos de Word (DOCX/DOC) API – Instalación
Puede descargar la última versión de Aspose.Words for Java API desde la sección Descargas o desde el repositorio de Maven, según las configuraciones que se mencionan a continuación:
Repositorio:
<repositories>
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.com/repo/</url>
</repository>
</repositories>
Dependencia:
<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>
Entonces, la API se ha configurado ahora y podemos proceder a explorar diferentes casos de uso para trabajar con comentarios en documentos de Word.
Insertar comentario en un documento de Word existente usando Java
Puede insertar o agregar comentarios en archivos existentes de Microsoft Word, DOCX o DOC, con Aspose.Words for Java API. Esto puede ser útil cuando se revisan documentos, como cuando un supervisor puede sugerir varios cambios o mejoras en un informe de viabilidad. Además, cualquier persona con permisos de edición de un documento de Word puede trabajar con comentarios. Debe seguir los pasos a continuación para insertar comentarios en un archivo de Word (DOCX/DOC):
- Cargue el archivo DOCX existente con la clase de documento
- crear un comentario
- Guardar archivo DOCX
El siguiente fragmento de código muestra cómo insertar un comentario en un documento de Word usando Java:
// Cargar documento de Word de origen
Document doc = new Document(dataDir + "Comments.docx");
// Inicializar objeto DocumentBuilder
DocumentBuilder builder = new DocumentBuilder(doc);
// Crear nuevo comentario
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"));
// Guardar archivo de salida
doc.save(dataDir + "Comments_Output.docx");
La siguiente captura de pantalla muestra un comentario de muestra agregado en documentos de Word existentes:
Insertar comentario en un nuevo documento de Word usando Java
Los comentarios también son útiles al crear un nuevo documento de Word. Por ejemplo, algún texto puede necesitar elaboración que se pueda explicar con la ayuda de un comentario. Del mismo modo, podría haber cientos de casos de uso en los que los comentarios pueden ayudar al crear un nuevo archivo DOCX. Puede agregar o insertar comentarios fácilmente siguiendo los pasos a continuación:
- Inicializar objeto DocumentBuilder
- Agregar texto de muestra
- Crear un comentario personalizado
- Guardar archivo DOCX
El fragmento de código a continuación muestra cómo insertar comentarios al crear un nuevo documento de Word desde cero, usando Java:
// Inicializar nuevo documento de Word
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Agrega algo de texto
builder.write("Some text is added.");
// Crear nuevo comentario
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"));
// Guardar archivo DOCX de salida
doc.save(dataDir + "Comments_Output.docx");
La siguiente captura de pantalla muestra la salida donde se agrega el comentario en el nuevo documento de Word:
Eliminar comentarios específicos de un documento de Word usando Java
Los comentarios a menudo se eliminan cuando se incorporan mejoras o modificaciones sugeridas en el documento de Word. Cuando necesite eliminar comentarios específicos, puede seguir los pasos a continuación:
- Cargar documento de Word de origen
- Especifique el nombre del autor
- Eliminar comentarios del autor especificado
El fragmento de código a continuación muestra cómo eliminar comentarios específicos de un archivo de Word usando Java:
// Abra el documento.
Document doc = new Document(dataDir + "Comments.docx");
String authorName = "Aspose";
// Recopilar todos los comentarios en el documento
NodeCollection comments = doc.getChildNodes(NodeType.COMMENT, true);
// Revise todos los comentarios y elimine los escritos por el autor de Aspose.
for (int i = comments.getCount() - 1; i >= 0; i--) {
Comment comment = (Comment) comments.get(i);
if (comment.getAuthor().equals(authorName))
comment.remove();
}
// Guardar archivo DOCX de salida
doc.save(dataDir + "output.docx");
Eliminar todos los comentarios de documentos de Word usando Java
Todos los comentarios del documento de Word se pueden eliminar a la vez. Puede seguir los pasos a continuación para eliminar todos los comentarios:
- Abrir archivo docx de Word
- Recopilar todos los comentarios en el archivo.
- Eliminar todos los comentarios
El siguiente fragmento de código explica cómo eliminar todos los comentarios de los documentos de Word usando Java:
// Abra el documento.
Document doc = new Document(dataDir + "Comments.docx");
// Recopilar todos los comentarios en el documento
NodeCollection comments = doc.getChildNodes(com.aspose.words.NodeType.COMMENT, true);
// Eliminar todos los comentarios.
comments.clear();
doc.save(dataDir + "output.docx");
Conclusión
En resumen, hemos aprendido cómo agregar, insertar, eliminar o eliminar comentarios de documentos de Word mediante programación con Java. Si tiene alguna duda o confusión, contáctenos en Foro de soporte gratuito.