Document / PDF preview

Document / PDF preview digunakan untuk menampilkan dokumen di dalam form, misalnya kontrak yang harus dibaca sebelum disetujui. PDF tampil per halaman. Gambar PNG, JPG, dan WebP juga bisa dipratinjau. Tipe berkas lain hanya bisa diunduh.

Mapping ke Engine

Komponen ini tidak menyimpan process variable. Saat form disubmit, payload tidak berisi key pratinjau.

Properties

• Name: Nama dokumen dalam dua bahasa (EN dan ID). Tampil di bilah alat dan dipakai di pesan wajib baca.
• Key: Identitas komponen di dalam form. Terisi otomatis saat komponen diletakkan di kanvas. Key ini bukan process variable.
• Show the file from: Asal dokumen, pilih salah satu.
  • Variable: Berkas dari process variable yang diunggah di langkah sebelumnya. Isi File variable dengan nama variabelnya, misalnya contract_file.
  • Fixed file: Berkas tetap yang diunggah di Studio. Seret-lepas berkas PDF, PNG, atau JPG, atau pilih lewat "Browse file". Tipe lain ditolak dengan pesan "Choose a PDF, PNG, or JPG file." Setelah terunggah tampil nama, tipe, dan ukuran berkas, misalnya "PDF · 2.0 KB". Ikon hapus melepas berkas dari form.
    • Berkas disimpan sebagai aset form, sama seperti sumber Upload pada Image: tidak ikut terhapus saat lampiran draft dibersihkan, dan bisa dilihat semua user di workspace.
    • Bila unggah gagal, pesan dari server tampil di bawah kotak upload, misalnya "File is too large. Maximum size is 10 MB".
    • Fixed file lama yang masih berupa alamat tetap terbaca, dengan catatan "Linked by address. Upload the file so every user can open it." Path attachment AlurKerja, misalnya /api/v1/probis/form-attachments/<id>/download, hanya bisa dibuka pengunggah, admin, atau peserta proses. Unggah ulang berkasnya agar semua user bisa membukanya. URL https lengkap dimuat tanpa kredensial pengguna, sama seperti sumber Link.
  • Link: Isi HTTPS link dengan alamat lengkap yang diawali https://. Alamat http:// ditolak dengan pesan "Use an https:// link". Alamat tidak lengkap ditolak dengan pesan "Enter a full link, e.g. https://files.example.com/contract.pdf".
• Height (px): Tinggi area pratinjau, 320 sampai 1000 px dengan kelipatan 20. Nilai lain ditolak dengan pesan "Use 320–1000 px."
• Initial zoom: Zoom awal, 50% sampai 200%.
• Allow download: Menampilkan tombol "Download".
• Allow opening in a new tab: Menampilkan tombol "Open in a new tab". Tombol membuka salinan dokumen yang sudah dimuat. Bila dokumen gagal dimuat, tombol hanya tampil untuk URL https lengkap, tidak untuk path attachment.
• Hide If (tab Logic): Ekspresi FEEL untuk menyembunyikan pratinjau. Pratinjau disembunyikan ketika ekspresi bernilai true.
• Validation: Tidak ada Required. Tab Validation berisi satu pilihan:
  • Must reach the last page: Complete Task tertahan sampai pengguna melihat halaman terakhir PDF atau gambar.

Save Changes nonaktif selama sumber atau Height tidak valid, Fixed file belum berisi berkas, atau berkas masih diunggah.

Perilaku saat diisi

• Bilah alat menampilkan nama dan ukuran berkas. Untuk PDF ada nomor halaman (misalnya "1 / 6"), tombol halaman, pilihan zoom, dan "Fit width". Tombol PageUp/PageDown dan panah kiri/kanan juga memindah halaman.
• Halaman dokumen tetap putih di tema gelap.
• Selama dokumen dimuat, tampil "Loading document…". Bila gagal, tampil "Couldn't load the document" dengan tombol "Retry".
• Bila sumbernya Variable dan variabel masih kosong, tampil "No document yet — it is uploaded in an earlier step." Bila sumber lain belum diisi, tampil "The form owner hasn't set the document yet."
• Untuk berkas selain PDF dan gambar, tampil kartu berkas dengan "Preview works for PDF and images." dan tombol "Download".
• Dengan Must reach the last page aktif, Complete Task sebelum halaman terakhir ditolak dengan pesan dari Name, misalnya "Read the contract to the last page before completing". Berkas yang tidak bisa dipratinjau tidak menahan Complete Task. Dokumen yang gagal dimuat tetap menahan.
• Sumber Link dimuat tanpa kredensial pengguna. Server yang tidak mengizinkan akses lintas domain (CORS) gagal ditampilkan, tetapi "Open in a new tab" tetap bisa dipakai.
• Di form start publik, Fixed file yang diunggah di Studio tampil tanpa login bila proses mengaktifkan Allow Public Start (lihat BPMN Settings). Jalur publik hanya memberikan berkas yang ada di form start proses itu.
• Fixed file lama berupa path attachment tidak tampil di form publik. Unggah ulang berkasnya di Studio, simpan, lalu deploy ulang. Sumber Link dengan URL https yang bisa diakses umum juga tampil.
• Di Studio, kanvas dan panel Preview hanya menampilkan bingkai pratinjau. Dokumen baru dimuat saat form dibuka di App.
• Pada bulk complete, Must reach the last page tidak berlaku.