Generare anteprime visive dei dati di un foglio di calcolo è una necessità frequente quando si costruiscono dashboard di reportistica o riepiloghi via email. Conholdate.Total for Java fornisce un SDK robusto che semplifica il processo di conversione di Excel in immagine nelle applicazioni Java. In questa guida vedrai come caricare una cartella di lavoro XLSX, configurare l’output PNG e produrre file immagine per interi fogli di lavoro, grafici o intervalli specifici. Alla fine avrai un esempio di codice pronto all’uso che potrai adattare ai tuoi progetti.

Cosa richiede Convert Excel Files to Image dalla tua applicazione

Gli sviluppatori spesso hanno bisogno di trasformare il contenuto di un foglio di calcolo in immagini statiche per anteprime web, report PDF o miniature per dispositivi mobili. Il requisito tipicamente include la conservazione della formattazione delle celle, il rendering dei grafici incorporati e, facoltativamente, limitare la conversione a un singolo intervallo. Gestire manualmente queste attività aprendo Excel, facendo screenshot e salvandoli non è scalabile e può portare a risultati incoerenti.

I vincoli tecnici per una soluzione affidabile sono: supporto per file XLSX, capacità di includere grafici e formule, risoluzione immagine configurabile e elaborazione batch di più fogli di lavoro. La conversione deve essere eseguita su un server o ambiente desktop senza richiedere Microsoft Office.

Scegliere Conholdate.Total for Java per il lavoro

Conholdate.Total for Java offre un’API unificata che copre tutte le funzionalità necessarie. Le sue ExcelLoadOptions consentono di caricare grafici e formule, mentre le ImageConvertOptions offrono un controllo dettagliato su formato, qualità e dimensioni. L’SDK funziona su qualsiasi runtime Java, richiede solo la dipendenza Maven e gestisce efficientemente cartelle di lavoro di grandi dimensioni.

Per un utilizzo dettagliato dell’API vedere la documentazione ufficiale. Il riferimento completo per classi come Conversion, ExcelLoadOptions e ImageConvertOptions è disponibile nel riferimento API. È possibile scaricare l’ultima libreria dalla pagina di rilascio.

Implementazione della conversione da Excel a immagine in Java

Il processo di conversione può essere suddiviso in alcuni passaggi chiari. Le sezioni seguenti ti guidano attraverso ogni parte, con brevi estratti di codice presi direttamente dall’esempio completo.

Installa Conholdate.Total per Java tramite Maven

Aggiungi il repository Maven di Conholdate e la dipendenza SDK al tuo pom.xml:

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

Carica file Excel con supporto per grafici e formule

Crea un’istanza di ExcelLoadOptions, abilita il caricamento di grafici e formule e inizializza l’oggetto Conversion con un flusso di file:

ExcelLoadOptions loadOptions = new ExcelLoadOptions();
loadOptions.setLoadCharts(true);
loadOptions.setLoadFormulas(true);

Conversion conversion = new Conversion(new FileInputStream("input.xlsx"), loadOptions);

Configura le opzioni di output dell’immagine per PNG

Imposta il formato immagine desiderato, la qualità e le dimensioni. La larghezza è fissa mentre l’altezza conserva le proporzioni dell’aspetto:

ImageConvertOptions imgOptions = new ImageConvertOptions();
imgOptions.setFormat(ImageConvertOptions.ImageFormat.PNG);
imgOptions.setQuality(90);
imgOptions.setWidth(1200);
imgOptions.setHeight(0); // preserve aspect ratio

Converti ogni foglio di lavoro o intervallo in immagini PNG

Itera sulle pagine della cartella di lavoro (fogli) e converti ciascuna. Puoi anche mirare a un intervallo specifico modificando il pageNumber o utilizzando opzioni di caricamento aggiuntive:

int pageCount = conversion.getPageCount();
for (int i = 1; i <= pageCount; i++) {
    imgOptions.setPageNumber(i);
    String outputPath = "output_images/sheet_" + i + ".png";
    conversion.convert(outputPath, imgOptions);
}

Verifica l’output e gestisci le eccezioni

Avvolgi la logica di conversione in un blocco try‑catch e assicurati che la directory di output esista prima di iniziare:

try {
    Files.createDirectories(Paths.get("output_images"));
    // conversion code here
    System.out.println("Excel to image conversion completed successfully.");
} catch (Exception ex) {
    System.err.println("Conversion failed: " + ex.getMessage());
    ex.printStackTrace();
}

I passaggi sopra dimostrano come convertire Excel in immagine utilizzando il Conholdate.Total SDK, offrendo flessibilità nella gestione di grafici, intervalli e fogli di lavoro completi.

Esempio di Codice Completo: Converti Excel in Immagine con Supporto per l’Intero Foglio

Il codice seguente mostra l’implementazione completa, pronta all’esecuzione, descritta nei passaggi precedenti.

import java.io.FileInputStream;
import java.nio.file.Files;
import java.nio.file.Paths;

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.load.ExcelLoadOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions.ImageFormat;

public class ExcelToImageConverter {
    public static void main(String[] args) {
        String inputFile = "input.xlsx";
        String outputFolder = "output_images";

try {
            // Create output directory if it does not exist
            Files.createDirectories(Paths.get(outputFolder));

// Load options: include charts and formulas during conversion
            ExcelLoadOptions loadOptions = new ExcelLoadOptions();
            loadOptions.setLoadCharts(true);
            loadOptions.setLoadFormulas(true);

// Initialize conversion with the Excel file and load options
            try (Conversion conversion = new Conversion(new FileInputStream(inputFile), loadOptions)) {

// Determine how many pages (sheets) the workbook has
                int pageCount = conversion.getPageCount();

// Configure image output options
                ImageConvertOptions imgOptions = new ImageConvertOptions();
                imgOptions.setFormat(ImageFormat.PNG);   // Output format
                imgOptions.setQuality(90);               // Quality (relevant for JPEG)
                imgOptions.setWidth(1200);               // Desired width, height will keep aspect ratio
                imgOptions.setHeight(0);                 // 0 means preserve original aspect ratio

// Convert each sheet to a separate image file
                for (int i = 1; i <= pageCount; i++) {
                    imgOptions.setPageNumber(i);
                    String outputPath = outputFolder + "/sheet_" + i + ".png";
                    conversion.convert(outputPath, imgOptions);
                }
            }

System.out.println("Excel to image conversion completed successfully.");
        } catch (Exception ex) {
            System.err.println("Conversion failed: " + ex.getMessage());
            ex.printStackTrace();
        }
    }
}

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (input.xlsx, output_images) per corrispondere alle tue effettive posizioni, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nell’ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Conclusione

Convertire Excel in immagine in Java diventa semplice quando si utilizza Conholdate.Total for Java. L’SDK gestisce il rendering dei grafici, la valutazione delle formule e l’output PNG ad alta qualità con pochissimo codice. Seguendo la guida passo‑passo è possibile integrare questa funzionalità negli strumenti di reporting, nei generatori di email o in qualsiasi applicazione che necessiti di rappresentazioni visive dei fogli di calcolo. Ricorda che le distribuzioni in produzione richiedono una licenza commerciale; puoi esplorare le opzioni di prezzo nella pagina dei Prezzi di Conholdate.Total e ottenere una licenza temporanea dalla pagina della licenza temporanea durante la valutazione.

Domande frequenti

  • Come posso convertire Excel in immagine in Java?
    Utilizza la classe Conversion di Conholdate.Total for Java, configura ExcelLoadOptions e ImageConvertOptions, quindi chiama convert per ogni foglio di lavoro.

  • Posso convertire un grafico Excel in un’immagine?
    Sì. Abilita il caricamento dei grafici con loadOptions.setLoadCharts(true) e specifica il numero di pagina del grafico impostando imgOptions.setPageNumber.

  • È possibile convertire solo un intervallo specifico di celle?
    È possibile definire un intervallo nelle opzioni di caricamento o selezionare il numero di pagina appropriato che corrisponde all’intervallo desiderato prima della conversione.

  • Quale licenza è necessaria per l’uso in produzione?
    È necessaria una licenza commerciale. Consulta i costi nella pagina Conholdate.Total pricing e ottieni una licenza temporanea dalla pagina della licenza temporanea.

Leggi di più