Esempio completo funzionante per incorporare grafici nei documenti Word con Java

Questo esempio dimostra come creare un grafico a colonne con cinque serie di dati e inserirlo in un documento Word.

import com.aspose.words.Document;
import com.aspose.words.DocumentBuilder;
import com.aspose.words.Shape;
import com.aspose.words.ChartType;
import com.aspose.words.Chart;
import com.aspose.words.ChartSeriesCollection;

public class CreateChartInWord {
    public static void main(String[] args) {
        // Create a document
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);

// Add chart with default data. You can specify different chart types and sizes.
        Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);

// Chart property of Shape contains all chart related options.
        Chart chart = shape.getChart();

// Get chart series collection.
        ChartSeriesCollection seriesColl = chart.getSeries();
        // Check series count.
        System.out.println(seriesColl.getCount());

// Delete default generated series.
        seriesColl.clear();

// Create category names array, in this example we have two categories.
        String[] categories = new String[] { "AW Category 1", "AW Category 2" };

// Adding new series. Please note, data arrays must not be empty and arrays must be the same size.
        seriesColl.add("AW Series 1", categories, new double[] { 1, 2 });
        seriesColl.add("AW Series 2", categories, new double[] { 3, 4 });
        seriesColl.add("AW Series 3", categories, new double[] { 5, 6 });
        seriesColl.add("AW Series 4", categories, new double[] { 7, 8 });
        seriesColl.add("AW Series 5", categories, new double[] { 9, 10 });

// Save the document
        doc.save("ColumnsChart.docx");
    }
}

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati che il percorso di output (ColumnsChart.docx) punti a una directory scrivibile, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Come creare grafici nei documenti Word usando Java

Il flusso di lavoro può essere suddiviso in cinque passaggi chiari:

1. Crea un Document e DocumentBuilder - La classe Document rappresenta il file Word in memoria, e DocumentBuilder ti fornisce un’API fluida per inserire contenuti, inclusi i grafici.

   Document doc = new Document();
   DocumentBuilder builder = new DocumentBuilder(doc);
   

2. Inserisci una forma di grafico - insertChart accetta un ChartType (ad es., COLUMN) insieme a una larghezza e un’altezza in punti, e restituisce un Shape che ospita il grafico nella pagina.

   Shape shape = builder.insertChart(ChartType.COLUMN, 432, 252);
   

3. Accedi all’oggetto Chart - La proprietà Chart dell’Shape espone tutte le opzioni relative al grafico, inclusa la sua collezione di serie.

Chart chart = shape.getChart();
ChartSeriesCollection seriesColl = chart.getSeries();
System.out.println(seriesColl.getCount());

Consulta il riferimento API per tutti i dettagli su Chart, ChartSeriesCollection e gli enum correlati.

4. Cancella le serie predefinite e aggiungi le tue - Un grafico appena inserito contiene già serie segnaposto, quindi clear() le rimuove prima di aggiungere categorie e dati con add(). Gli array di categorie e valori passati alla stessa chiamata add() devono avere la stessa lunghezza.

   seriesColl.clear();
   

String[] categories = new String[] { “AW Category 1”, “AW Category 2” };

seriesColl.add(“AW Series 1”, categories, new double[] { 1, 2 }); seriesColl.add(“AW Series 2”, categories, new double[] { 3, 4 });

<!--[CODE_SNIPPET_END]-->

5. **Salva il documento** - Infine, `doc.save()` scrive il DOCX su disco.
<!--[CODE_SNIPPET_START]-->
```java
doc.save("ColumnsChart.docx");

Comprendere ciascuno di questi passaggi facilita l’adattamento dell’esempio a diversi tipi di grafico, fonti di dati o modelli di documento.

Preparare l’ambiente

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>

Scarica l’ultimo pacchetto SDK dalla pagina di download. La libreria richiede Java 8 o versioni successive e funziona su qualsiasi JVM standard. Non sono necessari componenti server aggiuntivi.

Messa a punto della generazione di grafici

Puoi regolare diverse proprietà per adattarle al tuo stile visivo:

• Tipo di grafico - Cambia ChartType.COLUMN in ChartType.BAR, ChartType.LINE, ChartType.PIE, ChartType.SCATTER e altri tipi supportati.

  Shape shape = builder.insertChart(ChartType.BAR, 432, 252);
  

• Dimensione del grafico - Il secondo e il terzo argomento di insertChart controllano la larghezza e l’altezza della forma del grafico, in punti.

  Shape shape = builder.insertChart(ChartType.COLUMN, 500, 300);
  

• Categories (axis labels) - Crea un String[] di nomi di categoria e riutilizzalo in tutte le serie che condividono le stesse categorie.

  String[] categories = new String[] { "Jan", "Feb", "Mar" };
  

• Serie di dati - Chiama seriesColl.add() con un nome di serie, l’array delle categorie e un double[] di valori per aggiungere quante serie comparative desideri.

  seriesColl.add("2021", categories, new double[] { 200, 220, 250 });
  

Queste opzioni ti consentono di personalizzare il grafico per qualsiasi esigenza di reporting mantenendo il codice conciso.

Inserimento di un grafico a dispersione in un documento Word utilizzando Java

Le diagrammi a dispersione tracciano coppie di valori numerici X e Y anziché categorie, il che li rende utili per visualizzare correlazioni o distribuzioni. ChartSeriesCollection espone una sovraccarico di add() specificamente per questo scopo: invece di un array di categorie, si passano due array double[], uno per i valori X e uno per i valori Y.

import com.aspose.words.Document;
import com.aspose.words.DocumentBuilder;
import com.aspose.words.Shape;
import com.aspose.words.ChartType;
import com.aspose.words.Chart;

public class InsertScatterChart {
    public static void main(String[] args) {
        // Create a new document
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);

// Insert Scatter chart.
        Shape shape = builder.insertChart(ChartType.SCATTER, 432, 252);
        Chart chart = shape.getChart();

// Use this overload to add series to any type of Scatter charts.
        chart.getSeries().add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// Save the document
        doc.save("ScatterChart.docx");
    }
}

Il flusso complessivo rispecchia l’esempio del grafico a colonne: crea un Document e DocumentBuilder, inserisci la forma del grafico con ChartType.SCATTER, ottieni il Chart dalla forma e aggiungi una o più serie. Poiché i grafici a dispersione tracciano coppie di coordinate X/Y, non esiste un array di categorie separato — ogni punto è definito dalle voci corrispondenti negli array dei valori X e Y. Salva con doc.save() una volta aggiunte tutte le serie.

Conclusione

Incorniciare i dati visuali direttamente nei file DOCX è un modo potente per migliorare i report automatizzati. Con Conholdate.Total for Java è possibile creare grafici nei documenti Word usando Java in poche righe di codice — inclusi grafici a colonne, a barre, a linee, a torta e a dispersione — personalizzare categorie e serie e generare documenti dall’aspetto professionale sul lato server. Ricorda di ottenere una licenza adeguata per l’uso in produzione; una licenza temporanea è disponibile nella pagina della licenza temporanea, e i dettagli completi dei prezzi possono essere consultati nella pagina dei prezzi. Inizia a integrare la generazione di grafici oggi stesso e offri ai tuoi utenti documenti basati sui dati che si distinguono.

Domande frequenti

• Come posso creare grafici nei documenti Word usando Java con Conholdate.Total? Chiama insertChart su un DocumentBuilder con il ChartType desiderato, recupera il Chart dallo Shape restituito, cancella la serie predefinita e aggiungi le tue categorie e dati con seriesColl.add(), quindi salva il documento. Il codice completo è mostrato nell’esempio sopra.

• Quali tipi di grafico sono supportati? L’SDK supporta colonne, barre, linee, torta, dispersione e molti altri tipi di grafico standard tramite l’enumerazione ChartType. Modifica il valore dell’enumerazione passato a insertChart per cambiare i tipi.

• In che modo un grafico a dispersione differisce da un grafico a colonne o a barre? Un grafico a dispersione traccia coppie di valori numerici X e Y invece di categorie denominate, quindi utilizzi il sovraccarico add(name, xValues, yValues) di ChartSeriesCollection anziché passare un array di categorie.

• Devo impostare una licenza per la generazione di grafici? Sì. È possibile ottenere una licenza temporanea dalla pagina della licenza temporanea. Per progetti a lungo termine, acquista una licenza completa tramite la pagina dei prezzi.

• L’SDK è compatibile con le build Maven e Gradle? Assolutamente. Aggiungi il repository Maven di Conholdate e la dipendenza conholdate-total al tuo file di build come mostrato nella sezione Setup, e la libreria funziona sia con Maven che con Gradle.

Leggi di più

• Converti Excel in immagine in Java
• Firma documenti Word in Java
• Converti Word in immagine in Java