Rancang unggahan berkas website dengan persyaratan yang jelas, validasi server, pesan kegagalan, dan pembagian tanggung jawab pemeriksaan.

Unggahan adalah awal pekerjaan, bukan akhir pemeriksaan

Formulir permintaan desain dapat memerlukan gambar contoh dari calon pelanggan. Dari sisi pengunjung, pekerjaannya tampak selesai setelah memilih berkas dan menekan tombol kirim. Dari sisi pengelola, masih ada pertanyaan mengenai keberhasilan pengiriman, kesesuaian berkas, dan tindak lanjut permintaan. Rancangan unggahan yang baik menjelaskan perbedaan tahapan tersebut, sehingga pesan berhasil tidak menimbulkan anggapan bahwa materi pasti sudah diperiksa atau permintaan bisnis otomatis disetujui.

Artikel ini membahas kebutuhan yang perlu dibicarakan pemilik website dengan pengembang dan petugas operasional. Contoh studio desain beserta kebijakan berkasnya bersifat hipotetis, bukan fitur atau batas paket hosting tertentu. Sasaran pembahasannya adalah spesifikasi yang bisa diperiksa: apa yang diterima, apa yang ditolak, pesan apa yang diterima pengguna, dan siapa yang bertindak ketika berkas belum dapat diproses oleh tim.

Alur pemilih berkas browser menuju pemeriksaan server lalu antrean pemeriksaan dengan jalur penolakan yang jelas.
Petunjuk format pada browser membantu pengguna, sedangkan keputusan validasi tetap dilakukan pada server.

Mulai dari alasan bisnis dan persyaratan yang terukur

Tuliskan tujuan lampiran sebelum menentukan format. Bila tim hanya membutuhkan gambaran visual awal, tanyakan apakah seluruh jenis dokumen memang perlu diterima. Contoh studio latihan dapat memilih JPEG dan PNG dengan batas dua megabita per berkas setelah menguji kebutuhan gambarnya. Angka ini hanyalah contoh kebijakan untuk dibahas, bukan rekomendasi universal. Tim perlu menyepakati satuan ukuran dan menyesuaikannya dengan konfigurasi aplikasi serta layanan yang digunakan.

Jelaskan persyaratan di dekat kolom unggahan sebelum pengguna mulai memilih berkas. Informasi dapat mencakup format, jumlah lampiran, batas ukuran, dan langkah yang dapat dilakukan jika materi tidak memenuhi ketentuan. Bila foto perlu diperkecil, berikan petunjuk yang dapat dimengerti pelanggan tanpa meminta mereka menebak kualitas yang dibutuhkan. Persyaratan yang jelas membantu petugas menangani pertanyaan berulang dan memberi pengembang dasar untuk membuat hasil validasi yang konsisten.

Tiga tahap pengiriman, penilaian teknis, dan pemeriksaan bisnis dengan hasil serta penanggung jawab berbeda.
Berkas yang terkirim, lolos aturan teknis, dan siap ditindaklanjuti adalah keadaan berbeda dalam contoh alur kerja.

Pemilih berkas di browser hanya membantu pemilihan

Atribut accept pada input berkas dapat memberi petunjuk format kepada browser. Namun, MDN menegaskan bahwa atribut tersebut tidak memvalidasi jenis berkas yang dipilih; pada banyak pemilih berkas, pengguna dapat mengubah pilihan sehingga format lain tetap dapat dipilih. Persyaratan yang diharapkan harus divalidasi pada server. Jadi, daftar format yang tampak dibatasi di layar belum menjadi bukti bahwa aplikasi menolak berkas yang tidak sesuai.

Dalam spesifikasi proyek, pisahkan bantuan untuk pengguna dari keputusan penerimaan aplikasi. Pemilik proses dapat menyetujui kalimat persyaratan dan pesan penolakan, sedangkan pengembang menjelaskan bagaimana aturan diterapkan di server. Minta bukti pemeriksaan untuk keduanya. Jika pengguna memilih berkas yang salah, layar sebaiknya membantu mereka memahami langkah berikutnya; jika permintaan tidak memenuhi aturan server, sistem perlu menanganinya sesuai rancangan tanpa bergantung pada tampilan pemilih berkas saja.

Periksa jenis dengan beberapa kontrol yang saling melengkapi

OWASP menyarankan daftar ekstensi yang diizinkan sesuai kebutuhan bisnis, batas ukuran, serta pemeriksaan jenis berkas. Content-Type yang disertakan pengirim tidak boleh dipercaya sebagai jaminan karena dapat dipalsukan. Pemeriksaan signature berkas juga tidak cukup bila digunakan sendirian. Pendekatan berlapis diperlukan; tidak ada satu teknik yang menyelesaikan seluruh risiko. Detail implementasinya perlu ditinjau pengembang berdasarkan jenis materi dan cara aplikasi memprosesnya.

Pemilik usaha tidak harus menulis sendiri pemeriksa format untuk dapat menilai kelengkapan pekerjaan. Ajukan pertanyaan konkret: aturan apa yang berlaku untuk setiap format, hasil apa yang muncul ketika aturan gagal, dan bukti apa yang tersedia dari lingkungan uji? Hindari menerima pernyataan semua file aman hanya karena namanya berakhiran jenis yang diizinkan. Keputusan teknis perlu memiliki lingkup yang jelas, termasuk hal yang belum diperiksa dan tindak lanjutnya.

Bedakan kegagalan pengiriman dari penolakan aturan

Pada aplikasi PHP, dokumentasi menyediakan kode kesalahan unggahan pada bagian error dari informasi berkas. Konstanta resminya membedakan keadaan seperti unggahan yang hanya sebagian, tidak ada berkas yang diunggah, ukuran melampaui upload_max_filesize, dan kegagalan menulis ke disk. Pengembang perlu menggunakan informasi yang relevan untuk menangani hasil pengiriman. Kesalahan tersebut berbeda dari keputusan aplikasi bahwa sebuah berkas lengkap tidak sesuai format yang dipersyaratkan.

Perbedaan ini berpengaruh pada bantuan bagi pelanggan. Pesan berkas terlalu besar meminta tindakan yang berbeda dari pesan pengiriman belum selesai. Susun bahasa yang ringkas, akurat, dan dapat ditindaklanjuti tanpa menampilkan rincian internal server. Untuk kasus yang membutuhkan bantuan, tentukan informasi yang boleh disertakan dalam laporan, misalnya waktu kejadian dan nomor permintaan. Petugas kemudian dapat meneruskan masalah kepada pihak yang tepat tanpa meminta pelanggan mengulang seluruh cerita.

Tentukan tempat dan tanggung jawab penanganan

OWASP juga membahas penamaan berkas oleh aplikasi, pembatasan izin, serta penyimpanan terpisah atau di luar webroot. Pemindaian antivirus atau sandbox dapat menjadi bagian kontrol bila tersedia, tanpa menjamin semua ancaman terdeteksi. Materi yang baru masuk tidak semestinya langsung dianggap layak dipublikasikan. Kebutuhan penerimaan, pemrosesan, dan penayangan perlu dibedakan agar pengembang dapat merancang alur sesuai risiko serta fasilitas yang benar-benar disiapkan.

Untuk contoh studio, tentukan siapa yang berhak memeriksa lampiran dan siapa yang menghubungi pengirim ketika materi kurang jelas. Seseorang mungkin dapat menilai kecocokan referensi desain tetapi bukan pihak yang menangani kegagalan teknis. Catat pembagian tersebut dalam prosedur sederhana. Jika salah satu petugas tidak bertugas, alur pengganti harus diketahui agar permintaan tidak berhenti hanya karena berkas sudah berhasil masuk tetapi tidak ada orang yang merasa bertanggung jawab meninjaunya.

Gunakan status kerja yang tidak menjanjikan hasil terlalu cepat

Rancangan bisnis dapat memakai status seperti Diterima untuk diperiksa, Perlu perbaikan, dan Siap ditindaklanjuti. Nama serta perpindahannya perlu disepakati bersama tim, bukan dianggap sebagai status bawaan semua aplikasi. Jelaskan arti setiap status dalam pekerjaan nyata. Diterima untuk diperiksa, misalnya, hanya berarti permintaan telah masuk ke alur yang ditentukan, sementara kesesuaian materi dan keputusan layanan masih menunggu penilaian petugas yang ditugaskan.

Sepakati pula apa yang terjadi ketika pengguna mengirim ulang materi. Apakah lampiran baru menggantikan bahan sebelumnya, menambah referensi, atau membuka pemeriksaan baru? Ketidakjelasan di sini dapat membuat desainer mengerjakan versi yang salah walaupun sistem unggah berfungsi. Berikan identitas permintaan yang dapat dirujuk dalam komunikasi dan tetapkan cara petugas mengenali versi materi yang digunakan. Ini adalah keputusan proses kerja yang harus diterjemahkan menjadi perilaku aplikasi yang konsisten.

Siapkan contoh pengujian yang aman dan hasil yang diharapkan

Gunakan lingkungan uji yang disetujui serta berkas latihan tanpa data pelanggan. Susun contoh berupa format yang diperbolehkan dengan ukuran di bawah batas, berkas yang melebihi batas, format biasa yang tidak termasuk kebijakan, dan pengiriman tanpa lampiran ketika lampiran diwajibkan. Catat keputusan yang diharapkan untuk masing-masing contoh. Pengembang dapat menambahkan pengujian teknis yang sesuai tanpa meminta pemilik usaha mencari atau mengunggah materi berbahaya.

Pemeriksaan tidak selesai pada pesan di layar. Pastikan permintaan latihan mencapai petugas yang benar, statusnya sesuai rancangan, dan materi yang diterima dapat dihubungkan dengan permintaan tersebut. Bila ditemukan masalah, tuliskan kondisi pengulangan dan hasil aktualnya sebelum meminta perbaikan. Setelah koreksi, ulangi skenario yang terdampak. Bukti ini membantu membedakan masalah tampilan, pengiriman, validasi, dan penanganan operasional yang memerlukan tindakan dari orang berbeda.

Bawa spesifikasi ke pengembang dan penyedia layanan

Sebelum fitur disepakati, minta penjelasan batas yang diterapkan aplikasi dan batas relevan pada layanan hosting yang dipakai. Jangan menyamakan ruang penyimpanan paket dengan ukuran maksimum satu unggahan. Untuk meninjau kebutuhan website bisnis, informasi website perusahaan JagoWeb tersedia di https://www.jagoweb.com/website-perusahaan, sedangkan pilihan layanan dapat dilihat di https://www.jagoweb.com/. Kemampuan formulir tertentu perlu dikonfirmasi melalui pembahasan kebutuhan, bukan disimpulkan dari nama layanan saja.

Simpan persyaratan, hasil pengujian, serta pembagian tugas sebagai acuan pemeliharaan. Saat kebutuhan bisnis berubah, tinjau kembali apakah format, batas, pesan, dan penanganannya masih cocok. Misalnya, kebutuhan referensi gambar awal berbeda dari penerimaan materi cetak beresolusi tinggi. Perubahan sebaiknya dinilai sebagai satu rangkaian pekerjaan, sehingga memperbesar batas unggahan tidak dilakukan tanpa memikirkan kemampuan pemeriksaan, beban tim, dan pengalaman pengguna yang akhirnya menerima layanan.

Bacaan terkait

Sumber dan referensi