Membuat Dokumen dengan Merge-Field

Selain laporan berbentuk tabel, Report Builder juga bisa membuat dokumen per-subjek — misalnya surat keterangan kerja — dengan data karyawan otomatis terisi lewat merge-field.

Buka Laporan → Buat laporan kustom, lalu pilih mode Dokumen / surat.

Anatomi editor dokumen

• Konteks subjek — menentukan jenis subjek dokumen ini: Karyawan (data profil individu) atau Slip gaji (payslip yang sudah finalized). Konteks menentukan merge-field apa saja yang tersedia.
• Logo / Kop Surat — unggah logo perusahaan (PNG/JPG/GIF/WebP, maks 2MB) yang muncul di atas dokumen.
• Mulai dari contoh — dua starter siap pakai (Surat Keterangan Kerja, Surat Keterangan Aktif Bekerja) untuk mempercepat penyusunan.
• Sisipkan field — tombol-tombol merge-field (contoh: +Nama karyawan, +No. karyawan, +Tanggal hari ini) yang menyisipkan token seperti {{employee.full_name}} ke posisi kursor pada editor.
• Editor visual / Markdown (lanjutan) — tulis surat dengan editor WYSIWYG (bold, heading, list, dll) atau langsung dalam Markdown untuk kontrol lebih detail.
• Kop surat & footer — teks tambahan opsional yang tampil di bagian atas/bawah dokumen tercetak.

Format dibersihkan demi keamanan. Bila Anda menulis lewat mode Markdown, HTML/script mentah otomatis di-strip sebelum dirender — mencegah kode berbahaya tersisip ke dokumen yang dicetak.

Isi nama laporan, pilih konteks, susun isi surat, lalu tekan Simpan laporan.

Menerbitkan dokumen untuk subjek tertentu

Dari halaman Laporan, tekan Buat dokumen pada template dokumen yang sudah tersimpan. Pilih subjek (karyawan atau slip gaji, tergantung konteks template) dari dropdown, lalu tekan Buka & cetak.

Sistem merender dokumen dengan seluruh merge-field terisi data subjek yang dipilih, siap dicetak atau disimpan sebagai PDF.

Tekan Cetak / PDF untuk mencetak lewat dialog print browser (pilih "Save as PDF" untuk menyimpan file).

Data sensitif pada dokumen slip gaji

Untuk konteks Slip gaji, merge-field nominal (payslip.*) tetap mengikuti aturan masking payroll — tersamar •••• kecuali akun Anda punya izin payroll.payslip.read_sensitive. Subjek yang bisa dipilih juga dibatasi hanya payslip dari periode finalized, konsisten dengan aturan di Slip Gaji dan Pencairan.

Dokumen per-subjek tidak bisa dijadwalkan otomatis — berbeda dari laporan tabel, karena tiap dokumen menyasar satu individu spesifik. Untuk laporan yang berjalan otomatis, lihat Menjadwalkan Laporan Otomatis.