Setiap Aplikasi Web pasti memiliki fitur pencarian data. Kriteria pencarian harus dapat ditentukan oleh Pengguna Akhir atau Pemakai Aplikasi Web tersebut melalui form Pencarian. Kadang-kadang, kriteria pencarian tersebut perlu dimodifikasi terlebih dulu sebelum sistem melakukan pencarian data ke Database.
PHPMaker sudah menyediakan sebuah server event yang bernama Recordset_SearchValidated 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.
Seperti namanya, server event Recordset_SearchValidated akan dipanggil setelah server event Form_CustomValidate dan kriteria pencarian ditugaskan ke object Table atau Fields. Artinya, pada saat itu proses validasi pencarian sudah selesai dilakukan. Anda sebagai Web Developer diberi kesempatan oleh PHPMaker untuk memodifikasi kriteria pencarian di server event ini.
Server event ini merupakan member dari Class Table. Anda sebagai Web Developer dapat menggunakan member lainnya yang terdapat di Class ini (jika dibutuhkan). Tidak ada argumen untuk server event Recordset_SearchValidate.
Untuk mengganti kriteria Quick Search atau Pencarian Cepat, maka cukup ganti property yang bernama BasicSearchKeyword dan BasicSearchType milik object Table. Sedangkan untuk mengganti kriteria Advanced Search atau Pencarian Lanjutan, cukup ganti property AdvancedSearch (yang merupakan object dari Class cAdvancedSearch) dari object Field.
Sebagai contoh, perhatikan kode berikut ini:
function Recordset_SearchValidated() {
$this->MyField1->AdvancedSearch->SearchValue = "data yang dicari"; // nilai pencarian
}
Seperti pada contoh kode tersebut, Anda sebagai Web Developer dapat mengganti nilai property SearchValue untuk Pencarian Lanjutan milik object Field yang bernama MyField1 dengan menugaskan string data yang dicari. Artinya, Anda sebagai Web Developer memiliki kesempatan untuk menambahkan nilai pencarian sesuai kebutuhan melalui server event tersebut.
Satu lagi bukti dari sekian banyaknya kehebatan PHPMaker yang dapat dioptimalkan oleh Web Developer untuk membangun Aplikasi Web dengan cepat, mudah, sekaligus menyenangkan. 🙂
[…] Mudahnya Memodifikasi Kriteria Pencarian di Aplikasi Web dari PHPMaker […]