Converti DOCX in DOCM in Java con GroupDocs.Editor

Nell’attuale ambiente aziendale in rapida evoluzione, la possibilità di convertire docx in docm direttamente dal tuo codice Java può ridurre drasticamente lo sforzo manuale ed eliminare i problemi di compatibilità. Che tu debba aggiornare un rapporto trimestrale, personalizzare un modello di contratto o generare lettere personalizzate, la modifica programmatica ti offre la velocità e l’affidabilità che gli strumenti puntare‑e‑cliccare spesso non hanno. Questa guida ti accompagna nel caricamento di un file DOCX, nella modifica programmatica del suo contenuto e nel salvataggio del risultato in diversi formati popolari — incluso DOCM — usando GroupDocs.Editor per Java.

Risposte rapide

Quale libreria mi consente di modificare documenti Word in Java? GroupDocs.Editor per Java.
Posso sostituire il testo automaticamente? Sì – usa l’API di markup HTML per cercare e sostituire le stringhe.
In quali formati posso esportare? DOCM, RTF, testo semplice e altro.
Ho bisogno di una licenza per lo sviluppo? Una prova gratuita è sufficiente per i test; è necessaria una licenza commerciale per la produzione.
È compatibile con progetti Maven? Assolutamente – basta aggiungere il repository e la dipendenza.

Cos’è “edit word document java”?

Modificare un documento Word da Java significa caricare un file .docx in memoria, manipolare il suo contenuto (testo, immagini, tabelle, ecc.) tramite l’API, e poi scrivere il file aggiornato su disco o su uno stream. GroupDocs.Editor astrae il complesso formato Office Open XML, offrendo un modello di modifica basato su HTML semplice.

Perché usare GroupDocs.Editor per modificare word document java?

Nessuna dipendenza da Microsoft Office – funziona su qualsiasi server o container.
Alta fedeltà – mantiene il layout originale, gli stili e gli oggetti incorporati.
Molteplici formati di output – passa da DOCX, DOCM, RTF, TXT con una singola chiamata.
Scalabile – adatto per l’elaborazione batch di grandi insiemi di documenti.

Prerequisiti

Java 8+ e uno strumento di build (Maven o Gradle).
Accesso alla libreria GroupDocs.Editor per Java (versione 25.3 o successiva).
Familiarità di base con Java e la gestione delle dipendenze Maven.

Configurazione di GroupDocs.Editor per Java

Installazione tramite Maven

Aggiungi il repository GroupDocs e la dipendenza al tuo pom.xml:

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/editor/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-editor</artifactId>
        <version>25.3</version>
    </dependency>
</dependencies>

Download diretto

In alternativa, scarica l’ultimo JAR dalla pagina di rilascio di GroupDocs.Editor per Java.

Acquisizione della licenza

Inizia con una prova gratuita per esplorare l’API. Per carichi di lavoro in produzione, ottieni una licenza temporanea o completa dal portale GroupDocs.

Inizializzazione e configurazione di base

Crea un’istanza Editor che punti al tuo file DOCX di origine:

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.options.WordProcessingLoadOptions;

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
Editor editor = new Editor(inputFilePath, new WordProcessingLoadOptions());

Ora sei pronto a caricare, modificare e salvare i documenti.

Come convertire docx in docm usando GroupDocs.Editor

Il processo di conversione è semplice: carica il DOCX, modifica l’HTML se necessario, e poi salva usando il formato Docm. I passaggi seguenti riutilizzano i blocchi di codice già introdotti, quindi non dovrai scrivere codice aggiuntivo.

Passo 1: Carica il documento

Panoramica: Il caricamento ti fornisce un oggetto EditableDocument che puoi manipolare.

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.EditableDocument;

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
Editor editor = new Editor(inputFilePath, new WordProcessingLoadOptions());
EditableDocument defaultWordProcessingDoc = editor.edit();

Passo 2: (Opzionale) Modifica il contenuto

Se devi sostituire segnaposti o personalizzare il modello, modifica l’HTML incorporato.

String allEmbeddedInsideString = defaultWordProcessingDoc.getEmbeddedHtml();
String modifiedContent = allEmbeddedInsideString.replace("Subtitle", "Edited subtitle");

Passo 3: Salva come DOCM

Configura le opzioni di salvataggio per il formato DOCM e scrivi il risultato su un file o su uno stream.

import com.groupdocs.editor.options.WordProcessingSaveOptions;
import com.groupdocs.editor.formats.WordProcessingFormats;

WordProcessingSaveOptions docmSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm);

import java.io.ByteArrayOutputStream;
import java.io.OutputStream;

String outputDocmPath = "YOUR_OUTPUT_DIRECTORY/editedDoc.docm";
try (OutputStream outputStream = new ByteArrayOutputStream()) {
    // Create a new EditableDocument from the (possibly) modified HTML
    EditableDocument editedDocDocm = EditableDocument.fromMarkup(modifiedContent, null);
    editor.save(editedDocDocm, outputStream, docmSaveOptions);
    // If you need a physical file, write the stream to disk here
}

Consiglio professionale: Dispone degli oggetti EditableDocument e Editor non appena hai finito per liberare le risorse native.

Salva il documento come RTF

Panoramica: Dopo la modifica, puoi esportare in Rich Text Format.

import com.groupdocs.editor.options.WordProcessingSaveOptions;
import com.groupdocs.editor.formats.WordProcessingFormats;

String outputRtfPath = "YOUR_OUTPUT_DIRECTORY/editedDoc.rtf";
WordProcessingSaveOptions rtfSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);

EditableDocument editedDocRtf = EditableDocument.fromMarkup(modifiedContent, null);
editor.save(editedDocRtf, outputRtfPath, rtfSaveOptions);
editedDocRtf.dispose();
editor.dispose();

Salva il documento come testo semplice

Panoramica: L’esportazione in testo semplice è utile per l’indicizzazione dei contenuti o per semplici estrazioni di dati.

import com.groupdocs.editor.options.TextSaveOptions;
import java.nio.charset.StandardCharsets;

TextSaveOptions textSaveOptions = new TextSaveOptions();
textSaveOptions.setEncoding(StandardCharsets.UTF_8);
textSaveOptions.setPreserveTableLayout(true);

String outputTxtPath = "YOUR_OUTPUT_DIRECTORY/editedDoc.txt";
editor.save(editedDocTxt, outputTxtPath, textSaveOptions);

Applicazioni pratiche

Automatizzare la generazione di report – Recupera dati da database, sostituisci i segnaposti e genera un report DOCX, DOCM o RTF rifinito.
Personalizzare il modello Word – Compila dinamicamente modelli di marketing o legali in base all’input dell’utente.
Esportare Word in txt – Estrai il testo grezzo per l’indicizzazione di ricerca, analisi o ulteriori elaborazioni.
Sostituire testo docx java – Usa l’API di markup HTML per eseguire operazioni di ricerca‑e‑sostituzione in blocco su molti documenti.

Considerazioni sulle prestazioni

Dispone degli oggetti EditableDocument e Editor non appena hai finito per liberare le risorse native.
Per file molto grandi, elabora le sezioni a blocchi o usa le API di streaming per mantenere basso l’uso della memoria.
Preferisci StringBuilder o regex efficienti quando esegui sostituzioni di testo in blocco.

Problemi comuni e soluzioni

Problema	Soluzione
File non trovato / accesso negato	Verifica il percorso assoluto e assicurati che il processo Java abbia i permessi di lettura/scrittura.
Errori di out‑of‑memory su documenti grandi	Aumenta l’heap JVM (`-Xmx`) o dividi il documento in parti più piccole prima della modifica.
Formattazione persa dopo la sostituzione	Usa l’API di markup HTML con attenzione; evita di sostituire i tag di markup stessi.
Licenza non applicata	Chiama `License license = new License(); license.setLicense("path/to/license.file");` prima di creare `Editor`.

Domande frequenti

D: Posso modificare file Word protetti da password?
R: Sì. Carica il documento con WordProcessingLoadOptions che includono la password, poi procedi normalmente.

D: GroupDocs.Editor supporta le macro nei file DOCM?
R: La libreria preserva le macro ma non le esegue. Puoi salvare un file DOCM con le macro esistenti intatte.

D: Come gestisco le immagini incorporate nel documento?
R: Le immagini sono mantenute come parte del markup HTML. Puoi sostituire i tag <img> o aggiungerne di nuovi usando HTML standard.

D: È possibile convertire direttamente in PDF?
R: GroupDocs.Editor si concentra sulla modifica; per la conversione in PDF, combinalo con GroupDocs.Conversion dopo aver salvato il DOCX modificato.

D: Quali versioni di Java sono supportate?
R: Java 8 e versioni successive sono pienamente supportate.

Conclusione

Ora disponi di un flusso di lavoro completo, end‑to‑end, per convertire docx in docm usando GroupDocs.Editor. Caricando un DOCX, modificando programmaticamente il suo HTML e esportando in formati come RTF, DOCM o testo semplice, puoi automatizzare innumerevoli attività centrate sui documenti nelle tue applicazioni Java. Esplora funzionalità aggiuntive come il controllo ortografico, il tracciamento delle modifiche o l’integrazione con GroupDocs.Conversion per ampliare ulteriormente la tua soluzione.

Ultimo aggiornamento: 2026-03-20
Testato con: GroupDocs.Editor 25.3 per Java
Autore: GroupDocs