Ana içeriğe geç

Make programında şablon kullanarak belge oluştur

Şablon Kullanarak Belge Oluştur PDF4me'nin Make için geliştirdiği bir modüldür ve PDF4me deposundan kaydedilmiş bir şablonu birleştirir. JSONXML veya CSV Verilerinizi alır ve tamamlanmış bir belge döndürür. Şablonu adına göre seçin, verilerinizi satır içi veya dosya olarak eşleştirin ve her çalıştırmada şablon dosyası yüklemeden faturalar, sözleşmeler ve mektuplar oluşturun.

Bu modülün işlevi

PDF4me Şablon Kullanarak Belge Oluşturma PDF4me deponuzda saklanan bir şablonu, JSON, XML veya CSV olarak sağladığınız verilerle birleştirerek bir belge oluşturur. Dosya tabanlı oluşturma modüllerinin aksine, şablonu açılır menüden adıyla seçersiniz; şablon yükleme veya eşleme gerekmez. Verileri satır içi olarak şu şekilde sağlayabilirsiniz: Belge verileri metni veya eşlenmiş bir dosya olarak aracılığıyla Belge veri dosyasıİsteğe bağlı alan biçimlendirmesini ekleyin. Metadata JSONve oluşturulan belgeyi Dosya Yükle, E-posta Gönder veya herhangi bir alt Make modülüne aktarın.

İlgili Blog Yazıları
Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.
Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.
Blogu ziyaret edin →

API İsteğinizin Kimlik Doğrulaması​

Make'deki her PDF4me modülü geçerli bir kimlik gerektirir. BağlantıPDF4me API anahtarınızı içeren bir dosya oluşturun veya seçin, böylece senaryo belge oluşturma isteklerini güvenli bir şekilde doğrulayabilir.

Kaçırmamanız Gereken Önemli Bilgiler​

Şablon adı bir dosya değil, bir depo şablonudur.
O Şablon adı Açılır menü, PDF4me deponuzda kayıtlı şablonları listeler. Şablon dosyası yüklemek veya eşleştirmek yerine, kayıtlı bir şablonu adına göre seçersiniz. Kullanın buraya tıklayın Alanın yanındaki bağlantıya tıklayarak depoyu açabilir ve şablon oluşturabilir veya düzenleyebilirsiniz.
JSON, XML ve CSV veri formatlarını destekler.
Ayarlamak Belge veri türü Nesne veya dizi için JSON, XML belgeleri için XML veya virgülle ayrılmış satırlar için CSV. Seçilen format, kullandığınız kaynak ne olursa olsun (Belge veri metni veya Belge veri dosyası) geçerlidir.
Veri metni veya veri dosyası sağlayın.
Verilerinizi iki şekilde sağlayın: yapıştırın veya satır içi olarak eşleştirin. Belge verileri metni (CRM alanları ve küçük veri paketleri için uygundur) veya ikili veri dosyasını eşleyin Belge veri dosyası (Daha büyük veya harici olarak yönetilen veriler için uygundur). İkisini birden kullanmanıza gerek yok.
PDF4me'nin Şablon Kullanarak Belge Oluşturma modülü, Bağlantı ayarı "PDF4me bağlantım" olarak, Şablon adı ayarı PDF4me deposundan seçilen örnek şablon olarak, Belge veri türü ayarı JSON olarak, Belge veri metni dört alanlı bir JSON nesnesi içerecek şekilde ve Belge veri dosyası ve Meta veri JSON alanları boş olarak gösterilmiştir.

Kaydedilmiş bir şablon seçin. Şablon adı, ayarlamak Belge veri türüve verileri şu yollarla sağlayın: Belge verileri metni veya Belge veri dosyasıZorunlu alanlar kırmızı yıldız işaretiyle belirtilmiştir.

Şablonlar nereden geliyor?​

O Şablon adı açılır menü şuradan doldurulur: Belge Şablonu PDF4me kontrol panelinin bir alanı. Şablonlar, Oluşturma senaryosunda değil, hesabınızda bulunur; bu nedenle bir kez oluşturursunuz ve her senaryoda, akışta ve API çağrısında yeniden kullanırsınız.

PDF4me kontrol paneli Belge Şablonları sayfası, Şablon Adı, Şablon Türü, Çıktı Dosya Türü ve İşlemler sütunlarından oluşan bir tabloda kaydedilmiş üç şablonu listeler: PDF üreten Kullanıcı Formu (PDF Formu), HTML üreten Günlük Rapor (HTML) ve PDF üreten Fatura Word Şablonu (PDF4me Word). Tablonun üstünde bir Ekle düğmesi ve her satırda düzenleme ve silme simgeleri bulunur.

Burada kaydettiğiniz her şablon şurada görünür: Şablon adı Make uygulamasındaki açılır menüye tıklayın. Eklemek Yeni bir şablon oluşturmak için kalem simgesini, mevcut bir şablonu düzenlemek için ise kalem simgesini kullanabilirsiniz.

Bu tablodaki her satır, Marka açılır menüsündeki bir girişe karşılık gelir:

KolonMake'de bunun anlamı nedir?
Şablon AdıSeçtiğiniz metnin aynısı Şablon adıŞablonlara farklı adlar verin, böylece açılır menü her boyutta okunabilir kalsın.
Şablon TürüŞablonu oluşturduğunuz kaynak formatı, örneğin PDF Form, HTML, veya PDF4me WordBu, şablonda sabitlenmiştir, bu nedenle Make sizden bunu asla istemez.
Çıktı Dosya TürüOluşturulan belgenin geri dönüş formatı, örneğin PDF veya HTML.
EylemlerŞablonu düzenleyin veya silin. Şablonun adını değiştirmek, Oluştur açılır menüsünde gösterilen değeri değiştirir; bu nedenle eski adı referans alan tüm senaryoları güncelleyin.

:::ipucu Bu nedenle modülde Çıktı Türü alanı bulunmamaktadır. Hem şablon formatı hem de çıktı formatı burada, şablonun kendisinde belirlenir. Bu yüzden Şablon Kullanarak Belge Oluştur Yalnızca şablon adını ve verilerinizi ister. Aynı içeriğe farklı bir çıktı biçiminde ihtiyacınız varsa, farklı bir adla ikinci bir şablon kaydedin. Çıktı Dosya Türü. :::

:::Dikkat: Yeniden adlandırırken dikkatli olun. Modül şablonu saklar. isimBu bir kimlik numarası değil. Kontrol panelinde bir şablonun adını değiştirirseniz, eski adı işaret eden tüm Make senaryoları, siz yeniden seçene kadar başarısız olur. Kullanın Harita açma/kapama Şablon adıEğer ismi dinamik olarak iletmeniz gerekiyorsa. :::

Make'te Şablon Kullanarak Belge Oluştur seçeneği hangi parametreleri kullanır?​

Gerekli: Bağlantı, Şablon adı ve Belge veri türü. Şartlı: Belge veri metni VEYA Belge veri dosyası (veri yükünün taşınması zorunludur). İsteğe bağlı: Meta veri JSON. Veri formatı standartları için bkz. CSV için RFC 4180 ve resmi JSON spesifikasyonu.

ParametreGerekliNe işe yarar?Örnek
ConnectionRequiredPDF4me connection for the scenario. Click Add to create one with your API key, or select an existing connection.My PDF4me connection
Template nameRequiredDocument template chosen from your PDF4me repository. Pick a saved template from the dropdown. Use the click here link to open the repository and create a new template. Has a Map toggle for dynamic selection.sample template
Document data typeRequiredFormat of the data payload. JSON for object/array, XML for XML documents, CSV for comma-separated rows. Has a Map toggle.JSON
Document data textConditionalMap the fields from a CRM or prior steps as JSON, XML, or CSV text. Use this field when you are not uploading a data file.{ "name": "John" }
Document data fileConditionalMap a file containing the document data in JSON, XML, or CSV format. Use this instead of Document data text when the data comes from a download or upload module.2. Data
Metadata JSONNoOptional JSON that controls field formatting during the merge, for example date formats or checkbox and HTML field types. Leave empty for plain text substitution.{"FieldsMetaData":[...]}

Çıktı​

Bu modül, oluşturulan belgeyi içeren ve sonraki Make modülleri için hazır olan, her çalıştırmada bir paket döndürür.

AlanTipİçeriğinde neler var?
DocumentFile (binary data)Content (binary data) of the resulting generated document, returned on docData. Map it together with File Name into the next module, for example Upload a File or Send Email Attachment.
File NameFile nameFile name of the resulting generated document, returned on name. Map it together with Document into the next module, for example to upload or email the file.

Make programında Şablon Kullanarak Belge Oluşturma özelliğini nasıl kurarım?​

  1. Eklemek PDF4me ve seçin Şablon Kullanarak Belge Oluştur.
  2. Seçme Bağlantı (veya tıklayın) Eklemek (API anahtarınızla bir tane oluşturmak için).
  3. Açın Şablon adı Açılır menüden PDF4me deponuzdan kaydedilmiş bir şablon seçin. Liste boşsa, önce bir tane oluşturun. Belge Şablonu kontrol panelinde veya şunu kullanın: buraya tıklayın Alanın yanındaki bağlantı.
  4. Ayarlamak Belge veri türü ile Json, XML, veya CSV Verilerinize uyacak şekilde.
  5. Verileri girin: yapıştırın veya eşleştirin. Belge verileri metniveya bir veri dosyasını eşle Belge veri dosyası.
  6. İsteğe bağlı olarak ekleyin Metadata JSON Tarih, onay kutusu veya HTML alanı biçimlendirmesi için.
  7. Tıklamak Kaydetmek ve çalıştırın. Oluşturulanı eşleştirin. Belge Verileri Çıktıyı Dosya Yükleme, E-posta Gönderme veya Arşivleme modülüne aktarın.

İş Akışı Örnekleri​

İş Akışı ÖrnekleriCommon Make scenario patterns using Generate Document Using Template.
CRM'de kaydedilmiş şablondan fatura oluşturma işlemi
  1. Bir anlaşma kazanıldığında CRM webhook'u tetiklenir.
  2. Şablon Kullanarak Belge Oluştur seçeneği, kaydedilmiş fatura şablonunu seçer ve işlem alanlarını Belge veri metninde JSON olarak okur.
  3. Oluşturulan fatura müşteriye e-posta ile gönderilir ve işlem kaydına kaydedilir.
CSV dosyasını toplu mektuplara dışa aktar
  1. Planlanmış bir tetikleyici, bulut depolama alanından bir CSV dışa aktarımını indirir.
  2. Belge veri türü CSV olarak ayarlanmış ve dosya Belge veri dosyasına eşlenmiştir.
  3. Kaydedilen mektup şablonları birleştirilir ve oluşturulan her belge tarihli bir klasöre arşivlenir.
Meta verileri içeren JSON formatında sözleşme
  1. Form gönderimi, sözleşme verilerini JSON formatında sağlar.
  2. Metadata JSON, birleştirme işlemi sırasında geçerlilik tarihi alanını yyyyMMdd formatına ayarlar.
  3. Kaydedilen sözleşme şablonu oluşturulur ve elektronik imza için yönlendirilir.

Sıkça Sorulan Sorular​

How is Template name different from the file-based generate modules?+
In Generate Document Using Template, Template name is a dropdown that lists the templates saved in your PDF4me repository. You select a stored template by name instead of uploading or mapping a template file, so no File Type or Output Type fields are needed. Create or edit templates from the PDF4me dashboard.
What data formats can I supply?+
Document data type accepts Json for an object or array, Xml for XML documents, or Csv for comma-separated rows. Choose the format that matches your source data, then supply it via Document data text or Document data file.
Should I use Document data text or Document data file?+
Provide one of the two. Use Document data text to paste or map data inline from a CRM or a prior module. Use Document data file to map a binary data file. The file option is best for larger or externally maintained payloads.
What is Metadata JSON used for?+
Metadata JSON is optional and controls how specific template fields are formatted during the merge, for example date formats or checkbox and HTML field types. Leave it empty for plain text substitution.
How do I create a template for this module?+
Create it in the Document Template area of the PDF4me dashboard at https://dev.pdf4me.com/dashboard/#/document-template/ . Click Add, choose the Template Type (PDF Form, HTML, or PDF4me Word) and the Output File Type, then save. The template then appears in the Template name dropdown in Make. The click here link next to the field opens the same page.

İlgili işlemler​

Yardım Alın​