Melakukan Aksi Tertentu Sebelum Record Dihapus di Aplikasi Web dari PHPMaker

Sering sekali Web Developer bertanya kepada saya, Bagaimana cara menambahkan business-logic tertentu ketika sebuah atau bahkan beberapa Record akan dihapus dari Database? Atau pertanyaan yang mirip dengan itu adalah, Bagaimana cara mendapatkan data record yang akan sedang dihapus di sebuah Aplikasi Web?

Ketika sebuah Record atau bahkan beberapa Record akan dihapus dari Database melalui sebuah Aplikasi Web, maka beragam business-logic bisa diterapkan oleh Web Developer. Ada yang ingin merekam data tersebut terlebih dulu ke dalam tabel lain; ada juga yang ingin hanya merekam data tersebut ke file log, sebelum data tersebut akhirnya benar-benar dihapus. Atau bahkan, ada juga Web Developer yang ingin menjalankan pernyataan SQL tertentu untuk mengubah data terkait di tabel lain.

Tentu tidak ada yang salah dengan semua itu. Sayangnya, masih banyak Web Developer yang kesulitan dan kebingungan bagaimana cara menerapkan business-logic tersebut. PHPMaker bisa menangani setiap kemungkinan yang bisa terjadi saat event penghapusan Record. Tentu saja Anda sebagai Web Developer tidak akan mengalami kesulitan jika menggunakan PHPMaker sebagai tools untuk mengembangkan aplikasi berbasis web dengan cepat sekaligus berkualitas.

PHPMaker sudah menyediakan sebuah server event yang bernama Row_Deleting yang lokasinya berada di bawah Server Events -> Table-Specific -> Common di dalam project PHPMaker Anda. Pastikan sebelumnya Anda sudah memilih salah satu Table 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 ketika ada Record yang akan dihapus dari Database. Yang enaknya adalah, server event ini dijalankan bukan hanya untuk menghapus satu Record saja, tapi berlaku juga untuk proses penghapusan beberapa Record sekaligus. Seperti yang kita ketahui, PHPMaker juga mendukung untuk pembuatan fitur penghapusan beberapa record sekaligus (Multiple-Delete).

Itulah mengapa server event ini disebut dengan Row_Deleting yang kurang lebih artinya adalah saat Baris atau Record atau Row sedang dihapus. Jadi, di samping berlaku untuk penghapusan satu Row, server event ini berlaku juga untuk penghapusan beberapa Row sekaligus dengan memanggil ulang server event ini untuk setiap Row yang dihapus.

Server event ini merupakan member dari Class Table. Anda sebagai Web Developer dapat menggunakan member lainnya yang terdapat di Class ini (jika dibutuhkan). Server event ini memiliki sebuah argumen yang berupa sebuah Record yang akan dihapus sebagai sebuah array. Artinya, Anda bisa menggunakan argumen ini untuk mengambil nilai di field tertentu dari Record yang akan dihapus tadi, menggunakan sintaks untuk mengakses elemen yang terdapat di sebuah array.

Supaya lebih jelas, mari kita simak contoh berikut. Katakanlah Anda ingin menampilkan data nama lengkap dari field Nama_Lengkap di tabel pelanggan sesaat sebelum sebuah Record dihapus. Untuk itu, maka kita dapat menggunakan kode seperti ini:

// Row Deleting event
function Row_Deleting(&$rs) {
    // Enter your code here
    // To cancel, set return value to False
    $this->setSuccessMessage("Nama lengkap dari record yang dihapus: " . $rs["Nama_Lengkap"]);
    return TRUE;
}

Setelah file script di-generate ulang oleh PHPMaker lalu Aplikasi Web dijalankan lewat browser, maka ketika Pengguna menghapus Record di tabel pelanggan maka sistem akan menampilkan pesan yang berisi Nama Lengkap data pelanggan yang dihapus. Artinya, jika hanya ada satu Record yang berhasil dihapus, maka akan muncul pesan sebanyak satu kali. Sedangkan jika ada beberapa Record dihapus (misalnya 3 Record), maka akan ada tiga baris pesan yang muncul memberitahukan data Nama Lengkap dari Record yang sedang dihapus.

Hal penting lainnya yang perlu Anda ketahui dari server event Row_Deleting adalah, bahwa dia dapat digunakan untuk mem-validasi terlebih dulu Record yang akan dihapus. Artinya, Anda sebagai Web Developer masih diberi kesempatan oleh PHPMaker untuk memeriksa data mana saja yang boleh dihapus, dan mana yang tidak.

Jika Anda tidak ingin menghapus Record tertentu, maka Anda dapat menambahkan kondisi tertentu, dan jika kondisi tersebut memenuhi syarat, maka cukup kembalikan nilai FALSE, sebaliknya untuk Record yang boleh dihapus, maka Anda cukup mengembalikan nilai TRUE. Wouw. Mudah sekali, bukan?

Pada contoh berikut akan ditunjukkan bagaimana caranya memeriksa record yang tidak boleh dihapus jika memenuhi kriteria tertentu. Katakanlah dari 10 Record yang akan dihapus (menggunakan fitur Multiple-Delete di PHPMaker), terdapat 3 Record yang tidak boleh dihapus.

Kriteria dari Record-Record yang tidak boleh dihapus itu adalah jika nilai field Nama_Lengkap-nya masing-masing sama dengan Masino Sinaga, Dorce Simatupang, dan Elvis Sinaga. Mari langsung simak kode berikut:

// Row Deleting event
function Row_Deleting(&$rs) {
    // Enter your code here
    // To cancel, set return value to False
    if ($rs["Nama_Lengkap"] == "Masino Sinaga" || $rs["Nama_Lengkap"] == "Dorce Simatupang" || $rs["Nama_Lengkap"] == "Elvis Sinaga") {
        $this->setWarningMessage("Tidak diijinkan dihapus: " . $rs["Nama_Lengkap"]);
        return FALSE;
    }
    return TRUE;
}

Setelah file script untuk Aplikasi Web di-generate ulang oleh PHPMaker, kemudian Aplikasi Web dijalankan dari browser, lalu Pengguna mencoba menghapus 10 Record, di mana tiga di antaranya memenuhi kondisi yang tidak boleh dihapus, maka jika sistem baru menemukan satu Record saja yang memenuhi syarat untuk tidak boleh dihapus, sistem akan menampilkan pesan yang menyatakan bahwa Record tersebut tidak dapat dihapus. Seketika itu juga proses penghapusan akan dibatalkan oleh sistem.

Artinya, ketika satu Record saja tidak boleh dihapus sesuai dengan kondisi tadi, maka Record-Record lainnya yang meskipun memenuhi syarat untuk dihapus pun akan dibatalkan penghapusannya. Jadi, penghapusan beberapa Record lainnya baru bisa dilakukan jika tidak ada satupun Record yang memenuhi syarat untuk tidak boleh dihapus.

Sekarang mari kita simak contoh lainnya bagaimana Web Developer dapat mengupdate data di Table terkait lainnya ketika sebuah Record yang terkait dengan Table tersebut dihapus dari Database:

function Row_Deleting(&$rs) {
    // Enter your code here
    // To cancel, set return value to False
    ew_Execute("UPDATE table_lain SET Field1 = 'deleted' WHERE ID_Table = '".$rs["id"]."'");
    return TRUE;
}

Betapa mudahnya kita bisa memperbarui record di Table lain hanya dengan menambahkan satu baris kode saja. Kode ini akan berlaku juga untuk penghapusan beberapa Record sekaligus, dan akan memperbarui Record yang terkait di Table lainnya.

Inilah beberapa bukti yang menunjukkan bahwa server event ini akan dijalankan untuk setiap Record atau Row yang dihapus di level Table. Setiap Record akan memanggil server event ini saat sedang dihapus. Sampai di sini saya berharap Anda memahami kemampuan dan kehebatan dari server event ini sehingga dapat Anda gunakan sebagaimana mestinya.

See? Betapa mudah, cepat, sekaligus menyenangkan sekali bukan menerapkan business-logic sendiri melalui server event yang telah disediakan oleh PHPMaker? Betapa PHPMaker sudah menangani hal-hal seperti ini, yang justru sering kali dirasakan sebagai hambatan bagi Web Developer ketika akan menerapkan business-logic tertentu saat Record akan dihapus dari Database pada Aplikasi Web yang mereka bangun. 🙂