Membuat Kode Otomatis Saat Data Ditambah di Aplikasi Web dari PHPMaker

Tidak akan pernah bisa dihindari di sebuah Aplikasi Web yang mengharuskan sistem membuat ID atau Kode secara otomatis saat Pengguna menambah data yang baru. Tidak terkecuali juga dengan Aplikasi Web yang dihasilkan oleh PHPMaker. Hanya saja, Aplikasi Web yang dihasilkan oleh PHPMaker akan jauh lebih mudah mengimplementasikannya dibandingkan (mungkin) dengan Aplikasi Web yang dibuat dengan cara lain. Tidak percaya? Simak saja artikel ini selengkapnya.

Supaya lebih mudah, mari kita menggunakan contoh pada sebuah tabel yang paling sederhana. Tabel ini bernama t_jenis hanya memiliki dua buah Field, masing-masing bernama Kode dengan tipe CHAR(6) dan Deskripsi dengan tipe VARCHAR(20). Format data Kode yang diinginkan misalnya seperti ini: JNS001, JNS002, JNS003, dan seterusnya. Artinya, Kode tersebut tidak diinput oleh Pengguna, tapi akan otomatis dibuat oleh sistem. Jadi, Pengguna hanya perlu memasukkan data pada field Deskripsi saja.

Ada tiga langkah utama yang perlu dilakukan (tentu saja diasumsikan project PHPMaker Anda sudah sinkron dengan struktur tabel tadi).

Pertama, kita harus menyiapkan sebuah fungsi global untuk men-generate data Kode dengan format seperti di atas. Katakanlah nama fungsi tadi GetNextKodeJenis, kemudian kita menempatkannya ke dalam Global Code yang terdapat di bawah Server Events -> Global -> All Pages:

function GetNextKodeJenis() {
	$sNextKode = "";
	$sLastKode = "";
	$value = ew_ExecuteScalar("SELECT Kode FROM t_jenis ORDER BY Kode DESC");
	if ($value != "") { // jika sudah ada, langsung ambil dan proses...
		$sLastKode = intval(substr($value, 3, 3)); // ambil 3 digit terakhir
		$sLastKode = intval($sLastKode) + 1; // konversi ke integer, lalu tambahkan satu
		$sNextKode = "JNS" . sprintf('%03s', $sLastKode); // format hasilnya dan tambahkan prefix
		if (strlen($sNextKode) > 6) {
			$sNextKode = "JNS999";
		}
	} else { // jika belum ada, gunakan kode yang pertama
		$sNextKode = "JNS001";
	}
	return $sNextKode;
}

Kedua, kita harus memastikan bahwa saat Pengguna sedang menyimpan data yang baru, maka sistem akan mengambil data Kode yang terakhir dan telah ditambahkan dengan nilai satu. Untuk itu, salin kode ini ke dalam server event Row_Inserting:

// Row Inserting event
function Row_Inserting($rsold, &$rsnew) {
	// Enter your code here
	// To cancel, set return value to FALSE
	$rsnew["Kode"] = GetNextKodeJenis(); // mengantisipasi lebih satu user menginput data saat bersamaan
	return TRUE;
}

Perhatikan bahwa kita cukup hanya menugaskan nilai yang dihasilkan oleh fungsi GetNextKodeJenis ke dalam Field Kode di recordset yang baru; $rsnew[“Kode”]. Hal ini penting, untuk mengantisipasi jika ada lebih dari satu Pengguna yang hampir secara bersamaan menambah data pada tabel ini.

Ketiga, kita harus mengantisipasi kondisi di form saat Pengguna sedang menambah data. Karena field Kode tidak diinput secara manual oleh Pengguna, tapi akan diisi otomatis oleh sistem. Jadi, field Kode harus dinonaktifkan (sekalipun masih tetap bisa kelihatan), sambil tetap menampilkan kode berikutnya yang berasal dari fungsi buatan di atas tadi.

Untuk itu, kita menggunakan server event Row_Rendered dengan kode seperti di bawah ini:

// Row Rendered event
function Row_Rendered() {
	// To view properties of field class, use:
	//var_dump($this-><FieldName>);

	// Kondisi saat form Tambah sedang terbuka (tidak dalam mode konfirmasi)
	if (CurrentPageID() == "add" && $this->CurrentAction != "F") {
		$this->Kode->CurrentValue = GetNextKodeJenis(); // trik
		$this->Kode->EditValue = $this->Kode->CurrentValue; // tampilkan
		$this->Kode->ReadOnly = TRUE; // supaya tidak bisa diubah
	}

	// Kondisi saat form Tambah sedang dalam mode konfirmasi
	if ($this->CurrentAction == "add" && $this->CurrentAction=="F") {
		$this->Kode->ViewValue = $this->Kode->CurrentValue; // ambil dari mode sebelumnya
	}
}

Perhatikanlah dari kode barusan, kita harus menangani dua kemungkinan. Kemungkinan pertama, saat Pengguna sedang menambah data atau mode form dalam keadaan terbuka. Lalu kemungkinan yang kedua, saat Pengguna sedang dalam mode konfirmasi, maka kita menampilkan data Kode dari nilai Kode yang diperoleh dari mode form yang terbuka sebelumnya.

Perlu diketahui, bahwa meskipun kita menampilkan kode berikutnya di saat Pengguna sedang menambahkan data, tapi itu bukan berarti kode tersebut yang akan digunakan. Itu hanya referensi saja buat Pengguna pada saat dia membuka form Add. Jika pada saat yang hampir bersamaan ada Pengguna lain yang menambahkan data di tabel ini, maka ada kemungkinan si Pengguna tadi yang duluan mendapatkan dan menyimpan kode tersebut.

Itulah kenapa sebabnya di server event Row_Inserting kita pun harus mengantisipasi hal tersebut dengan mengambil ulang nilai kode yang terakhir dari Database, lalu mengisikannya kembali ke field Kode sebelum data benar-benar disimpan ke Database. Paham maksudnya, ‘kan? 😉

Yang hebatnya lagi adalah, trik ini bisa digunakan pada mode Grid-Add. Kita hanya cukup menyembunyikan kolom atau field Kode, dengan menambahkan sedikit kode saja di server event Page_Load yang terdapat di bawah lokasi Server Events -> Table-Specific -> List Page, sehingga kode selengkapnya menjadi seperti ini:

// Page Load event
function Page_Load() {
	//echo "Page Load";
	if ($this->IsGridAdd()) {
		$this->Kode->Visible = FALSE;
	}
}

Betapa mudah dan cepatnya, bukan? 😀