Word ve PowerPoint Raporlarını Python ile Otomatik Hazırlamak

Python ile Word ve PowerPoint otomasyonu neyi çözer?

Haftalık satış raporu, müşteri başına hazırlanan teklif mektubu, aylık yönetim sunumu: bu belgelerin ortak noktası yapısının hemen hiç değişmemesi, yalnızca içindeki verinin değişmesidir. Her dönem aynı şablonu açıp rakamları elle kopyalamak hem zaman alır hem de hata üretir. Python ile bu işi tersine çevirirsiniz: veri kaynağını (Excel, CSV, veritabanı ya da bir API) okur, şablonu doldurur ve belgeyi kaydedersiniz.

Word için en yaygın kütüphane python-docx, PowerPoint için python-pptx'tir. İkisi de Office uygulamasını açmadan, doğrudan dosya biçimi üzerinden çalışır. Bu da betiğin sunucuda, zamanlanmış bir görevde ya da kimsenin oturmadığı bir bilgisayarda çalışabilmesi demektir.

Otomasyonun mantıklı olduğu durumlar şunlardır: • Aynı belge türü düzenli aralıklarla ve farklı verilerle yeniden üretiliyorsa • Aynı şablondan çok sayıda kişiye ya da müşteriye ayrı belge çıkarılıyorsa • Belge içeriği zaten bir tabloda ya da sistemde duruyor ve yalnızca sayfaya dökülüyorsa • Biçimlendirme kurallarına (başlık düzeni, yazı tipi, logo konumu) her belgede aynen uyulması gerekiyorsa

Tek seferlik, her seferinde yazısı baştan kurgulanan belgeler için otomasyon değer üretmez; orada elle yazmak daha hızlıdır.

Hangi kütüphaneler kullanılır ve nasıl kurulur?

Bu kütüphaneler standart Python kurulumuyla gelmez, pip ile eklenir. Sistem Python'unu kirletmemek için önce bir sanal ortam oluşturup paketleri orada kurmak sağlıklıdır; bu alışkanlık, betik başka bir bilgisayara taşındığında da aynı sürümlerle çalışmasını sağlar.

Word tarafında belge bir nesne olarak açılır; belgenin içinde paragraflar, başlıklar, tablolar ve görseller birer nesnedir ve her biri Python'dan okunup değiştirilebilir. PowerPoint tarafında ise sunum, slaytlardan oluşur; her slaytın bir düzeni (layout) ve bu düzenin içinde başlık, içerik, görsel yer tutucuları bulunur. Kod, bu yer tutucuların içine metin, tablo ya da resim yerleştirir.

Grafikler için farklı yollar vardır. Birincisi matplotlib gibi bir kütüphaneyle grafiği resim dosyası olarak üretip belgeye görsel diye eklemektir; bu en basit ve en az sorun çıkaran yoldur. Diğeri, python-pptx'in yerel grafik nesnelerini kullanmaktır; bu durumda grafik PowerPoint içinde düzenlenebilir kalır ama kod biraz daha uzun olur.

Veriyi okumak için çoğunlukla pandas kullanılır: Excel ya da CSV dosyası tabloya dönüştürülür, satırlar üzerinde döngüyle gezilir ve her satır bir paragrafa, tablo satırına ya da slayta karşılık gelir.

Şablondan rapor üretmek: kısa bir uygulama

İyi bir otomasyon belgeyi sıfırdan çizmek yerine hazır şablonu doldurur. Tasarımı (logo, yazı tipi, başlık stilleri) Word ya da PowerPoint içinde elle yapın; kod yalnızca değişen içeriği yerleştirsin. Şu betik aynı veriden hem Word tablosu hem de bölge başına bir slayt üretir:

from docx import Document from pptx import Presentation

basliklar = ("Bölge", "Ürün grubu", "Durum") satirlar = [("Marmara", "Kuruyemiş", "Hedefin üstünde"), ("Ege", "Zeytinyağı", "Hedefin altında")] tum = [basliklar] + satirlar

belge = Document() belge.add_heading("Aylık Bölge Raporu") belge.add_paragraph("Bu rapor satış verisinden otomatik üretilmiştir.") tablo = belge.add_table(rows=len(tum), cols=len(basliklar)) for satir, degerler in zip(tablo.rows, tum): for hucre, deger in zip(satir.cells, degerler): hucre.text = deger belge.save("rapor.docx")

sunum = Presentation() duzen = sunum.slide_layouts.get_by_name("Title and Content") for bolge, product, durum in satirlar: slayt = sunum.slides.add_slide(duzen) slayt.shapes.title.text = bolge for yer in slayt.placeholders: if yer.placeholder_format.idx != slayt.shapes.title.placeholder_format.idx: yer.text = product + ": " + durum sunum.save("sunum.pptx")

Gerçek işte satirlar listesi pandas ile Excel dosyasından gelir, Presentation() yerine marka şablonu dosyası açılır ve slayt düzeni o şablondaki adıyla seçilir. Çıktıyı şablonun üzerine değil, tarih ya da bölge adı içeren yeni bir dosya adıyla kaydedin.

Yer tutucu değiştirmede bilinen bir tuzak vardır: Word, bir paragraftaki metni arka planda parçalara (run) bölebilir. Şablonda {{customer_name}} yazsanız bile ifade birden fazla parçaya dağılmış olabilir ve basit metin arama onu bulamaz. Yer tutucuyu şablona tek seferde yapıştırın ya da paragraf parçalarını birleştiren küçük bir yardımcı fonksiyon yazın.

Örnek senaryo: aylık satış raporunu Word ve PowerPoint olarak üretmek

Örneğin bir satış operasyonu ekibi her ay sonu bölge yöneticilerine kendi bölgelerinin raporunu gönderiyor olsun. Veri tek bir Excel dosyasında duruyor: bölge, temsilci, ürün grubu ve gerçekleşen satış sütunları var. Elle yapıldığında her bölge için tabloyu kopyalamak, grafiği yeniden çizmek ve yorum cümlelerini güncellemek uzun bir mesai alır.

Otomasyonda betik önce pandas ile dosyayı okur ve bölgeye göre gruplar. Her bölge için bir Word belgesi açılır; başlık bölge adıyla doldurulur, özet tablo eklenir, hedefin üzerinde ya da altında kalan ürün grupları için kısa bir cümle üretilir. Aynı veriden matplotlib ile çizilen grafik görsel olarak belgeye yerleştirilir.

Yönetim sunumu için ise python-pptx devreye girer: kapak slaytı ay adıyla, ardından her bölge için bir slayt, en sonda genel özet slaytı oluşturulur. Betik çalıştığında tüm belgeler bir klasöre dolar; e-posta otomasyonuyla bu dosyalar ilgili yöneticilere gönderilebilir.

Bu kurguda insanın işi, her ay verinin doğru olup olmadığını kontrol etmek ve yorum cümlelerinin mantığını (hangi koşulda hangi ifadenin yazılacağını) bir kez tanımlamaktır. Geri kalanı betik yapar.

Rapor otomasyonunu sessizce bozan hatalar

Otomasyon projelerinde sorunların çoğu kütüphanenin kendisinden değil, kurgudan çıkar. En sık görülenler şunlardır:

• Biçimi kodla sıfırdan kurmak. Yazı tipi, renk, hizalama gibi ayarları tek tek kodla vermek yerine şablondaki stilleri kullanın; bir tasarım değişikliği gerektiğinde yalnızca şablonu güncellersiniz.
• Uzun metinlerin taşmasını hesaba katmamak. Slaytta yer tutucuya sığmayan metin ekran dışına taşar. Metin uzunluğunu kontrol eden ya da yazı boyutunu küçülten bir kural ekleyin.
• Eksik veriyi görmezden gelmek. Bir hücre boşsa belgede boş bir yer kalır ya da kod hata verir. Betiğin başında veriyi doğrulayın, eksik varsa rapor üretmeden önce uyarı verin.
• Dosya adlarında özel karakter bırakmak. Müşteri adından dosya adı üretirken eğik çizgi, soru işareti gibi karakterleri temizleyin.
• Çıktıyı kimse görmeden dağıtmak. İlk haftalarda üretilen belgeleri göndermeden önce insan gözüyle kontrol eden bir adım bırakın.
• Betiği ve şablonu birlikte sürüm kontrolüne koymamak. Şablon değişir ama betik eski yapıya bakarsa rapor sessizce bozulur.

Belge şablonu çok karmaşıksa (çok sayıda koşullu bölüm, değişken sayfa düzeni), şablon dili kullanan bir kütüphane de düşünülebilir; ancak başlangıç için temel yer tutucu değiştirme çoğu iş için yeterlidir.

Word ve PowerPoint otomasyonunda öğrenme sırası

Başlangıç düzeyinde hedef, tek bir gerçek belgeyi otomatikleştirmektir. Kendi işinizde en sık elle hazırladığınız raporu seçin. Önce Python temellerini (değişkenler, döngüler, fonksiyonlar, dosya okuma) öğrenin, ardından pandas ile bir Excel dosyasını okumayı deneyin. Sonra python-docx ile boş bir belgeye başlık, paragraf ve tablo eklemeyi çalışın.

Orta düzeyde şablon doldurmaya, tablo satırı çoğaltmaya ve görsel eklemeye geçilir. Bu aşamada betiği hata yönetimi, loglama ve komut satırı parametreleriyle sağlamlaştırmak değer katar; böylece betik başkası tarafından da çalıştırılabilir hale gelir.

İleri düzeyde belge üretimi bir iş akışının parçası olur: veri bir API'den çekilir, belgeler üretilir, PDF'e dönüştürülür, e-postayla dağıtılır ve tüm bunlar zamanlanmış bir görev olarak kendiliğinden çalışır. Bu zincirin her halkası ayrı bir beceridir; belge üretimi tek başına bu zincirin ortasındaki halkadır.

Raporlama yükü olan ekipler için Mindset bağlamı

Mindset kataloğundaki Python Otomasyon ile Verimlilik programı, bu akışı uçtan uca çalışmak isteyen raporlama ekipleri için uygundur: Excel, PowerPoint ve Rapor Üretimi Otomasyonu modülü belge üretimini, E-posta Otomasyonu ve Bildirim Sistemleri modülü üretilen belgelerin dağıtımını ele alır.

Finans, satış operasyonu, insan kaynakları ve idari işler ekiplerinde her dönem aynı biçimde hazırlanan belgeler varsa program, ekibin ortak şablon ve betik kütüphanesi kurması için bir zemin sağlar.