Java Kullanarak Word Belgelerine Grafik Gömme için Tam Çalışan Örnek

Bu örnek, beş veri serisine sahip bir sütun grafiği oluşturmayı ve bunu bir Word belgesine eklemeyi gösterir.

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");
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, çıktı yolunun (ColumnsChart.docx) yazılabilir bir dizine işaret ettiğinden emin olun, tüm gerekli bağımlılıkların doğru şekilde yüklendiğini doğrulayın ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

Java Kullanarak Word Belgelerinde Grafik Oluşturma Nasıl Çalışır

İş akışı beş net adıma bölünebilir:

1. Bir Belge ve DocumentBuilder Oluşturun - Document sınıfı, Word dosyasını bellekte temsil eder ve DocumentBuilder grafikler dahil içerik eklemek için akıcı bir API sağlar.

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

2. Grafik şekli ekle - insertChart bir ChartType (ör., COLUMN) alır, genişlik ve yükseklik değerlerini puan cinsinden alır ve sayfada grafiği barındıran bir Shape döndürür.

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

3. Grafik nesnesine erişim - Shape nesnesinin Chart özelliği, seriler koleksiyonu dahil tüm grafikle ilgili seçenekleri ortaya çıkarır.

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

API referansı adresinde Chart, ChartSeriesCollection ve ilgili enumlar hakkında tam ayrıntıları bulabilirsiniz.

4. Varsayılan serileri temizleyin ve kendi serilerinizi ekleyin - Yeni eklenen bir grafik zaten yer tutucu serileri içerir, bu nedenle clear() bunları add() ile kategori ve veri eklemeden önce kaldırır. Aynı add() çağrısına geçirilen kategori ve değer dizileri aynı uzunlukta olmalıdır.

   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. **Belgeyi kaydet** - Son olarak, `doc.save()` DOCX'i diske yazar.
<!--[CODE_SNIPPET_START]-->
```java
doc.save("ColumnsChart.docx");

Bu adımların her birini anlamak, örneği farklı grafik türleri, veri kaynakları veya belge şablonları için uyarlamayı kolaylaştırır.

Ortamı Hazırlama

Conholdate Maven deposunu ve SDK bağımlılığını pom.xml dosyanıza ekleyin:

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

En son SDK paketini indirme sayfasından indirin. Kütüphane Java 8 veya üzeri gerektirir ve herhangi bir standart JVM’de çalışır. Ek sunucu bileşenlerine ihtiyaç yoktur.

Grafik Oluşturmayı İnce Ayarlama

Görsel stilinize uyması için birkaç özelliği ayarlayabilirsiniz:

• Grafik Türü - ChartType.COLUMN değerini ChartType.BAR, ChartType.LINE, ChartType.PIE, ChartType.SCATTER ve diğer desteklenen türlere değiştirin.

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

• Grafik Boyutu - insertChart metodunun ikinci ve üçüncü argümanları, grafik şeklinin genişliğini ve yüksekliğini puan cinsinden kontrol eder.

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

• Categories (axis labels) - Kategori adlarından oluşan bir String[] oluşturun ve aynı kategorileri paylaşan tüm serilerde yeniden kullanın.

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

• Veri Serileri - seriesColl.add() metodunu bir seri adı, kategori dizisi ve double[] değerleriyle çağırarak ihtiyacınız kadar karşılaştırmalı seri ekleyebilirsiniz.

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

Bu seçenekler, kodu özlü tutarken grafiği herhangi bir raporlama gereksinimine göre özelleştirmenizi sağlar.

Java Kullanarak Bir Word Belgesine Dağılım Grafiği Ekleme

Dağılım grafikleri, kategoriler yerine sayısal X ve Y değer çiftlerini çizer; bu da korelasyonları veya dağılımları görselleştirmek için faydalı olmalarını sağlar. ChartSeriesCollection bu amaç için özel olarak bir add() aşırı yüklemesi sunar: bir kategori dizisi yerine, X değerleri için bir double[] dizisi ve Y değerleri için bir double[] dizisi geçirirsiniz.

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");
    }
}

Genel akış, sütun grafik örneğini yansıtır: bir Document ve DocumentBuilder oluşturun, ChartType.SCATTER ile grafik şekli ekleyin, şekilden Chart alın ve bir veya daha fazla seri ekleyin. Dağılım grafiklerinde X/Y koordinat çiftleri çizildiği için ayrı bir kategori dizisi yoktur — her nokta, X ve Y değer dizilerindeki eşleşen girişlerle tanımlanır. Tüm seriler eklendikten sonra doc.save() ile kaydedin.

Sonuç

Visual verileri doğrudan DOCX dosyalarına gömmek, otomatik raporları geliştirmek için güçlü bir yoldur. Conholdate.Total for Java ile Java kullanarak Word belgelerinde sadece birkaç satır kodla Grafikler oluşturabilirsiniz — sütun, çubuk, çizgi, pasta ve dağılım grafikleri dahil — kategorileri ve serileri özelleştirin ve sunucu tarafında profesyonel görünümlü belgeler üretin. Üretim kullanımı için uygun bir lisans almayı unutmayın; geçici bir lisans geçici lisans sayfasında mevcuttur ve tam fiyatlandırma detayları fiyatlandırma sayfasında incelenebilir. Grafik oluşturmayı bugün entegre etmeye başlayın ve kullanıcılarınıza öne çıkan veri odaklı belgeler sunun.

SSS

• Java ile Conholdate.Total kullanarak Word Belgelerinde Grafikler nasıl oluşturulur? İstenen ChartType ile bir DocumentBuilder üzerinde insertChart metodunu çağırın, dönen Shape nesnesinden Chart‘ı alın, varsayılan seriyi temizleyin ve kendi kategorilerinizi ve verilerinizi seriesColl.add() ile ekleyin, ardından belgeyi kaydedin. Tam kod yukarıdaki örnekte gösterilmiştir.

• Hangi grafik türleri destekleniyor? SDK, ChartType enumu aracılığıyla sütun, çubuk, çizgi, pasta, dağılım ve birçok diğer standart grafik türünü destekler. Türleri değiştirmek için insertChart metoduna geçirilen enum değerini değiştirin.

• Bir dağılım grafiği, sütun veya çubuk grafikten nasıl farklıdır? Bir dağılım grafiği, adlandırılmış kategoriler yerine sayısal X ve Y değer çiftlerini çizer, bu yüzden add(name, xValues, yValues) aşırı yüklemesini ChartSeriesCollection içinde kullanırsınız, bir kategori dizisi geçmek yerine.

• Grafik oluşturma için lisans ayarlamam gerekiyor mu?
  Evet. Geçici bir lisans, geçici lisans sayfası üzerinden alınabilir. Uzun vadeli projeler için, tam lisansı fiyatlandırma sayfası aracılığıyla satın alın.

• SDK Maven ve Gradle derlemeleriyle uyumlu mu? Kesinlikle. Setup bölümünde gösterildiği gibi Conholdate Maven deposunu ve conholdate-total bağımlılığını build dosyanıza ekleyin; kütüphane hem Maven hem de Gradle ile çalışır.

Daha Fazla Oku

• Java’da Excel’i Görsele Dönüştür
• Java’da Word Belgelerini İmzala
• Java’da Word’u Görsele Dönüştür