Memastikan Checkbox Sudah Dipilih di Extended Search dari PHPMaker 2021

Artikel berikut akan membahas betapa mudahnya kita menerapkan business-logic yang mengharuskan Pengguna Akhir untuk memilih sedikitnya satu Checkbox pada field yang Lookup ke table tertentu. Bukan di form Add atau Edit, tetapi di bagian Extended Search pada halaman List dari Aplikasi Web yang di-generate oleh PHPMaker 2021.

Untuk mencobanya, pastikan Anda sudah mengikuti artikel ini. Kita akan menggunakan database dan table yang dibahas di artikel tersebut.

Sebagai Web Developer, kita ingin Pengguna Akhir wajib memilih atau memberi tanda centang sedikitnya pada satu Checkbox di field yang terdapat di bagian Extended Search tadi. Jika ini belum dilakukan, maka data tidak dapat ditampilkan di halaman List tersebut.

Untuk itu, maka pastikan kita sudah mengaktifkan Requires search dari bagian Table setup.

Selain itu, pastikan juga dari Fields setup, kita sudah mengaktifkan Ext. Search yang terdapat di kolom List Page untuk field Tags.

Selanjutnya, mari kita fokus pada field Tags di table multiple_tags tadi. Field ini lookup ke table yang bernama lookup.

Cukup hanya dengan memasukkan sedikit kode PHP ini saja ke dalam server event Form_CustomValidate milik halaman List dari table multiple_tags tadi, sehingga hasil lengkapnya menjadi seperti ini:

// Form Custom Validate event
function Form_CustomValidate(&$customError)
{
    // Return error message in CustomError
    if ($this->Tags->AdvancedSearch->SearchValue == "" && !$this->Tags->AdvancedSearch->IssetSession() && isset($_GET["cmd"]) && $_GET["cmd"] == "search") {
        $customError = "Tags belum dipilih, silahkan pilih sedikitnya satu Checkbox";
        return FALSE;
    }
    
    return true;
}

Setelah semua file script di-generate oleh PHPMaker 2021, maka kita dapat mencobanya dari halaman List milik table multiple_tags. Saat halaman ini ditampilkan pertama kali, belum ada data di table.

Sekarang cobalah untuk langsung mengklik tombol Search tanpa ada satu Checbox pun dicentang pada field Tags di Extended Search, maka kita akan melihat pesan error muncul: Tags belum dipilih, silahkan pilih sedikitnya satu Checkbox.

Kemudian, cobalah beri tanda centang pada satu Checkbox saja, lalu klik tombol Search, maka seharusnya kita akan melihat di table pada halaman List data yang sesuai dengan kriteria item Checbox yang kita centang tadi.

Horeee… berhasil… berhasil… berhasil… 😀

Betapa mudah dan cepatnya bukan? 😉