Translate labels: “Ultimo aggiornamento”, “Testato con”, “Autore”. Keep bold.

Now produce final markdown.

Check we kept all code block placeholders. Also there is a shortcodes placeholder? Not present.

Make sure no translation of URLs.

Let’s construct final answer.# Come convertire documenti Word protetti da password in Excel usando GroupDocs.Conversion per Java

Convertire documenti Word protetti da password in fogli di calcolo Excel è una necessità comune quando si desidera analizzare o condividere dati in formato tabellare. In questo tutorial imparerai come convertire word protetti da password in Excel usando l’API GroupDocs.Conversion per Java, passo dopo passo.

Risposte rapide

  • Posso convertire un file Word protetto senza la password? No – è necessario fornire la password corretta tramite le opzioni di caricamento.
  • Quali formati di output sono supportati per i fogli di calcolo? Sono disponibili XLS, XLSX, CSV e ODS.
  • È necessaria una licenza per l’uso in produzione? Sì, è richiesta una licenza GroupDocs valida per le distribuzioni non‑di prova.
  • Java 8 è sufficiente? Java 8+ è supportato; anche le versioni più recenti funzionano.
  • Posso convertire solo pagine specifiche? Assolutamente – usa setPageNumber e setPagesCount nelle opzioni di conversione.

Cos’è “convert password protected word”?

La frase si riferisce al processo di apertura di un documento Word protetto da password e alla successiva trasformazione del suo contenuto in un altro tipo di file—qui, un foglio di calcolo Excel. Questo è utile per l’estrazione dei dati, la creazione di report e i flussi di lavoro di automazione.

Perché usare GroupDocs.Conversion per Java?

GroupDocs.Conversion fornisce un’API di alto livello, nativa del linguaggio, che gestisce formati complessi, protezione con password e impostazioni di conversione dettagliate senza richiedere strumenti esterni. È affidabile, ben documentata e si integra perfettamente nelle applicazioni Java.

Prerequisiti

  • Librerie e dipendenze: GroupDocs.Conversion per Java (aggiungi tramite Maven).
  • Ambiente: JDK 8+ e un IDE come IntelliJ IDEA o Eclipse.
  • Conoscenze: Programmazione Java di base, I/O di file e utilizzo dell’API.

Configurazione di GroupDocs.Conversion per Java

Installazione con Maven

Add the repository and dependency to your pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Acquisizione della licenza

Inizia con una prova gratuita dal sito GroupDocs. Per l’accesso completo, acquista una licenza o richiedi una licenza temporanea.

Come caricare un documento protetto da password in Java

Caricare un documento protetto da password richiede un oggetto load options che contiene la password. Questo passaggio sblocca il file affinché il convertitore possa leggere il suo contenuto.

import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("12345"); // Replace with your document's password.

Spiegazione: WordProcessingLoadOptions è progettato specificamente per i file Word. Chiamando setPassword, concedi all’API il permesso di aprire il documento protetto.

Conversione Java da Word a Spreadsheet – Opzioni avanzate

Una volta caricato il documento, puoi definire come deve comportarsi la conversione—selezionando pagine, formato e scala visiva.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.SpreadsheetFileType;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;

SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
options.setPageNumber(2); // Start from page 2.
options.setPagesCount(1); // Convert only one page.
options.setFormat(SpreadsheetFileType.Xls); // Output format as XLS.
options.setZoom(150); // Set zoom level for conversion (scale factor).

Spiegazione:

  • setPageNumber e setPagesCount ti permettono di mirare a un intervallo di pagine specifico, utile quando ti serve solo una parte del documento.
  • setFormat sceglie il contenitore del foglio di calcolo (XLS in questo caso).
  • setZoom regola la scala di rendering, utile per preservare la fedeltà del layout.

Esegui la conversione

Con le opzioni di caricamento e conversione pronte, invoca il metodo convert. L’API gestisce il lavoro pesante in background.

String convertedFile = Constants.getConvertedPath("ConvertToSpreadsheetWithAdvancedOptions.xls");
Converter converter = new Converter(Constants.SAMPLE_DOCX_WITH_PASSWORD, () -> loadOptions);
converter.convert(convertedFile, options);

Spiegazione: Il costruttore Converter riceve il percorso del file sorgente e una lambda che fornisce le loadOptions precedentemente definite. La chiamata convert scrive il file Excel nella posizione restituita da Constants.getConvertedPath.

Problemi comuni e soluzioni

SymptomLikely CauseFix
“Invalid password” exceptionString della password errata o problema di codificaVerifica la password, assicurati che non ci siano spazi extra e usa la corretta capitalizzazione.
Missing pages in outputValori errati di setPageNumber/setPagesCountRicontrolla i numeri di pagina nel file Word di origine; ricorda che sono basati su 1.
Out‑of‑memory error on large filesCaricamento dell’intero documento in memoriaElabora i file grandi a blocchi o aumenta la dimensione dell’heap JVM (-Xmx).
Unsupported format errorUso di una versione più vecchia di GroupDocsAggiorna alla libreria più recente (ad esempio, 25.2).

Applicazioni pratiche

  1. Gestione dei dati: Converti i report mensili in Excel per l’analisi con tabelle pivot.
  2. Archiviazione dei documenti: Conserva i file Word legacy come fogli di calcolo per facilitare le query.
  3. Automazione dei flussi di lavoro: Integra la conversione in job batch che preparano i dati per i sistemi a valle.

Considerazioni sulle prestazioni

  • Riutilizza una singola istanza di Converter quando elabori molti documenti per ridurre l’overhead.
  • Chiudi rapidamente gli stream (try‑with‑resources) per liberare le risorse native.
  • Regola setZoom solo quando necessario; valori di zoom più alti aumentano il carico CPU.

Conclusione

Ora disponi di un approccio completo e pronto per la produzione per convertire word protetti da password in fogli di calcolo Excel usando GroupDocs.Conversion per Java. Integra questi snippet nella tua applicazione, personalizza le opzioni per adattarle alle tue regole di business, e semplificherai l’estrazione dei dati come mai prima d’ora.

Prossimi passi

  • Sperimenta con altri formati di foglio di calcolo (XLSX, CSV).
  • Esplora la conversione batch iterando su una directory di file protetti.
  • Esamina le funzionalità aggiuntive di GroupDocs come watermarking o OCR per PDF.

Sezione FAQ

  1. Qual è il caso d’uso principale di GroupDocs.Conversion in Java?
    GroupDocs.Conversion consente agli sviluppatori di convertire documenti tra vari formati, ideale per attività di gestione dei dati e automazione dei flussi di lavoro.
  2. Come posso gestire gli errori durante la conversione dei documenti?
    Assicurati che tutti i prerequisiti siano soddisfatti, inclusi dipendenze corrette e percorsi dei file. Usa i meccanismi di gestione delle eccezioni di Java per gestire eventuali problemi.
  3. GroupDocs.Conversion può gestire l’elaborazione batch di documenti?
    Sì, estendi le capacità dell’API per conversioni di massa elaborando più file in un ciclo.
  4. È possibile convertire PDF protetti da password usando questa API?
    Sebbene questo tutorial si concentri sui documenti Word, GroupDocs.Conversion supporta molti tipi di file, inclusi PDF protetti da password, con le opportune load options.
  5. Come ottimizzare l’uso della memoria quando si convertono file di grandi dimensioni?
    Ottimizza elaborando i file a blocchi e garantendo una raccolta dei rifiuti efficiente tramite gli strumenti di Java.

Risorse


Ultimo aggiornamento: 2026-03-08
Testato con: GroupDocs.Conversion 25.2 for Java
Autore: GroupDocs