I commenti vengono utilizzati nei documenti Word, DOCX o DOC, per suggerire miglioramenti e modifiche. Esaminiamo come inserire commenti e come eliminare o rimuovere commenti a livello di codice utilizzando Java. Puoi aggiungere il nome dell’autore, le iniziali, il testo del commento, la data e l’ora in base alle tue esigenze. Eseguiremo tutte queste attività utilizzando l’API Aspose.Words for Java.
Qui impareremo i seguenti casi d’uso relativi ai commenti nei documenti Word:
- Inserisci commento in un documento Word esistente utilizzando Java
- Inserisci commento in un nuovo documento Word utilizzando Java
- Elimina commenti specifici dal documento Word utilizzando Java
- Elimina tutti i commenti dai documenti di Word utilizzando Java
Inserisci o Elimina commenti nei file di Word (DOCX/DOC) API – Installazione
Puoi scaricare l’ultima versione di Aspose.Words per l’API Java dalla sezione Download o dal repository Maven, secondo le configurazioni menzionate di seguito:
Archivio:
<repositories>
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.com/repo/</url>
</repository>
</repositories>
Dipendenza:
<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>
Quindi l’API è stata configurata ora e possiamo procedere a esplorare diversi casi d’uso dell’utilizzo dei commenti nei documenti di Word.
Inserisci commento in un documento Word esistente utilizzando Java
Puoi inserire o aggiungere commenti in file Microsoft Word esistenti, DOCX o DOC, con Aspose.Words per l’API Java. Questo può essere utile durante la revisione dei documenti, ad esempio un supervisore può suggerire diverse modifiche o miglioramenti su un rapporto di fattibilità. Inoltre, chiunque abbia i permessi di modifica di un documento Word può lavorare con i commenti. È necessario seguire i passaggi seguenti per inserire commenti nel file word (DOCX/DOC):
- Carica il file DOCX esistente con la classe Document
- Crea un commento
- Salva file DOCX
Il seguente frammento di codice mostra come inserire un commento nel documento Word utilizzando Java:
// Carica il documento word di origine
Document doc = new Document(dataDir + "Comments.docx");
// Inizializza l'oggetto DocumentBuilder
DocumentBuilder builder = new DocumentBuilder(doc);
// Crea un nuovo commento
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"));
// Salva file di output
doc.save(dataDir + "Comments_Output.docx");
La schermata seguente mostra un commento di esempio aggiunto in documenti Word esistenti:
Inserisci commento nel nuovo documento Word utilizzando Java
I commenti sono utili anche durante la creazione di un nuovo documento Word. Ad esempio, alcuni testi potrebbero richiedere un’elaborazione che può essere spiegata con l’aiuto di commenti. Allo stesso modo, potrebbero esserci centinaia di casi d’uso in cui i commenti possono aiutare durante la creazione di un nuovo file DOCX. Puoi facilmente aggiungere o inserire commenti seguendo i passaggi seguenti:
- Inizializza l’oggetto DocumentBuilder
- Aggiungi testo di esempio
- Crea un commento personalizzato
- Salva file DOCX
Il frammento di codice seguente mostra come inserire commenti durante la creazione di un nuovo documento Word da zero, utilizzando Java:
// Inizializza un nuovo documento Word
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Aggiungi del testo
builder.write("Some text is added.");
// Crea un nuovo commento
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"));
// Salva il file DOCX di output
doc.save(dataDir + "Comments_Output.docx");
Lo screenshot seguente mostra l’output in cui viene aggiunto il commento sul nuovo documento Word:
Elimina commenti specifici dal documento Word utilizzando Java
I commenti vengono spesso eliminati quando i miglioramenti o le modifiche suggeriti vengono incorporati nel documento word. Quando è necessario eliminare commenti specifici, è possibile seguire i passaggi seguenti:
- Carica il documento word di origine
- Specifica il nome dell’autore
- Rimuovere i commenti dall’autore specificato
Il frammento di codice di seguito mostra come eliminare commenti specifici da un file di parole utilizzando Java:
// Apri il documento.
Document doc = new Document(dataDir + "Comments.docx");
String authorName = "Aspose";
// Raccogli tutti i commenti nel documento
NodeCollection comments = doc.getChildNodes(NodeType.COMMENT, true);
// Sfoglia tutti i commenti e rimuovi quelli scritti dall'autore di Aspose.
for (int i = comments.getCount() - 1; i >= 0; i--) {
Comment comment = (Comment) comments.get(i);
if (comment.getAuthor().equals(authorName))
comment.remove();
}
// Salva il file DOCX di output
doc.save(dataDir + "output.docx");
Elimina tutti i commenti dai documenti di Word utilizzando Java
Tutti i commenti del documento Word possono essere eliminati contemporaneamente. Puoi seguire i passaggi seguenti per rimuovere tutti i commenti:
- Apri il file docx di Word
- Raccogli tutti i commenti nel file
- Elimina tutti i commenti
Il seguente frammento di codice spiega come eliminare tutti i commenti dai documenti Word utilizzando Java:
// Apri il documento.
Document doc = new Document(dataDir + "Comments.docx");
// Raccogli tutti i commenti nel documento
NodeCollection comments = doc.getChildNodes(com.aspose.words.NodeType.COMMENT, true);
// Rimuovi tutti i commenti.
comments.clear();
doc.save(dataDir + "output.docx");
Conclusione
Per riassumere, abbiamo imparato come aggiungere, inserire, eliminare o rimuovere commenti da documenti Word in modo programmatico con Java. In caso di dubbi o confusione, contattaci al Forum di supporto gratuito.