Lewati ke konten utama

Buat Dokumen Menggunakan Templat di Make

Buat Dokumen Menggunakan Templat adalah modul PDF4me untuk Make yang menggabungkan templat tersimpan dari repositori PDF4me Anda dengan JSON, XML, atau CSV Data dimasukkan dan dokumen akan dikembalikan dalam bentuk jadi. Pilih templat berdasarkan nama, petakan data Anda secara langsung atau sebagai file, dan hasilkan faktur, kontrak, dan surat tanpa perlu mengunggah file templat setiap kali dijalankan.

Fungsi modul ini

PDF4me Menghasilkan Dokumen Menggunakan Templat Menghasilkan dokumen dengan menggabungkan templat yang tersimpan di repositori PDF4me Anda dengan data yang Anda berikan sebagai JSON, XML, atau CSV. Tidak seperti modul pembuatan berbasis file, Anda memilih templat berdasarkan nama dari menu tarik-turun, tanpa perlu mengunggah atau memetakan templat. Berikan data secara langsung melalui Teks data dokumen atau sebagai file yang dipetakan melalui Berkas data dokumen, tambahkan pemformatan bidang opsional dengan JSON Metadata, dan salurkan dokumen yang dihasilkan ke dalam Upload File, Send Email, atau modul Make hilir lainnya.

Postingan Blog Terkait
Belum ada postingan blog untuk fitur ini — akan segera hadir.
Sementara itu, jelajahi blog PDF4me untuk menemukan tutorial dan alur kerja di berbagai platform.
Kunjungi blog ini →

Mengautentikasi Permintaan API Anda​

Setiap modul PDF4me di Make memerlukan validasi yang berlaku. KoneksiBuat atau pilih salah satu yang menyimpan kunci API PDF4me Anda agar skenario tersebut dapat mengautentikasi permintaan pembuatan dokumen dengan aman.

Fakta Penting yang Tidak Boleh Anda Lewatkan​

Nama template adalah template repositori, bukan file.
Yang Nama templat Daftar pilihan templat tersimpan di repositori PDF4me Anda. Anda memilih templat yang tersimpan berdasarkan nama, bukan dengan mengunggah atau memetakan file templat. Gunakan klik disini Klik tautan di samping kolom untuk membuka repositori dan membuat atau mengedit templat.
Mendukung data JSON, XML, dan CSV.
Mengatur Tipe data dokumen Format yang dipilih adalah JSON untuk objek atau array, XML untuk dokumen XML, atau CSV untuk baris yang dipisahkan koma. Format yang dipilih berlaku untuk sumber mana pun yang Anda gunakan, baik data dokumen teks maupun file data dokumen.
Berikan Data Teks atau File Data.
Masukkan data Anda dengan salah satu dari dua cara: tempel atau petakan langsung ke dalam Teks data dokumen (cocok untuk kolom CRM dan muatan data kecil), atau memetakan file data biner ke Berkas data dokumen (cocok untuk data yang lebih besar atau yang dikelola secara eksternal). Anda tidak memerlukan keduanya.
Buat modul PDF4me Generate Document Using Template yang menunjukkan Koneksi diatur ke Koneksi PDF4me saya, Nama template diatur ke template sampel yang dipilih dari repositori PDF4me, Tipe data dokumen diatur ke JSON, Teks data dokumen berisi objek JSON empat bidang, dan bidang File data dokumen dan JSON metadata kosong.

Pilih templat yang tersimpan di Nama templat, mengatur Tipe data dokumen, dan menyediakan data melalui Teks data dokumen atau Berkas data dokumenKolom yang wajib diisi ditandai dengan tanda bintang merah.

Dari mana asal templat-templat ini?​

Yang Nama templat Dropdown diisi dari Templat Dokumen Area dasbor PDF4me. Templat tersimpan di akun Anda, bukan di skenario Buat, jadi Anda membuatnya sekali dan menggunakannya kembali di setiap skenario, alur, dan panggilan API.

Halaman Templat Dokumen dasbor PDF4me menampilkan tiga templat tersimpan dalam tabel dengan kolom Nama Templat, Jenis Templat, Jenis File Keluaran, dan Tindakan: Formulir Pengguna sebagai Formulir PDF yang menghasilkan PDF, Laporan Harian sebagai HTML yang menghasilkan HTML, dan Templat Word Faktur sebagai Word PDF4me yang menghasilkan PDF, dengan tombol Tambah di atas tabel dan ikon edit dan hapus di setiap baris.

Setiap templat yang Anda simpan di sini akan muncul di Nama templat menu tarik-turun di Buat. Klik Menambahkan untuk membuat yang baru, atau ikon pensil untuk mengedit templat yang sudah ada.

Setiap baris dalam tabel ini sesuai dengan satu entri dalam menu tarik-turun Merek:

KolomApa artinya dalam pembuatan
Nama TemplatTeks persis yang Anda pilih di bawah ini Nama templatBerikan nama yang berbeda pada template agar menu dropdown tetap mudah dibaca dalam skala besar.
Jenis TemplatFormat sumber yang Anda gunakan saat membuat templat tersebut, misalnya. PDF Form, HTML, atau PDF4me WordIni sudah ditetapkan pada templat, jadi Make tidak akan pernah menanyakannya kepada Anda.
Jenis File KeluaranFormat dokumen yang dihasilkan, misalnya, adalah format yang akan diterima oleh dokumen tersebut. PDF atau HTML.
TindakanEdit atau hapus templat. Mengganti nama templat akan mengubah nilai yang ditampilkan di menu tarik-turun Buat, jadi perbarui skenario apa pun yang merujuk pada nama lama.
Inilah mengapa modul ini tidak memiliki kolom Tipe Output

Baik format templat maupun format output ditentukan di sini, pada templat itu sendiri. Itulah sebabnya Buat Dokumen Menggunakan Templat Hanya meminta nama templat dan data Anda. Jika Anda memerlukan konten yang sama dalam format keluaran yang berbeda, simpan templat kedua dengan nama yang berbeda. Jenis File Keluaran.

:::peringatan Ganti nama dengan hati-hati Modul ini menyimpan templat nama, bukan ID. Jika Anda mengganti nama templat di dasbor, skenario Make apa pun yang masih mengarah ke nama lama akan gagal sampai Anda memilihnya kembali. Gunakan Peta aktifkan Nama templatjika Anda perlu mengirimkan nama secara dinamis. :::

Parameter apa saja yang digunakan oleh Generate Document Using Template di Make?​

Diperlukan: Koneksi, nama templat, dan tipe data dokumen. Bersyarat: Teks data dokumen ATAU berkas data dokumen (salah satunya harus membawa muatan data). Opsional: JSON metadata. Untuk standar format data, lihat RFC 4180 untuk CSV dan Spesifikasi JSON resmi.

ParameterDiperlukanApa fungsinya?Contoh
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":[...]}

Keluaran​

Modul ini mengembalikan satu bundel per eksekusi yang berisi dokumen yang dihasilkan, siap untuk digunakan oleh modul Make selanjutnya.

BidangJenisIsi di dalamnya
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.

Bagaimana cara mengatur opsi "Buat Dokumen Menggunakan Templat" di Make?​

  1. Menambahkan PDF4me dan pilih Buat Dokumen Menggunakan Templat.
  2. Pilih Koneksi (atau klik) Menambahkan (untuk membuatnya dengan kunci API Anda).
  3. Buka Nama templat Dari menu tarik-turun, pilih templat yang sudah tersimpan dari repositori PDF4me Anda. Jika daftarnya kosong, buat terlebih dahulu di [tautan]. Templat Dokumen di dasbor, atau gunakan klik disini tautan di samping kolom.
  4. Mengatur Tipe data dokumen ke Json, XML, atau CSV untuk mencocokkan data Anda.
  5. Masukkan data: tempel atau petakan ke dalam Teks data dokumenatau memetakan berkas data ke Berkas data dokumen.
  6. Tambahkan secara opsional JSON Metadata untuk pemformatan tanggal, kotak centang, atau bidang HTML.
  7. Klik Menyimpan lalu jalankan. Petakan yang dihasilkan Data Dokumen output ke modul Unggah File, Kirim Email, atau pengarsipan.

Contoh Alur Kerja​

Contoh Alur KerjaCommon Make scenario patterns using Generate Document Using Template.
Konversi transaksi CRM ke faktur dari templat yang tersimpan.
  1. Webhook CRM akan aktif ketika sebuah kesepakatan dimenangkan.
  2. Fungsi "Buat Dokumen Menggunakan Templat" memilih templat faktur yang tersimpan dan membaca kolom transaksi sebagai JSON dalam teks data Dokumen.
  3. Faktur yang dihasilkan dikirim melalui email kepada pelanggan dan disimpan dalam catatan transaksi.
Ekspor CSV ke surat batch
  1. Pemicu terjadwal mengunduh ekspor CSV dari penyimpanan cloud.
  2. Tipe data dokumen diatur ke CSV dan file dipetakan ke dalam file data dokumen.
  3. Templat surat yang tersimpan digabungkan dan setiap dokumen yang dihasilkan diarsipkan ke dalam folder berdasarkan tanggal.
Kontrak yang diformat dengan Metadata JSON
  1. Pengisian formulir memberikan data kontrak dalam format JSON.
  2. JSON metadata mengatur kolom tanggal efektif ke format yyyyMMdd selama proses penggabungan.
  3. Templat kontrak yang tersimpan akan dibuat dan dikirim untuk tanda tangan elektronik.

Pertanyaan yang Sering Diajukan​

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.

Tindakan terkait​

Dapatkan Bantuan​