Grafikler ve raporlar

Grafikleri tablo ve metinlerle aynı şablonda kullanarak satış, pazarlama veya proje raporları hazırlayabilirsiniz. Kendi grafiğinizi oluşturmak için hazır rapor tasarımı satın almanız gerekmez.

Generator'da grafik oluşturma

1. Varlıklar panelinden Grafik ekleyin; denetçide grafik türünü ve başlığını belirleyin.
2. Grafik verilerini düzenle düğmesiyle veri penceresini açın. Seri adlarını, renklerini, kategorileri ve sayısal değerleri düzenleyin; gerekirse seri veya satır ekleyin.
3. Uygula değişiklikleri grafiğe aktarır. Vazgeç pencere içindeki değişiklikleri atar. Şablonu kaydettikten sonra önizleme ve çıktılarını kontrol edin.

Türler ve sınırlar

Sütun, yatay çubuk, çizgi, alan, pasta ve halka grafikler desteklenir. JSON tanımındaki tür kodları şunlardır:

Örnekler ürünün kendi çizim motoruyla, aynı dört satırlık veriyle üretildi; değişen tek şey tür kodu.

Bir grafik en fazla 100 kategori ve 6 seri içerir. Pasta ve halka grafiklerde yalnız bir seri kullanılabilir; negatif değer kabul edilmez.

Şablon elemanı örneği

Bu nesne, schemaVersion: 2 şablonunun elements dizisine eklenen bir grafik elemanıdır; tek başına bir render isteği değildir. Örnek, veriyi doğrudan content.data içinde tutar.

{
  "id": "monthly-revenue",
  "type": "chart",
  "placementMode": "flow",
  "layout": { "width": 100, "widthUnit": "percent", "height": 240 },
  "content": {
    "title": "Revenue",
    "data": [{ "month": "Jan", "revenue": 42 }, { "month": "Feb", "revenue": 52 }]
  },
  "chart": {
    "type": "bar",
    "labelField": "month",
    "series": [{ "field": "revenue", "label": "Revenue", "color": "#e3232a" }],
    "showLegend": true,
    "showValues": true
  }
}

Dinamik veri bağlama

Her üretimde farklı veri kullanmak için grafik elemanına binding: monthlyRevenue ekleyin ve istek verisinde monthlyRevenue adlı nesne dizisini gönderin. Bu kullanımda content.data alanını kaldırın. labelField kategori alanını, her serinin field değeri sayısal alanı seçer. sales.net gibi iç içe alan yolları kullanılabilir.

Eksik veya sonlu olmayan sayılar sıfıra çevrilmez; çizgi ve alan grafiklerinde boşluk olarak kalır. Pasta ve halkada negatif değerleri veri kaynağında düzeltin. Yoğun grafiklerde çakışmayı önlemek için bazı değer etiketleri gösterilmeyebilir.

Canlı veriyle bir rapor

monthlyRevenue'a bağlanmış bir grafik, istekteki aynı adlı diziyi okur. Şablon aynı kalır; her çağrıda yalnız sayılar gelir.

curl -X POST https://api.pdfgine.com/api/v1/render \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "templateCode": "sales-report",
        "format": "pdf",
        "locale": "tr",
        "data": {
          "monthlyRevenue": [
            { "month": "2026-01", "revenue": 42000, "target": 40000 },
            { "month": "2026-02", "revenue": 51500, "target": 45000 },
            { "month": "2026-03", "revenue": 47250, "target": 50000 }
          ]
        }
      }'

Dizideki her nesne bir kategoridir. labelField kategori adını, her seri alanı da aynı nesneden bir sayıyı seçer.

Sık takılınan yerler

• binding ile content.data birbirinin alternatifidir, ikisi birden kullanılmaz. İkisini de taşıyan bir grafik sabit veriyi çizmeye devam eder ve isteğiniz yok sayılmış gibi görünür.
• Seri değerleri sayı olmalı. "42.000,00" bir metindir; okuyucu için biçimlendirmeyi seride değil bir metin öğesinde yapın.
• Bir grafik en çok 100 nokta ve 6 seri alır. Fazla satırların çizilmesini ummak yerine göndermeden önce toplayın.
• Word'de grafik bir görseldir, düzenlenebilir bir Word grafiği değil. İçine tıklamayı bekleyen okuyucu hayal kırıklığına uğrar; PDF ve görüntüleyici aynı çizimi gösterir.
• 100%, sayfanın değil içinde bulunduğu alanın genişliğidir. Bir sütunun ya da iç boşluklu bir kabın içinde sayfadan dardır.

Önizleme ve çıktı davranışı

Grafikler ortak SVG çiziminden üretilir. PDF ve Viewer grafik görünümünü korur; Word çıktısında grafik bir görsel olarak yer alır, Word'ün düzenlenebilir yerel grafik nesnesi değildir.

%100 genişlik, kağıdın tamamını değil grafiği barındıran alanın kullanılabilir genişliğini ifade eder. Sayfa kenar boşlukları, kolonlar ve iç boşluklar bu alanı daraltabilir.