Adım rehberi

Dosya ve Excel

18 adım: ne yaptığı, nasıl kullanıldığı, ne sonuç verdiği ve hangi deneme akışında denendiği. Peyrev 1.8.0.

36

Excel / CSV oku

Excel (.xlsx) veya CSV tablosunu satır listesine çevirir. Başlıklar alan adı olur: ${row.Tutar}.

Nasıl kullanılır?

  1. Seç… ile .xlsx veya .csv dosyasını gösterin.
  2. Ardından Her satır için ekleyip listeyi verin.

Sonuç

${rows}: satır listesi. İlk satırdaki başlıklar alan adı olur: ${row.Tutar}.

İpucu. Excel'de yaptığınız değişiklikler kaydedilmeden okunmaz.

Alanlar (5)
Dosya zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Sayfa adı
Boş: ilk/aktif sayfa.
Başlık satırı
0: başlık yok (sutun_1, sutun_2…).
En fazla satır
Okunacak en fazla satır sayısı. İlk denemede 1–2 yapın.
Sonucu değişkene kaydet zorunlu
Sonuca vereceğiniz ad. Yalnız adı yazın; ${ } işaretleri burada yazılmaz.

Uygulamalı deneme: Deneme 04 · Excel ve dosya işlemleri, Deneme 06 · Word'den PDF, Excel ve yazıcı, Deneme 07 · Web sayfasında form, tablo ve sekmeler

37

Excel / CSV'ye yaz

Kayıt listesini .xlsx veya .csv dosyasına yazar ya da mevcut dosyanın sonuna ekler.

Nasıl kullanılır?

  1. Kayıtlar alanına listeyi verin (ör. Listeye ekle ile toplanan ${results}).
  2. Seç… ile kaydedilecek dosyayı belirleyin; Sonuna ekle mevcut satırları korur.
  3. Sonuna eklerken son satırı belirleyen sütunu yazın (ör. A); kayıtlar o sütundaki son dolu satırın altına gelir.

İpucu. Her alan başlık satırında aynı adı taşıyan sütuna yazılır; yeni alanlar sona eklenir. Tek hücreye veya formül yazmak için Excel hücresine yaz adımını kullanın. Windows'ta dosya Excel'de açıksa yazılamaz; önce kapatın.

Alanlar (6)
Kayıtlar zorunlu
Yazılacak kayıt listesi; genellikle Listeye ekle ile toplanan ${results}.
Dosya zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Sayfa adı (Excel)
Excel dosyasında yazılacak sayfanın adı; CSV'de kullanılmaz.
Yazma biçimi
Üzerine yaz mevcut dosyayı siler; Sonuna ekle korur. Seçenekler: Yeni dosya / üzerine yaz, Sonuna ekle.
Son satırı belirleyen sütun (Excel)
Yeni kayıtlar bu sütundaki son dolu satırın altına yazılır (ör. A). Boşsa herhangi bir sütunda değer olan son satır esas alınır; yalnız biçimlendirilmiş boş satırlar sayılmaz.
= ile başlayan değerleri formül olarak yaz (Excel)
Açıkken = ile başlayan değerler formül olarak yazılır. Kapalıyken metin olarak saklanır; dışarıdan gelen veri formüle dönüşmez.

Uygulamalı deneme: Deneme 04 · Excel ve dosya işlemleri

38

Excel hücresine yaz

Bir değeri veya formülü seçtiğiniz sütuna yazar: belirli bir satıra, son dolu satıra ya da son dolu satırın altına. Son satırı hangi sütunun belirleyeceğini siz seçersiniz.

Nasıl kullanılır?

  1. Seç… ile .xlsx dosyasını gösterin ve sayfa adını yazın.
  2. Yazılacak sütunun harfini girin (ör. D).
  3. Satırı seçin: belirli satır numarası, son dolu satır veya son dolu satırın altı. Son satır için hangi sütunun esas alınacağını yazın (ör. kayıt numarasının olduğu A).
  4. Değeri yazın; formül için Değer türünü Formül yapın.

Sonuç

${excel_cell.cell}: yazılan hücre (ör. D15). ${excel_cell.row}: satır numarası.

İpucu. Formüller İngilizce işlev adı ve virgülle yazılır: TOPLA yerine SUM, ; yerine virgül. Türkçe Excel dosyayı açınca kendi dilinde gösterir. Formülün sonucu dosya Excel'de açılıp kaydedilince hesaplanır; Excel / CSV oku o zamana kadar formül hücresini boş okur. Windows'ta dosya Excel'de açıksa yazılamaz.

Alanlar (9)
Dosya zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Sayfa adı
Mevcut dosyada bu sayfa yoksa yazma yapılmaz. Boş: dosyanın etkin sayfası.
Sütun zorunlu
Değerin yazılacağı sütun harfi (ör. A, D, AB).
Satır zorunlu
Belirli satır: satır numarasını siz verirsiniz. Son dolu satırın altına: listeye yeni satır ekler. Son dolu satıra: son kaydın yanına değer yazar. Seçenekler: Belirli satır numarası, Son dolu satırın altına (yeni satır), Son dolu satıra.
Satır numarası zorunlu
1: ilk satır. Döngüde okunan satırın kendisine yazmak için ${row.row_number}.
Son satırı belirleyen sütun
Son satırı hangi sütunun belirleyeceği (ör. kayıt numarasının olduğu A sütunu). Boşsa yazılan sütun esas alınır.
Değer türü zorunlu
Metin / değer olduğu gibi yazar; = ile başlayan metin formüle dönüşmez. Sayı, 1250,50 gibi değerleri Excel'de sayı olarak saklar. Formül, değeri Excel formülü olarak yazar. Seçenekler: Metin / değer, Sayı, Formül.
Yazılacak değer
Sabit değer veya ${değişken}. Formülde İngilizce işlev adı ve virgül kullanın (ör. =SUM(B2:B{satir})); {satir} yazılan satırın numarası olur.
Sonucu değişkene kaydet zorunlu
Sonuca vereceğiniz ad. Yalnız adı yazın; ${ } işaretleri burada yazılmaz.

Uygulamalı deneme: Deneme 04 · Excel ve dosya işlemleri

39

Zip aç / oluştur

Bir zip dosyasını klasöre açar veya dosya ve klasörlerden zip oluşturur. Türkçe dosya adları korunur.

Nasıl kullanılır?

  1. İşlemi seçin: Zip'i klasöre aç veya Zip oluştur.
  2. Açarken zip dosyasını ve açılacak klasörü; oluştururken her satıra bir dosya/klasör ve zip dosyasının adını yazın.

Sonuç

${zip_result.files}: açılan veya eklenen dosyalar; ${zip_result.count}: sayısı.

İpucu. Aynı adlı dosya varsa, üzerine yazma açık değilse hiçbir dosya yazılmaz. Klasör dışına yazmaya çalışan zip'ler açılmaz. Windows'ta oluşturulmuş zip'lerdeki Türkçe adlar korunur.

Alanlar (7)
İşlem zorunlu
Aç: zip'teki dosyalar klasöre çıkarılır. Oluştur: dosya ve klasörler tek zip olur. Seçenekler: Zip'i klasöre aç, Zip oluştur.
Zip dosyası zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Açılacak klasör zorunlu
Klasör yoksa oluşturulur. Zip'teki klasör yapısı korunur.
Eklenecek dosya ve klasörler zorunlu
Her satıra bir dosya veya klasör yolu yazın; klasörler içindekilerle eklenir.
Oluşturulacak zip dosyası zorunlu
Ör. C:\Raporlar\gunluk.zip
Aynı adlı dosyaların üzerine yaz
Kapalıyken aynı adlı dosya varsa hiçbir dosya yazılmaz.
Sonucu değişkene kaydet zorunlu
Dosya listesi: ${zip_result.files}, sayısı: ${zip_result.count}.

Uygulamalı deneme: Deneme 01 · Hazırlık: deneme dosyalarını indir, Deneme 04 · Excel ve dosya işlemleri

40

PDF'ten oku

PDF'in metnini veya içindeki bir tabloyu okur. Taranmış (metni olmayan) sayfalar sistem OCR'ıyla okunur.

Nasıl kullanılır?

  1. PDF dosyasını seçin.
  2. Metin için Ne okunsun: Metin; çizgili bir tablo için Tablo seçin.
  3. Gerekirse sayfaları yazın (ör. 1-2). Metinden fatura no veya tutar almak için ardından Metin işlemi → Desenle bilgi çıkar ekleyin.

Sonuç

Metin modunda ${pdf_text} metindir; tablo modunda Her satır için ile kullanılacak satır listesidir.

İpucu. Taranmış sayfalar sistem OCR'ıyla okunur; kalite taramaya bağlıdır. Şifreli PDF okunmaz.

Alanlar (7)
PDF dosyası zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Ne okunsun? zorunlu
Üzerine yaz mevcut dosyayı siler; Sonuna ekle korur. Seçenekler: Metin, Tablo (satır listesi).
Sayfalar
Boş: tüm sayfalar. Ör. 1 veya 1-3, 5.
Metni olmayan sayfaları OCR ile oku
Taranmış belge ve fotoğraf sayfaları için. Kapalıyken bu sayfalar boş gelir.
Kaçıncı tablo
Seçilen sayfalardaki tabloların sırası; 1 ilk tablodur. Tablolar çizgileriyle tanınır.
İlk satır sütun başlıklarıdır
Açıkken başlıklar alan adı olur: ${row.Tutar}. Kapalıyken sutun_1, sutun_2…
Sonucu değişkene kaydet zorunlu
Metin modunda okunan metin; tablo modunda Her satır için ile kullanılacak satır listesi.

Uygulamalı deneme: Deneme 05 · PDF, e-Fatura ve Word belgeleri

41

Metin dosyası oku

Bir .txt, .json veya log dosyasının içeriğini okur.

Nasıl kullanılır?

  1. Seç… ile dosyayı gösterin.

Sonuç

Dosyanın içeriği metin olarak değişkene alınır.

Alanlar (2)
Dosya zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Sonucu değişkene kaydet zorunlu
Sonuca vereceğiniz ad. Yalnız adı yazın; ${ } işaretleri burada yazılmaz.

Uygulamalı deneme: Deneme 03 · Döngüler, koşullar ve hata yakalama, Deneme 04 · Excel ve dosya işlemleri

42

Metin dosyasına yaz

Metni dosyaya yazar veya sonuna ekler (günlük tutma).

Nasıl kullanılır?

  1. Dosyayı ve yazılacak metni girin.
  2. Günlük tutmak için Sonuna ekle seçin.
Alanlar (3)
Dosya zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Metin zorunlu
Dosyaya yazılacak metin; ${değişken} kullanılabilir.
Yazma biçimi
Üzerine yaz mevcut dosyayı siler; Sonuna ekle korur. Seçenekler: Sonuna ekle, Üzerine yaz.

Uygulamalı deneme: Deneme 04 · Excel ve dosya işlemleri

43

Dosya / klasör var mı?

Sonucu Koşul adımında kullanın: ${file_exists}.

Nasıl kullanılır?

  1. Kontrol edilecek yolu yazın veya seçin.

Sonuç

${file_exists}: var mı? Koşul adımında Dolu / doğru ile kontrol edin.

Alanlar (3)
Yol zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Tür
Yalnız dosya veya yalnız klasör aranacaksa seçin. Seçenekler: Dosya veya klasör, Dosya, Klasör.
Sonucu değişkene kaydet zorunlu
Sonuca vereceğiniz ad. Yalnız adı yazın; ${ } işaretleri burada yazılmaz.

Uygulamalı deneme: Deneme 01 · Hazırlık: deneme dosyalarını indir, Deneme 04 · Excel ve dosya işlemleri, Deneme 05 · PDF, e-Fatura ve Word belgeleri, Deneme 06 · Word'den PDF, Excel ve yazıcı, Deneme 07 · Web sayfasında form, tablo ve sekmeler, Deneme 09 · Kullanıcıya sor, pano ve komut, Deneme 11 · E-posta gönder, oku, işaretle ve mesaj kanalı, Deneme 14 · FTP / SFTP ile dosya gönder ve al, Deneme 15 · Yapay zekâ ve Telegram onayı

44

Klasördeki dosyaları listele

Klasördeki dosyaları listeler; Her satır için döngüsüyle tek tek işleyin (${row.path}).

Nasıl kullanılır?

  1. Klasörü seçin; gerekiyorsa *.pdf gibi bir desen yazın.
  2. Ardından Her satır için ile dosyaları tek tek işleyin.

Sonuç

${files}: dosya listesi. Döngüde ${row.path} tam yol, ${row.name} dosya adıdır.

Alanlar (5)
Klasör zorunlu
Seç… ile klasörü gösterin. ${sistem.masaustu} gibi hazır değişkenler de kullanılabilir.
Dosya deseni
Ör. *.xlsx, fatura_*.pdf
Alt klasörler dahil
Açıksa alt klasörlerdeki dosyalar da listelenir.
Sıralama
En yeni önce: son indirilen dosyayı bulmak için. Seçenekler: Ada göre, En yeni önce, En eski önce.
Sonucu değişkene kaydet zorunlu
Sonuca vereceğiniz ad. Yalnız adı yazın; ${ } işaretleri burada yazılmaz.

Uygulamalı deneme: Deneme 01 · Hazırlık: deneme dosyalarını indir, Deneme 04 · Excel ve dosya işlemleri

45

Dosya kopyala / taşı / sil

Dosya veya klasörle işlem yapar.

Nasıl kullanılır?

  1. İşlemi seçin: kopyala, taşı / yeniden adlandır, sil veya klasör oluştur.
  2. Kaynağı ve gerekiyorsa hedefi girin.

İpucu. Sil geri alınamaz. Önce Dosya / klasör var mı? ile kontrol etmek güvenlidir.

Alanlar (4)
İşlem zorunlu
Sil geri alınamaz; dosya çöp kutusuna gitmez. Seçenekler: Kopyala, Taşı / yeniden adlandır, Sil, Klasör oluştur.
Kaynak zorunlu
İşlem yapılacak dosya veya klasör.
Hedef zorunlu
Kopyalama ve taşımada yeni yol; Sil'de kullanılmaz.
Varsa üzerine yaz
Kapalıyken hedef zaten varsa adım durur.

Uygulamalı deneme: Deneme 01 · Hazırlık: deneme dosyalarını indir, Deneme 04 · Excel ve dosya işlemleri, Deneme 05 · PDF, e-Fatura ve Word belgeleri, Deneme 06 · Word'den PDF, Excel ve yazıcı, Deneme 10 · Masaüstü programı: Not Defteri

46

Dosyanın oluşmasını bekle

İndirilen veya dışa aktarılan dosya hazır olana kadar bekler; yolunu kaydeder.

Nasıl kullanılır?

  1. Dosyanın oluşacağı klasörü ve adını (veya *.xlsx gibi deseni) yazın.
  2. İndirmeyi veya dışa aktarmayı başlatan adımdan hemen sonra ekleyin.

Sonuç

Hazır olan dosyanın tam yolu.

Alanlar (3)
Dosya yolu / deseni zorunlu
Ör. ~/Downloads/rapor*.xlsx
En fazla bekle (saniye)
Dosya bu süre içinde oluşmazsa adım durur.
Sonucu değişkene kaydet zorunlu
Sonuca vereceğiniz ad. Yalnız adı yazın; ${ } işaretleri burada yazılmaz.

Uygulamalı deneme: Deneme 04 · Excel ve dosya işlemleri

47

Çalışma raporu (CSV / Excel)

Kayıtları çalışma çıktılarına indirilebilir CSV veya Excel (.xlsx) dosyası olarak yazar.

Nasıl kullanılır?

  1. Kayıtlar alanına listeyi verin.
  2. Biçimi seçin: CSV veya Excel (.xlsx).
  3. Dosyaya bir ad verin.

Sonuç

Dosya, çalışma ayrıntısından indirilebilir.

İpucu. = ile başlayan değerler formüle dönüşmez, metin olarak yazılır. Bilgisayarda bir klasöre yazmak için Excel / CSV'ye yaz adımını kullanın.

Alanlar (3)
Kayıtlar zorunlu
Yazılacak kayıt listesi; genellikle Listeye ekle ile toplanan ${results}.
Biçim
CSV her programda açılır; Excel (.xlsx) sütunları ve Türkçe karakterleri doğrudan Excel'de doğru gösterir. Seçenekler: CSV (Excel uyumlu), Excel (.xlsx).
Dosya adı zorunlu
Çalışma çıktılarında görünecek ad. Uzantı seçilen biçime göre .csv veya .xlsx olur.

Uygulamalı deneme: Deneme 04 · Excel ve dosya işlemleri

93

Dosya bilgisi ve uzantı kontrolü

Dosyanın adını, uzantısını, boyutunu ve içerik türünü okur; izin verilen uzantıları ve içeriğin uzantıyla uyuşmasını denetler (ör. .xlsx adıyla inen bir web sayfası).

Nasıl kullanılır?

  1. Dosya yolu alanına indirilen veya seçilen dosyanın değişkenini yazın (ör. ${web_file}).
  2. İzin verilen uzantıları virgülle yazın (ör. xlsx, csv); boş bırakırsanız her uzantı kabul edilir.
  3. Uygun değilse akışın durmasını veya devam edip sonucu Koşul ile kontrol etmeyi seçin.

Sonuç

${file_info}: name (ad), extension (uzantı, noktasız), size (bayt), modified (değişme zamanı), type (içerik türü), ok (uygun mu), problem (neden uygun değil).

İpucu. İçerik denetimi dosyanın ilk baytlarına bakar: .xlsx adıyla inen web sayfası, boş dosya veya .pdf olmayan .pdf yakalanır. Koşul'da ${file_info.extension} eşittir xlsx gibi karşılaştırabilirsiniz.

Alanlar (5)
Dosya yolu zorunlu
İndirilen veya seçilen dosyanın değişkeni (${web_file}, ${chosen_file}, ${row.path}) ya da tam yol.
İzin verilen uzantılar
Virgülle ayırın (ör. xlsx, xls, csv). Boş: her uzantı kabul edilir.
İçeriğin uzantıyla uyuştuğunu denetle
Açıkken dosyanın içi okunur; .xlsx adıyla web sayfası veya boş dosya gibi durumlar yakalanır.
Uygun değilse zorunlu
Dosya yoksa, uzantısı izinli değilse veya içeriği uyuşmuyorsa ne olacağı. Devam seçilirse ${file_info.ok} yanlış olur ve neden ${file_info.problem} içinde yazar. Seçenekler: Akışı durdur, Devam et (sonucu Koşul ile kontrol et).
Sonucu değişkene kaydet zorunlu
Sonraki adımlarda ${file_info.extension}, ${file_info.ok}, ${file_info.size} ve ${file_info.problem} ile kullanın.

Uygulamalı deneme: Deneme 01 · Hazırlık: deneme dosyalarını indir, Deneme 04 · Excel ve dosya işlemleri, Deneme 06 · Word'den PDF, Excel ve yazıcı, Deneme 14 · FTP / SFTP ile dosya gönder ve al

98

XML / JSON dosyası oku (e-Fatura, e-İrsaliye)

e-Fatura / e-Arşiv ve e-İrsaliye XML'inden belge no, ETTN, tarih, taraflar, tutarlar ve kalemleri okur; başka XML ve JSON dosyalarını alanlarıyla değişkene alır. Zip verilirse içindeki her dosyayı okur.

Nasıl kullanılır?

  1. Seç… ile .xml, .json veya içinde bunlar olan .zip dosyasını gösterin.
  2. Okuma biçimini seçin: Otomatik, e-Fatura, e-İrsaliye, genel XML veya JSON.
  3. Bir klasördeki faturaların hepsi için Klasördeki dosyaları listele (*.xml) ve Her satır için ekleyin; Dosya alanına ${row.path} yazın. Zip'te Her satır için'e ${fatura.kayitlar} verin.

Sonuç

e-Fatura'da ${fatura.fatura_no}, ettn, tarih, tip, senaryo, para_birimi; satici ve alici (unvan, vkn_tckn, vergi_dairesi, adres); ara_toplam, iskonto, vergiler_haric, kdv_toplam, vergiler_dahil, odenecek; kalemler (sira, aciklama, miktar, birim, birim_fiyat, iskonto, kdv_orani, kdv_tutari, tutar). Tutarlar sayıdır. XML'de öznitelikler @ad, metin #text olur; tekrar eden öğeler liste olur. e-İrsaliye'de irsaliye_no, sevk_tarihi, gonderen, alici, tasiyici, plaka, sofor ve kalemler. Zip'te kayitlar (her biri dosya ve alanları) ve atlananlar (dosya, neden).

İpucu. Dosya en fazla 20 MB olabilir. Güvenlik için DOCTYPE içeren XML okunmaz. Seçilen biçime uymayan XML okunmaz; zip'te böyle dosyalar atlanıp atlananlar listesine yazılır.

Alanlar (3)
Dosya zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir. .zip verilirse içindeki bütün .xml (JSON'da .json) dosyaları okunur.
Okuma biçimi zorunlu
Otomatik: e-Fatura ve e-İrsaliye kendiliğinden tanınır (${fatura.belge_turu}). e-Fatura / e-İrsaliye: GİB'in UBL-TR belgesi alanlarına ayrılır. XML: her XML alan adlarıyla okunur. JSON: .json dosyası. Seçenekler: Otomatik (e-Fatura veya e-İrsaliye), e-Fatura / e-Arşiv (UBL-TR XML), e-İrsaliye (UBL-TR XML), XML (alanlarıyla), JSON.
Sonucu değişkene kaydet zorunlu
e-Fatura'da ${fatura.fatura_no}, ${fatura.odenecek}, ${fatura.satici.unvan}; kalemler ${fatura.kalemler} (Her satır için ile). Zip'te ${fatura.kayitlar} ve ${fatura.atlananlar}.

Uygulamalı deneme: Deneme 05 · PDF, e-Fatura ve Word belgeleri

100

Word şablonundan belge üret

Teklif, sözleşme, mektup veya sevk belgesi: Word şablonundaki {{musteri_adi}} gibi alanları doldurup yeni bir .docx kaydeder; tablo satırlarını listeden çoğaltır, isterseniz PDF'ini de kaydeder.

Nasıl kullanılır?

  1. Word'de belgeyi hazırlayın; değişecek yerlere {{musteri_adi}}, {{tutar}} gibi alanlar yazıp .docx olarak kaydedin.
  2. Şablonu, kaydedilecek belgenin yolunu ve değerleri seçin (ör. Excel'den okunan satır için ${row}).
  3. Kalem tablosu için tablonun bir satırına {{satir.urun}}, {{satir.miktar}} yazın ve Tablo satırları alanına listeyi verin (ör. ${kalemler}).

Sonuç

${olusan_belge.docx}: kaydedilen belge; ${olusan_belge.pdf}: PDF'in yolu (istenmediyse boş).

İpucu. Değeri olmayan bir alan varsa belge kaydedilmez ve eksik alanlar yazılır. Alanın biçimi (yazı tipi, kalınlık) korunur. PDF için Windows'ta Microsoft Word, macOS'ta LibreOffice veya Microsoft Word gerekir.

Alanlar (7)
Word şablonu (.docx) zorunlu
Alanları {{musteri_adi}}, {{tutar}} biçiminde yazılmış belge. Şablon değişmez.
Kaydedilecek belge (.docx) zorunlu
Ör. C:\Teklifler\teklif_${row.no}.docx; klasör yoksa oluşturulur.
Değerler zorunlu
Alan adları şablondakilerle aynı olan kayıt: ${row} veya {"musteri_adi": "${musteri}"}. {{musteri.adres}} gibi iç alanlar da kullanılabilir.
Tablo satırları (isteğe bağlı)
Liste değişkeni (ör. ${kalemler}). Şablonda {{satir.urun}}, {{satir.tutar}} içeren tablo satırı her öğe için biçimiyle birlikte tekrarlanır.
Varsa üzerine yaz
Kapalıyken aynı adlı belge veya PDF varsa hiçbir dosya yazılmaz.
PDF olarak da kaydet
Aynı ada .pdf uzantılı kopya kaydedilir. Windows'ta Microsoft Word, macOS'ta LibreOffice veya Microsoft Word kurulu olmalıdır.
Sonucu değişkene kaydet zorunlu
Belgenin yolu ${olusan_belge.docx}; PDF'in yolu ${olusan_belge.pdf} (PDF istenmediyse boş).

Uygulamalı deneme: Deneme 05 · PDF, e-Fatura ve Word belgeleri, Deneme 06 · Word'den PDF, Excel ve yazıcı

101

PDF birleştir / böl / sayfa çıkar / şifrele

PDF dosyalarını birleştirir, sayfalara böler, seçilen sayfaları yeni PDF'e çıkarır, şifreler veya sayfa sayısını okur. Kaynak dosyalar değişmez.

Nasıl kullanılır?

  1. İşlemi seçin: birleştir, böl, sayfa çıkar, şifrele veya sayfa sayısını oku.
  2. Kaynak PDF'i (birleştirmede her satıra bir PDF) ve kaydedilecek dosyayı ya da klasörü yazın.
  3. Şifrelerken şifreyi Ayarlar → Kayıtlı şifreler'e kaydedip ${sifre.ad} ile verin.

Sonuç

${pdf_result.path}: oluşan PDF; bölmede ${pdf_result.files} dosya listesi; ${pdf_result.pages} sayfa sayısı.

İpucu. Kaynak dosyalar değişmez. Aynı adlı dosya varsa, üzerine yazma açık değilse hiçbir dosya yazılmaz. Şifreli PDF birleştirilemez veya bölünemez; şifresiz kopyasını kullanın.

Alanlar (10)
İşlem zorunlu
Birleştir: birden çok PDF tek dosya olur. Böl: her sayfa (veya N sayfa) ayrı dosya. Sayfa çıkar: seçilen sayfalar yeni PDF olur. Şifrele: açmak için şifre ister. Kaynak dosyalar değişmez. Seçenekler: Birleştir, Böl (sayfa sayfa), Sayfa çıkar, Şifrele, Sayfa sayısını oku.
Birleştirilecek PDF'ler zorunlu
Her satıra bir PDF yolu veya bir liste değişkeni (ör. Klasördeki dosyaları listele'nin ${files} sonucu). Sırayla birleştirilir.
PDF dosyası zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Çıkarılacak sayfalar zorunlu
Ör. 1-3, 5. Sayfalar yazdığınız sırayla yeni PDF'e eklenir.
Kaç sayfada bir bölünsün?
1: her sayfa ayrı dosya. 2: iki sayfada bir. Dosyalar ad_001.pdf, ad_002.pdf… olur.
Kaydedilecek klasör zorunlu
Klasör yoksa oluşturulur.
Kaydedilecek PDF zorunlu
Ör. C:\Raporlar\birlesik.pdf
PDF şifresi zorunlu
Kayıtlı şifre için ${sifre.ad} yazın; şifre akış dosyasında açık durmaz ve günlüğe yazılmaz. PDF AES-256 ile şifrelenir.
Varsa üzerine yaz
Kapalıyken aynı adlı dosya varsa hiçbir dosya yazılmaz.
Sonucu değişkene kaydet zorunlu
${pdf_result.path}: oluşan PDF, ${pdf_result.files}: bölünen dosyalar, ${pdf_result.pages}: sayfa sayısı.

Uygulamalı deneme: Deneme 05 · PDF, e-Fatura ve Word belgeleri

102

Dosyayı yazdır

PDF, resim, metin veya (Windows'ta) Word ve Excel belgesini varsayılan ya da seçilen yazıcıya gönderir.

Nasıl kullanılır?

  1. Yazdırılacak dosyayı seçin (ör. ${olusan_belge.pdf}).
  2. Belirli bir yazıcı gerekiyorsa adını yazın; boşsa varsayılan yazıcı kullanılır.
  3. Kopya sayısını girin.

Sonuç

${print_result.job}: Mac'te yazdırma işinin numarası; Windows'ta boştur.

İpucu. Windows'ta dosyayı türünün programı (PDF için Acrobat Reader gibi) yazdırır; o program kısa süre açılabilir. Mac'te PDF, resim ve metin doğrudan yazdırılır; Word ve Excel belgelerini önce PDF'e çevirin.

Alanlar (4)
Yazdırılacak dosya zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Yazıcı adı
Boş: varsayılan yazıcı. Windows'ta Yazıcılar ve tarayıcılar listesindeki ad; Mac'te Terminal'de lpstat -p ile görünen ad.
Kopya sayısı
1–99.
Sonucu değişkene kaydet zorunlu
Sonuca vereceğiniz ad. Yalnız adı yazın; ${ } işaretleri burada yazılmaz.

Uygulamalı deneme: Deneme 06 · Word'den PDF, Excel ve yazıcı

103

Excel'de bul ve güncelle

Aranacak sütunda değeri bulur ve o satırın başka sütunlarına yazar: fatura no'su 1042 olan satırın Durum sütununa İşlendi gibi. Bulunamazsa isterseniz yeni satır ekler. Dosyanın diğer içeriği ve biçimi korunur.

Nasıl kullanılır?

  1. Seç… ile .xlsx veya .xlsm dosyasını gösterin; gerekirse sayfa adını yazın.
  2. Aranacak sütunun başlığını (ör. Fatura No) ve aranan değeri (ör. ${row.no}) yazın.
  3. Yazılacak değerleri sütun başlığıyla girin: {"Durum": "İşlendi"}.
  4. Bulunamazsa ve birden fazla eşleşirse ne olacağını seçin.

Sonuç

${excel_satir.bulundu}: bulundu mu, ${excel_satir.satirlar}: yazılan satır numaraları, ${excel_satir.eklendi}: yeni satır eklendi mi.

İpucu. Dosyanın diğer hücreleri, biçimleri ve formülleri korunur; .xlsm'deki makrolar kalır. Excel olmadan kaydedildiği için grafikler, resimler ve bazı gelişmiş öğeler kaybolabilir. Windows'ta dosya Excel'de açıksa yazılamaz; önce kapatın.

Alanlar (10)
Dosya zorunlu
Tam yol: C:\Raporlar\liste.xlsx veya ~/Desktop/liste.xlsx. %USERPROFILE% ve ~ kullanılabilir.
Sayfa adı
Boş: ilk/aktif sayfa.
Başlık satırı
Sütun başlıklarının bulunduğu satır; arama bunun altındaki satırlarda yapılır.
Aranacak sütun zorunlu
Aranacak değerin bulunduğu sütunun başlığı (ör. Fatura No). Başlık yoksa sütun harfi (B) veya Excel / CSV oku'daki gibi sutun_2 yazılabilir.
Aranacak değer zorunlu
Aranan değer; döngüde genellikle ${row.no} gibi bir değişken.
Karşılaştırma zorunlu
Birebir: yazıldığı gibi. Harf ve boşluk fark etmez: İ/i, I/ı dahil büyük/küçük harf ve boşluklar yok sayılır. Sayı: 1.250,00 ile 1250 aynı kabul edilir. Seçenekler: Birebir aynı, Büyük/küçük harf ve boşluk fark etmez, Sayı olarak (1.250,00 = 1250).
Yazılacak değerler zorunlu
Sütun başlığı ve yazılacak değer: {"Durum": "İşlendi", "Tarih": "${bugun}"}. = ile başlayan değer formül olarak yazılır (ör. "=B{satir}*C{satir}"; {satir} satırın numarası olur). Değişkenden gelen = ile başlayan metin formüle dönüşmez.
Bulunamazsa zorunlu
Durdur: adım hata verir. Yeni satır: aranan değer ve yazılacak değerler son dolu satırın altına eklenir. Devam et: hiçbir şey yazılmaz, ${excel_satir.bulundu} yanlış olur. Seçenekler: Akışı durdur, Yeni satır olarak ekle, Devam et (sonucu Koşul ile kontrol et).
Birden fazla satır eşleşirse zorunlu
Aynı değer birden fazla satırda varsa ne yapılacağı. Durdur seçiliyken hiçbir satır değişmez. Seçenekler: Akışı durdur, Yalnız ilk satırı güncelle, Hepsini güncelle.
Sonucu değişkene kaydet zorunlu
${excel_satir.bulundu}: bulundu mu, ${excel_satir.satirlar}: güncellenen satır numaraları, ${excel_satir.eklendi}: yeni satır eklendi mi.

Uygulamalı deneme: Deneme 04 · Excel ve dosya işlemleri