Contoh Kerja Lengkap untuk Menyematkan Diagram dalam Dokumen Word Menggunakan Java

Contoh ini menunjukkan cara membuat diagram kolom dengan lima rangkaian data dan menyisipkannya ke dalam dokumen 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");
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan jalur output (ColumnsChart.docx) mengarah ke direktori yang dapat ditulisi, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Cara Membuat Grafik di Dokumen Word Menggunakan Java

Alur kerja dapat dibagi menjadi lima langkah yang jelas:

1. Buat Dokumen dan DocumentBuilder - Kelas Document mewakili file Word dalam memori, dan DocumentBuilder memberikan API yang lancar untuk menyisipkan konten, termasuk diagram.

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

2. Menyisipkan bentuk diagram - insertChart mengambil sebuah ChartType (misalnya, COLUMN) bersama dengan lebar dan tinggi dalam poin, dan mengembalikan sebuah Shape yang menampung diagram pada halaman.

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

3. Akses objek Chart - Properti Chart dari Shape menampilkan semua opsi terkait diagram, termasuk koleksi seri-nya.

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

   Lihat referensi API untuk detail lengkap tentang Chart, ChartSeriesCollection, dan enum terkait.

4. Hapus seri default dan tambahkan milik Anda - Diagram yang baru disisipkan sudah berisi seri placeholder, jadi clear() menghapusnya sebelum Anda menambahkan kategori dan data dengan add(). Array kategori dan nilai yang diberikan ke panggilan add() yang sama harus memiliki panjang yang sama.

   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. **Simpan dokumen** - Akhirnya, `doc.save()` menulis DOCX ke disk.
<!--[CODE_SNIPPET_START]-->
```java
doc.save("ColumnsChart.docx");

Memahami setiap langkah ini memudahkan penyesuaian contoh untuk berbagai jenis diagram, sumber data, atau templat dokumen.

Menyiapkan Lingkungan

Tambahkan repositori Maven Conholdate dan dependensi SDK ke pom.xml Anda:

<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>

Unduh paket SDK terbaru dari halaman unduhan. Perpustakaan memerlukan Java 8 atau lebih tinggi dan berjalan pada JVM standar apa pun. Tidak diperlukan komponen server tambahan.

Penyetelan Halus Pembuatan Grafik

Anda dapat menyesuaikan beberapa properti untuk mencocokkan gaya visual Anda:

• Tipe Diagram - Ubah ChartType.COLUMN menjadi ChartType.BAR, ChartType.LINE, ChartType.PIE, ChartType.SCATTER, dan tipe lain yang didukung.

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

• Ukuran Diagram - Argumen kedua dan ketiga pada insertChart mengontrol lebar dan tinggi bentuk diagram, dalam poin.

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

• Kategori (label sumbu) - Bangun sebuah String[] berisi nama kategori dan gunakan kembali pada setiap seri yang berbagi kategori yang sama.

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

• Data Series - Panggil seriesColl.add() dengan nama seri, array kategori, dan double[] nilai untuk menambahkan sebanyak mungkin seri perbandingan yang Anda butuhkan.

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

Opsi-opsi ini memungkinkan Anda menyesuaikan diagram dengan setiap kebutuhan pelaporan sambil menjaga kode tetap singkat.

Menyisipkan Diagram Sebar dalam Dokumen Word Menggunakan Java

Diagram pencar memplot pasangan nilai numerik X dan Y alih‑alih kategori, yang membuatnya berguna untuk memvisualisasikan korelasi atau distribusi. ChartSeriesCollection menyediakan overload add() khusus untuk tujuan ini: alih‑alih array kategori, Anda melewatkan dua array double[], satu untuk nilai X dan satu untuk nilai 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");
    }
}

Alur keseluruhan mencerminkan contoh diagram kolom: buat Document dan DocumentBuilder, sisipkan bentuk diagram dengan ChartType.SCATTER, dapatkan Chart dari bentuk tersebut, dan tambahkan satu atau lebih seri. Karena diagram scatter memplot pasangan koordinat X/Y, tidak ada array kategori terpisah — setiap titik didefinisikan oleh entri yang cocok dalam array nilai X dan Y. Simpan dengan doc.save() setelah semua seri ditambahkan.

Kesimpulan

Menanamkan data visual secara langsung ke dalam file DOCX adalah cara yang kuat untuk meningkatkan laporan otomatis. Dengan Conholdate.Total for Java Anda dapat membuat Charts dalam dokumen Word menggunakan Java dalam hanya beberapa baris kode — termasuk column, bar, line, pie, dan scatter charts — menyesuaikan kategori dan seri, serta menghasilkan dokumen berpenampilan profesional di sisi server. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; lisensi sementara tersedia di halaman lisensi sementara, dan detail harga lengkap dapat dilihat di halaman harga. Mulailah mengintegrasikan pembuatan chart hari ini dan berikan pengguna Anda dokumen berbasis data yang menonjol.

FAQs

• Bagaimana cara membuat Diagram di Dokumen Word menggunakan Java dengan Conholdate.Total? Panggil insertChart pada DocumentBuilder dengan ChartType yang diinginkan, ambil Chart dari Shape yang dikembalikan, bersihkan seri default, dan tambahkan kategori serta data Anda sendiri dengan seriesColl.add(), kemudian simpan dokumen. Kode lengkap ditampilkan dalam contoh di atas.

• Jenis diagram apa yang didukung? SDK mendukung diagram kolom, batang, garis, pai, sebar, dan banyak jenis diagram standar lainnya melalui enum ChartType. Ubah nilai enum yang diberikan ke insertChart untuk mengganti jenisnya.

• Bagaimana diagram sebar berbeda dari diagram kolom atau batang? Diagram sebar memplot pasangan nilai numerik X dan Y alih-alih kategori bernama, sehingga Anda menggunakan overload add(name, xValues, yValues) dari ChartSeriesCollection alih-alih memberikan array kategori.

• Apakah saya perlu mengatur lisensi untuk pembuatan grafik? Ya. Lisensi sementara dapat diperoleh dari halaman lisensi sementara. Untuk proyek jangka panjang, beli lisensi penuh melalui halaman harga.

• Apakah SDK kompatibel dengan build Maven dan Gradle? Tentu saja. Tambahkan repositori Maven Conholdate dan dependensi conholdate-total ke file build Anda seperti yang ditunjukkan di bagian Setup, dan perpustakaan tersebut bekerja dengan Maven maupun Gradle.

Baca Selengkapnya

• Konversi Excel ke Gambar di Java
• Tanda Tangani Dokumen Word di Java
• Konversi Word ke Gambar di Java