Ketika Pengguna mencari data di sebuah Aplikasi Web, maka sebenarnya sistem melakukan penyaringan record dari seluruh kumpulan record yang terdapat di sebuah tabel, lalu hasilnya ditampilkan ke dalam halaman List. Sering kali sebelum hasil pencarian tadi akan ditampilkan ke halaman List, dibutuhkan kondisi penyaringan tambahan yang harus dilakukan oleh Web Developer agar hasil pencarian tadi sesuai dengan kebutuhan sistem.
Contoh: Khusus untuk Pengguna yang memiliki Level Pengguna (User Level) Operator ketika melakukan pencarian data, perlu ditambahkan kondisi tertentu yang sesuai dengan level tersebut pada bagian klausa WHERE dari pernyataan SQL ke Database.
PHPMaker sudah menyediakan server event yang bernama Recordset_Searching yang lokasinya berada di bawah Server Events -> Table-Specific -> Common pada project PHPMaker Anda. Pastikan sebelumnya Anda sudah memilih salah satu tabel yang Anda inginkan dari panel Database di sebelah kiri dari project PHPMaker Anda, untuk memastikan Anda menambahkan kode di server event pada Table yang tepat.
Sesuai dengan namanya, server event ini akan dipanggil pada saat atau menjelang detik-detik pencarian record mulai dilakukan. Itu artinya, Anda sebagai Web Developer masih diberi kesempatan oleh PHPMaker untuk menambahkan kondisi tertentu di bagian klausa WHERE pada pernyataan SQL yang digunakan oleh sistem untuk menyaring record di tabel tersebut.
Server event ini merupakan member dari Class Table. Anda sebagai Web Developer dapat menggunakan member lainnya yang terdapat di Class ini (jika dibutuhkan). Ada satu argumen untuk server event Recordset_Searching, yaitu variabel $filter. Kalau Anda perhatikan dengan seksama, sebenarnya server event ini mirip dengan server event yang dulu sudah pernah kita bahas, yaitu Recordset_Selecting.
Perhatikan contoh berikut:
function Recordset_Searching(&$filter) {
if (CurrentUserLevel() == 1) // level 1 = Operator
ew_AddFilter($filter, "Field1 = '1234'"); // tambahkan ekspresi filter
}
Dalam contoh tersebut, Anda sebagai Web Developer dapat menambahkan (bukan menimpa) kriteria penyaringan dengan menggunakan Global Function yang sudah disediakan oleh PHPMaker bernama ew_AddFilter hanya untuk Pengguna yang memiliki level dengan kode 1 (Operator). Fungsi ini memiliki dua argumen. Argumen pertama merupakan variabel $filter, dan argumen kedua merupakan ekspresi filter yang diinginkan. Pastikan ekspresi filter tersebut valid untuk disisipkan ke dalam pernyataan SQL. Dalam contoh di atas Field1 = ‘1234’ merupakan ekspresi filter yang valid untuk field yang bernama Field1 dan memiliki tipe string/varchar/char.
Perbedaan antara Recodset_Searching dengan Recordset_Selecting adalah, server event Recordset_Searching hanya dipanggil ketika Pengguna melakukan pencarian data, baik dengan menggunakan metode Pencarian Cepat (Quick Search) maupun Pencarian Lanjutan (Advanced Search) di mana hasilnya akan ditampilkan kembali ke halaman List.
Sedangkan server event Recordset_Selecting akan dipanggil di beberapa halaman berikut: List, View, Edit, Delete, dan Update.
Untuk kesekian kalinya lagi, Web Developer sangat dimanjakan oleh PHPMaker untuk menambahkan business-logic tertentu sesuai dengan kebutuhan, sehingga Aplikasi Web yang dihasilkan oleh PHPMaker dapat dibuat dengan sangat cepat, mudah, dan lagi-lagi… menyenangkan! 🙂
Tinggalkan Balasan