Posta Birleştirme
Bu kılavuz neleri kapsıyor?
Bu kılavuz, birleştirme işlemini adım adım açıklıyor. klasik Word posta birleştirme şablonu içinde n8n kullanarak simple_mail_merge_template.docx Ve örnek_posta_birleştirme_verileri.jsonŞablon Word kullanılarak hazırlanmıştır. BİRLEŞTİRME ALANI yer tutucular (değil) <<[alan]>> veya bıyık {{alan}}Veri bir JSON sıralamak Alıcı başına bir nesne ile. Belge Oluştur (Tekli) için şunu kullanın: bir sıra Dizide. Çıktı şu olabilir: PDF veya Word.
Başlamadan Önce
simple_mail_merge_template.docx Word'ün posta birleştirme özelliği (Birleştirme Alanı Ekle) kullanılarak oluşturulmuştur. Alan adları şunlardır: ilk adı, soy isim, cinsiyet, Ve üyeBirbirleriyle eşleşmeleri gerekiyor. JSON Anahtarlar tam olarak.örnek_posta_birleştirme_verileri.json (tavsiye edilen), test.xml, veya test.csvPosta birleştirme verileri bir nesne dizisiTek bir belge için, tek bir nesne içeren bir diziyi yapıştırın.:::not: Posta Birleştirme ve PDF4me Word Şablonu Karşılaştırması
Posta Birleştirme Bu, klasik posta birleştirme alanları (MERGEFIELD) ile oluşturulmuş Word belgeleri içindir. PDF4me Word Şablonu kullanımlar <<[alanAdı]>> LINQ sözdizimi normal bir şekilde .docxŞablonunuzun oluşturulma şekline uygun türü seçin. Tek bir şablonda birçok alıcı için. API arama, kullanma Belge Oluştur (Birden Fazla) yerine.
:::
Örnek Dosya Paketi
Aşağıdaki dört dosyayı da indirin. Bir Word posta birleştirme şablonu ve üç eşdeğer veri formatı.
Örnek Dosyaların İçeriği
Alanları birleştir simple_mail_merge_template.docx
Örnek basit bir örnektir. üyelik mektubu Dört adet klasik Word birleştirme alanı ile:
| Merge field name | Typical label in template | Sample value (sample_mail_merge_data.json) |
|---|---|---|
firstname | Given name | John |
lastname | Family name | Adams |
gender | Gender | Female |
member | Membership tier | Basic |
:::ipucu Birleştirme alanı adlarını nasıl inceleyebilirsiniz?
Microsoft Word'de, tuşuna basın. Alt+F9 Alan kodlarını açıp kapatmak için. Posta birleştirme alanları şu şekilde görünür: { BİRLEŞTİRME ALANI ad } Stil kodları. Adından sonra BİRLEŞTİRME ALANI sizinle eşleşmeli JSON anahtar.
:::
Tüm veri dosyalarında alan eşlemesi
| Merge field | JSON key (sample_mail_merge_data.json) | XML element (test.xml) | CSV column (test.csv) | Sample value |
|---|---|---|---|---|
firstname | firstname | firstname | firstname | John |
lastname | lastname | lastname | lastname | Adams |
gender | gender | gender | gender | Female |
member | member | member | member | Basic |
PDF4me Word Şablonunun aksine, burada yok. <<[alan]>> Etiketlerin aksine. HTMLBurada bıyık sözdizimi yok. Motor bağlama işlemini gerçekleştiriyor. JSON Word MERGEFIELD adlarının anahtarları Bire bir.
İş Akışına Genel Bakış
Manual Trigger → Read Binary File (simple_mail_merge_template.docx) → PDF4me Generate Document (Single) → (optional) Write Binary File
| Adım | n8n düğüm | Amaç |
|---|---|---|
| 1 | Manuel Tetikleyici | İş akışını isteğe bağlı olarak başlatın |
| 2 | İkili Dosyayı Oku | Yükler simple_mail_merge_template.docx ikili özelliğe data |
| 3 | PDF4me → Belge Oluştur (Tekli) | Şablonu birleştirir + JSON dizi, çıktılar PDF veya Word |
| 4 | İkili Dosya Yaz veya E-posta gönder (isteğe bağlı) | Kaydeder veya gönderir generated_document_output.pdf |
/generate-document-single-template-file-type.png "Büyütmek için tıklayın")
Ayarlamak Şablon Dosya Türü ile Posta Birleştirme. Seçmek PDF veya Word için Çıktı Türü.
Adım 1: Örnek Dosyaları İndirin ve Yerleştirin
- İndirmek
simple_mail_merge_template.docxVesample_mail_merge_data.json-den Örnek Dosya Paketi üstünde. - Şablonu bir yere kaydedin. n8n (Kendi sunucunuzda barındırdığınız yerel yol veya üretim tetikleyicileri için bulut depolama alanı) okunabilir.
- İsteğe bağlı olarak indirin
test.xmlveyatest.csvDiğer veri türlerini test etmek için.
Adım 2: Oluşturun n8n İş Akışı
- İçinde n8nYeni bir iş akışı oluşturun.
- Ekle Manuel Tetikleyici düğüm.
- Ekle İkili Dosyayı Oku Tetikleyiciden sonraki düğüm.
- Eklemek PDF4me → Belge Oluştur (Tekli) İkili dosyayı okuduktan sonra.
- Bağlantınızı kurun. PDF4me kimlik belgesi.
:::Dikkat: HTML kodu burada geçerli değil Şablon Dosyası Giriş Türü: HTML Kod yalnızca şu durumlarda işe yarar Şablon Dosya Türü dır HTMLPosta birleştirme için şunu kullanın: İkili Veri, Base64 Sicim, veya URL.
:::
Adım 3: Word Şablonunu Yükleyin (Read Binary File)
Yapılandırın İkili Dosyayı Oku düğüm:
| Alan | Değer |
|---|---|
| Dosya Yolu | İndirdiğiniz dosyanın tam yolu simple_mail_merge_template.docx |
| Mülk Adı | data (varsayılan; şu amaçla kullanılır: Şablon İkili Özelliği içinde PDF4me) |
Bu düğümü bir kez çalıştırın ve çıktı öğesinin ikili veri gösterdiğini doğrulayın. data dosya adı ile simple_mail_merge_template.docx.
Adım 4: Yapılandırma PDF4me Belge Oluştur (Tekli)
Temel ayarlar
| Alan | Değer | Notlar |
|---|---|---|
| Bağlantı kurmak için kimlik bilgisi | Senin PDF4me kimlik belgesi | Elde etmek API anahtar |
| Kaynak | Generate | |
| Operasyonları Oluştur | Belge Oluştur (Tekli) | |
| Şablon Dosya Türü | Posta Birleştirme | Klasik Word MERGEFIELD şablonu |
| Çıktı Türü | PDF veya Word | PDF paylaşmak için; Word Alıcının birleştirilmiş belgeyi düzenlemesi gerekip gerekmediği |
Şablon girişi (İkili Dosyayı Oku bölümünden)
| Alan | Değer |
|---|---|
| Şablon Dosyası Giriş Türü | İkili Veri |
| Şablon İkili Özelliği | data |
| Şablon Dosya Adı | simple_mail_merge_template.docx |
Belge verileri (JSON dizisini yapıştırın) sample_mail_merge_data.json)
| Alan | Değer |
|---|---|
| Belge Veri Giriş Türü | Metin |
| Belge Veri Türü | JSON |
| Belge Verileri Metni | Lütfen aşağıdaki metnin tamamını yapıştırın. sample_mail_merge_data.json (aşağıdaki bloğa bakınız) |
[
{
"firstname": "John",
"lastname": "Adams",
"gender": "Female",
"member": "Basic"
}
]
:::Önemli: JSON bir dizi olmalıdır Posta birleştirme verileri bir JSON sıralamakTek bir alıcı için bile olsa. Dizideki her bir nesne, Belge Oluştur (Tekli) seçeneğiyle birleştirilmiş tek bir belge oluşturur.
:::
Çıkış seçenekleri
| Alan | Değer |
|---|---|
| Kale PDF Düzenlenebilir | Çıkış Türü kapalı olduğunda (varsayılan) PDF |
| İkili Veri Çıkış Adı | data (varsayılan) |
Adım 5: Çalıştırın ve Çıktıyı Doğrulayın
- Tıklamak İş akışını yürüt.
- Açın PDF4me Düğüm çıktısı altında. İkiliaçık mülk
data(generated_document_output.pdfveya.docx). - Dört birleştirme alanının da doldurulmuş olduğundan emin olun:
- ilk adı → John
- soy isim → Adams
- cinsiyet → Kadın
- üye → Temel
Bir alan boşsa, kendi bilgilerinizle karşılaştırın. JSON Word şablonunda MERGEFIELD adlarını içeren anahtarlar (Word'de Alt+F9).
Adım 6: Çıktıyı Kaydedin veya Gönderin (İsteğe bağlı)
İkili Dosyayı Yaz:
| Alan | Değer |
|---|---|
| Dosya adı | mail-merge-output.pdf |
| Veri Özelliği Adı | data |
| Çıkış Yolu | Hedef klasörünüzde n8n ev sahibi |
E-posta gönder: ikili dosyayı ekle data itibaren PDF4me olarak PDF veya Word EK.
Alternatif Veri Biçimleri
Seçenek A: JSON Dosya ikili formatta (sample_mail_merge_data.json)
- Eklemek İkili Dosyayı Oku için
sample_mail_merge_data.json(kullanın Birleştir Şablon ve verilerin iş akışı öğesini paylaştığı düğüm). - Ayarlamak Belge Veri Giriş Türü ile İkili Veri, Belge Veri Türü ile JSON, Belge İkili Özelliği Veri alanınıza, Belge Veri Dosyası Adı ile
sample_mail_merge_data.json.
:::Dikkat İkili özellik adı çakışması
Hem şablon hem de veri aynı özelliği kullanıyorsa dataBiri diğerinin üzerine yazılır. Ayrı isimler kullanın (örneğin, template Ve mergeData) veya iki İkili Dosya Oku düğümünden öğeleri birleştirin.
:::
B Seçeneği: XML (test.xml)
Ayarlamak Belge Veri Türü ile XML ve yapıştırın:
<?xml version="1.0" encoding="UTF-8"?>
<Person>
<firstname>John</firstname>
<lastname>Adams</lastname>
<gender>Female</gender>
<member>Basic</member>
</Person>
Öğe adları, birleştirme alanı adlarıyla ve JSON anahtarlarıyla eşleşir.
C Seçeneği: CSV (test.csv)
Ayarlamak Belge Veri Türü ile CSV ve yapıştırın (başlık satırı + bir veri satırı):
firstname,lastname,gender,member
"John","Adams","Female","Basic"
Sütun başlıkları, birleştirme alanı adlarıyla doğrudan eşleşir.
Alternatif Şablon Girişi: URL
Ev sahibi simple_mail_merge_template.docx halka açık bir yerde HTTPS URLArdından şunu ayarlayın:
| Alan | Değer |
|---|---|
| Şablon Dosyası Giriş Türü | URL |
| Şablon Dosyası URL'si | Herkese açık bağlantı simple_mail_merge_template.docx |
| Şablon Dosya Adı | simple_mail_merge_template.docx |
"İkili Dosya Oku" düğümüne gerek yoktur. Veriler yine de yapıştırılabilir. Belge Verileri Metni veya bir yerden yüklendi URL.
Üretim İş Akışı Kalıpları
Üretim ortamında posta birleştirme işlemini çalıştırmanın yaygın yollarıOnce the sample test works, replace the Manual Trigger with these patterns.
- Yeni satır eklendiğinde sayfalar tetiklenir.
- Kod veya Ayarlamak Düğüm, satırı bir sarmal içine alır. JSON sıralamak:
[{"ilk adı": "...", ...}]. - PDF4me Sabit değerlerle posta birleştirme
simple_mail_merge_template.docx. - Birleştirilmiş e-postayı gönderin PDF alıcıya.
- Webhook formdan gelen veriyi alır.
- Gövde alanlarını birleştirme anahtarlarına eşleyin (
ilk adı,soy isim, vesaire.). - Tek bir öğe oluşturun JSON Belge Veri Metni için dizi.
- Çıktıyı kaydedin veya e-posta ile gönderin. PDF.
- Kişileri şu şekilde dışa aktarın: JSON Dizi (kişi başına bir nesne).
- Şuna geçin Belge Oluştur (Birden Fazla) örneğin PDF satır başına.
- Her çalıştırmada yalnızca bir birleştirilmiş dosyaya ihtiyacınız olduğunda "Belge Oluştur (Tek)" seçeneğini koruyun.
Sıkça Sorulan Sorular
İlgili Kılavuzlar
- Belge Oluştur (Tekli) genel bakış: tüm parametreler, çıktı alanları ve şablon türleri
- PDF4me Word Şablonu:
<<[fieldName]>>MERGEFIELD yerine sözdizimi - Belge Oluştur (Birden Fazla): Her satır için bir çıktı dosyası JSON sıralamak
- Posta birleştirme iş akışı bloguuçtan uca desen Make