PDF Generator
PDF Generator, bir şablon ile veriyi bir PDF'e dönüştürür ve akışınıza tamamlanmış dosyanın bağlantısını verir. Faturalar, makbuzlar, teklifler, sertifikalar, sözleşmeler ve raporlar için kullanın — akışınızın ardından WhatsApp veya e-postayla göndereceği her şey.
Şablonlar çalışma alanınızda durur ve bu node'un içinden düzenlenir. Bir belgenin görünümünü değiştirmek akışta yaptığınız bir iştir; sürüm çıkmayı gerektirmez.
Bir Agent node içinde kullanın, böylece ajan gerektiğinde belge üretsin; ya da sabit ve belirlenmiş bir belge için bağımsız bir Tool node olarak kullanın.
Akışa ekleme
Tool node'unun araç seçicisinde PDF Generator'ı seçin, belgenin nereden geleceğini belirleyin ve dolduracak veriyi verin.
Belge seçimi
| Belge | Ne zaman |
|---|---|
| Saved Template | Neredeyse her zaman. Çalışma alanınızda saklanan, sürüm geçmişi olan yeniden kullanılabilir şablon. |
| Inline HTML | Tek seferlik bir belge, ya da şablon olarak kaydetmeyi düşündüğünüz bir ilk taslak. |
Listede yalnızca kendi çalışma alanınızın şablonları görünür.
Şablon editörü
PDF Önizle'nin yanında, kayıtlı bir şablon seçiliyse Şablonu Düzenle, satır içi HTML yazıyorsanız Şablon Olarak Kaydet butonu vardır. İkisi de aynı editörü açar; editörün dört sekmesi vardır:
| Sekme | İçine ne girer |
|---|---|
| HTML | Belgenin gövdesi, Handlebars ile yazılır. {{yer_tutucular}} Data'dan doldurulur. |
| CSS | Stil dosyanız. Fontlar sizin için gömülür, böylece PDF her yerde aynı görünür. |
| Varsayılanlar | Şablonun kendi sabitleri — metinler, hukuki paragraflar, imza rolleri. Akışınızın verisi bunların üzerine birleştirilir. |
| Önizleme Verisi | Önizlemenin ve kaydederken çalışan kontrolün kullandığı örnek değerler. |
Kaydetmeden önce önizleyin. Editördeki Önizle düğmesi, sekmelerde o an ne varsa onu basar — kaydedilmiş olsun olmasın. Önizleme Verisi'niz Varsayılanlar'ınızın üzerine birleştirilir ve akışın kullandığı aynı oluşturucudan geçer. Şablona hiçbir şey yazılmaz; metni ve düzeni istediğiniz kadar deneyip yalnızca doğru göründüğünde kaydedersiniz.
Kaydetmek doğrular. Sunucu, şablonu saklamadan önce gerçekten render eder. PDF üretemiyorsa kayıt reddedilir ve nedeni tam olarak söylenir — ayrıştırma hatası ile satır numarası ya da HTML'inizin okuduğu ama Varsayılanlar'ın tanımlamadığı anahtar. Çalışmayan bir şablon canlı bir belgeye asla ulaşamaz. Karşılaşabileceğiniz iki reddetme daha var: çalışma alanında zaten kullanılan bir ad ve bir dakika içinde 30'dan fazla kayıt/önizleme yaparsanız "çok fazla şablon render'ı" uyarısı.
Her kayıt bir sürümdür. Editör önceki sürümleri listeler; birini seçmek onu geri yükler. Geri yükleme, eski içeriği yeni bir sürüm olarak ileri yazar; geçmişteki hiçbir şeyin üzerine yazılmaz.
Her belgede aynı olan her şeyi Varsayılanlar'a koyun — şirket metinleri, standart maddeler, derece
tanımları. Belgeden belgeye değişeni Data'ya koyun. Birleştirme derindir; akışınızdan
meta: { address } göndermeniz, şablonun sağladığı diğer meta değerlerini silmez.
Girdiler
| Parametre | Açıklama | Zorunlu |
|---|---|---|
| Document | Saved Template ya da Inline HTML. | Evet |
| Template | Render edilecek kayıtlı şablon. | Şablon kullanılıyorsa |
| HTML | Burada yazılan Handlebars HTML/CSS; {{değişkenler}} Data'dan doldurulur. | HTML kullanılıyorsa |
| Report Data | None, ya da Inspection (aşağıya bakın). | Hayır |
| Data | Değerleri nasıl verdiğiniz: Form (anahtar → değer satırları) veya JSON. | Evet |
| Fields | Veri nesnesini kuran anahtar → değer satırları (Form modu). | Data Form ise |
| JSON | Bir JSON nesnesi — iç içe veya listeli veri için en uygunu. | Data JSON ise |
| Show Page Numbers | Tek sayfalık belgelerde kapatın. | Hayır |
| Storage | Temporary (bir gün sonra silinir) veya Permanent. | Hayır |
| File Name | Saklanan belgenin adı. Değişken kabul eder. | Hayır |
| Session ID | Advanced. Boş bırakın — akışın kendi oturumu kullanılır. Sadece başka bir oturumu raporlamak için doldurun. | Hayır |
Kâğıt boyutu girdisi yok: boyutu şablonun kendisi belirler (aşağıya bakın). Render her zaman bağlantıyı bekler, böylece sonraki node'un gönderecek bir şeyi hep olur.
İmza sayfası
Doldurulabilir imza sayfası HTML'inizin bir parçası değildir — belgenin ardına eklenen gerçek bir PDF formudur, yani alıcı içine yazıp imzalayabilir. Sayfa altındaki not da CSS'iniz tarafından değil, sayfa yazıcısı tarafından çizilir.
İkisi de node girdisi değildir. İkisi de belgenin tasarımının parçasıdır; bu yüzden şablon editöründeki Varsayılanlar sekmesinde, şu anahtarlarla bir kez yazılır:
| Anahtar | Ne yapar |
|---|---|
signatureParties | Her imzalayan için bir satır: [{ "role": "Tenant", "name": "" }]. Yazmazsanız imza sayfası üretilmez. |
declarationText | İmza bloklarının üstüne basılan paragraf. |
signatureExtraRows | Ek doldurulabilir satırlar — sayaç okumaları, paraf satırı — isteğe bağlı tarih alanıyla, imzaların üstünde veya altında. |
footerNote | Her sayfanın sol altında, sayfa numaralarının yanındaki metin. |
pageSize | Belgenin basıldığı kâğıt: a4 (varsayılan), letter, legal, a5, a3… Bir Amerikan faturası her basımda Letter'dır; bu yüzden her render'da değil, burada bir kez ayarlanır. |
Akışınızın verisi şablonun Varsayılanlar'ının üzerine birleştiği için, gerçekten her render'da değişen bir belge bu anahtarları Data (JSON modu) içinde de verebilir. Bu istisnadır; normal yer şablondur.
Report Data
Neredeyse her belgede bunu None bırakın: veriyi aşağıdaki Data ile akışınız sağlar.
Rapor bir denetim sırasında toplanan kanıttan oluşuyorsa Inspection'ı seçin. Veri akışınızda değildir — onlarca fotoğraf, altyazı ve derece denetim kaydında durur — bu yüzden raporu sunucu kendisi derler, şablonunuz da onu dizer. Bir şablonun kullanabileceği alanlar için Inspection Reports sayfasına bakın.
Inspection seçmek Data'nın anlamını da değiştirir: o alanlar artık belgenin kendisi değil, raporun kapağı olur (adres, kiracı, denetçi, şirket, logo) — gövdeyi sunucu derler.
Report Data, Inspection iken PDF Önizle kapalıdır. Önizleme belgeyi yalnızca Data'dan kurabilir; bu moddaysa gövde gerçek çalışmada denetim oturumundan gelir — yani önizleme size boş bir belge gösterir ve bozuk bir şablon gibi görünür. Düzeni önizlemek için Report Data'yı None yapıp örnek değerlerle bakın, sonra geri alın.
Hangi denetim olduğunu söylemenize gerek yok: node zaten o oturumun içinde çalışıyor ve onu kullanıyor. Advanced altındaki Session ID, yalnızca başka bir oturumu raporlayan sıra dışı akışlar için var. İkisi de yoksa node boş bir rapor üretmek yerine anlaşılır bir mesajla durur.
Teslimat kendini kaydeder. Eklemeniz gereken ikinci bir node yok. Flowera, belgenin bağlantısı üzerinden gerçekten indirildiğini görüyor — WhatsApp belgeyi mesaja eklerken ya da Gmail aracı dosyayı eke koymak için indirirken tam olarak bu oluyor — ve teslimatı o anda kaydediyor. Aynı raporu tekrar istemek yine aynı belgeyi döndürür; ikinci bir PDF asla üretilmez.
Çıktılar
Belgeye giden imzalı bir URL. Sonraki node'un gönderebilmesi için akış durumuna kaydedin.
Render alışılmadık şekilde uzun sürerse node bir render kimliği ve pending döndürür; bu, belgenin
hâlâ üretilmekte olduğu anlamına gelir — başarısız olduğu değil. Render gerçekten başarısız olursa
failed ve bir neden döner, raporlanacak bir şey yoksa noop döner; yani akışınız "bekle" ile
"bu asla gelmeyecek" arasını ayırt edebilir.
Aynı denetim raporunu ikinci kez istemek aynı belgeyi döndürür ve alreadyDelivered der. Aynı
kanıttan asla ikinci bir PDF üretilmez.
Belgeyi gönderme
WhatsApp'ta — URL'i bir WhatsApp belge mesajına verin.
E-postayla — URL'i Gmail aracının Attachment URL alanına koyun. Dosyayı indirip düzgün şekilde ekler, böylece alıcı bir bağlantı değil gerçek bir PDF alır. Ekin alıcının tanıyacağı bir adı olması için Attachment File Name verin.
Ek URL'i, ya herkese açık ya da Flowera'nın kendi adresi olan bir http(s) adresi olmalıdır — PDF
Generator bağlantısı ikisini de karşılar. Başka her özel, loopback veya iç ağ adresi reddedilir; bu
kontrol izlenen her yönlendirmede (en fazla beş) yeniden yapılır ve dosya 18 MB ile sınırlıdır.
Dönen bağlantı kalıcı bir adres değil, geçici bir erişim anahtarıdır. Belgeyi aynı akış çalışmasında gönderin. Dosyanın uzun süre var olması gerekiyorsa Storage'ı Permanent yapın — bu, bağlantıyı değil saklanan belgeyi korur.
Örnek
Sipariş makbuzunu PDF olarak gönderme
- PDF Generator ile bir Tool node ekleyin.
- Document'ı Inline HTML yapın ve
{{customerName}},{{orderNumber}},{{total}}kullanan küçük bir makbuz yazın. - Data (Form modu) içinde bu anahtarları toplanan sipariş değerlerine eşleyin.
- PDF Önizle ile görün, sonra Şablon Olarak Kaydet ile kaydedin; sonraki akış yeniden kullansın.
- Dönen URL'i bir WhatsApp belge mesajına ya da Gmail'in Attachment URL alanına verin.
İpuçları
- Erken önizleyin. Önizleme, gerçek belgeyle aynı şekilde render eder — imza sayfası ve sayfa boyutu dahil.
- Listeler için JSON modunu kullanın. Şablonunuz kalemler üzerinde dönüyorsa veriyi JSON verin.
- Dönen URL'i akış durumunda saklayın, böylece gönderme adımı ona başvurabilir.
- Chatflow API kimlik bilgisini yalnızca kurulumunuz render çağrısının kimlik doğrulamasını gerektiriyorsa bağlayın.
İlgili
- Inspection Reports — bir denetim şablonunun kullanabileceği alanlar
- WhatsApp aracı — PDF'i belge mesajı olarak iletin
- Değişkenler — şablon verisini akış değerlerinden doldurun
- Tool node · Akış durumu