Retrieval)Arguments)

!
Retrieval! Arguments! pada! PowerBuilder! adalah! sebuah! fitur! yang! memungkinkan!
mengambil!(retrieve)!data!pada!sebuah!DataWindow!berdasarkan!suatu!kondisi!yang!
diatur! pada! sebuah! atau! sekumpulan! arguments.! Seperti! umumnya! ketika! ingin!
mengambil!data!pada!sebuah!DataWindow,!biasanya!kita!akan!menggunakan!kode!
seperti!di!bawah!ini:!
"
dw_1.Retrieve()"
"
!
Perhatikan! pemanggilan! fungsi/method! Retrieve()! yang! tanpa! argument! apapun.!
Dengan! Retrieval! Arguments! maka! pemanggilan! fungsi/method! Retrieve()! akan!
menjadi!seperti:!
"
string"ls_arg1,"ls_arg2"
int"li_arg3"
"
dw_1.Retrieve(ls_arg1,"ls_arg2,"li_arg3,")"//"dst"jika"diperlukan"
"
!
!
Contoh)kasus:)
Umumnya! contoh! sederhana! penggunaan! Retrieval! Arguments! adalah! melakukan!
pencarian! (searching)! sebuah/sekumpulan! data! pada! database! di! DataWindow.!
Sebelum! kita! belajar! bagaimana! menggunakan! Retrieval! Arguments,! alangkah!
baiknya!

kita!

mengetahui!

terlebih!

dahulu!

metodeGmetode!

pencarian!

sebuah/sekumpulan!data!secara!umum.!
1.! Metode!umum!!!ketik)kata)kunci,)kemudian)tekan)tombol)cari!
Metode! ini! yang! umum! digunakan! pada! macamGmacam! aplikasi,! baik! desktop,!
web,! ataupun! mobile.! Kelebihan! penggunaan! metode! ini! adalah! ketika! aplikasi!
tersebut! menggunakan! database! terpisah! jauh! jaraknya! dengan! perangkat!
komputer!dan!biasanya!diperlukan!akses!jaringan!skala!internet.!
Contoh:! aplikasi! dijalankan! di! STMIK! SPB! Samarinda! yang! terhubung! ke!
database!di!datacenter!di!Jakarta.!
!

2.! Metode!realtime!!!ketik)kata)kunci,)langsung)cari!
Metode! ini! kebalikan! dari! metode! di! atas,! biasanya! digunakan! tanpa!
pertimbangan!jarak!antara!aplikasi!dengan!database!server.!
Contoh:! aplikasi! dijalankan! di! PC! yang! menjadi! satu! dengan! database! server,!
atau!aplikasi!yang!dijalankan!di!STMIK!SPB!dan!database!serverGnya!berada!di!
STMIK!SPB!juga.!
!
Metode!ini!akan!mencari!setiap!unsur!kata!yang!diketikkan.!
Contoh!penggunaan:!
Kata)kunci)(nama)kota))
S!
Sa!
Sam!
Sama!
dst!

Hasil)
Samarinda,!Sampit,!Sangatta,!Salatiga,!Surabaya,!
Semarang,!dsb.!
Samarinda,!Sampit,!Sangatta,!Salatiga!
Samarinda,!Sampit!
Samarinda!
!

!
Dari!ilustrasi!pencarian!di!atas!dapat!disimpulkan!bahwa!pencarian!akan!mencari!
setiap!huruf!yang!tersusun!hingga!telah!mencapai!kriteria!pencarian!yang!sesuai.!
!
!
Praktik)
Setelah! memahami! metodeGmetode! pencarian! data! di! atas,! kita! akan! langsung!
mempelajari!penggunaan!fitur!Retrieval!Arguments!pada!PowerBuilder.!Untuk!praktik!
ini!kita!masih!menggunakan!project!Sistem)Informasi)Penerimaan)Beasiswa!yang!
sudah!dibuat!beberapa!minggu!lalu.!
!
Prasyarat)#1:!pastikan!anda!telah!melengkapi)masingGmasing)data!pada!database!
yang!telah!dibuat!!Isilah!beberapa!data!seperti!di!bawah!ini:!

Prasyarat)#2:!buat)DataWindow)dan)atur)Retrieval)Arguments.!
Buat!DataWindow!!!tipe!Grid!!!SQL)Select,!pilih!tabel!penerima_beasiswa!dan!
master_pelajar,!dan!pilih!kolom!yang!akan!ditampilkan!sehingga!menjadi!seperti:!

!
Kemudian!selesaikan!pemilihan!tabel!dengan!menekan!tombol!

!dan!pilih!Yes!jika!

ada!pesan!konfirmasi!seperti!di!bawah!ini:!

)
Lanjutkan!panduan!pembuatan!DataWindow!hingga!selesai,!hingga!menjadi!seperti!
di!bawah!ini:!

!
Simpan!DataWindow!di!atas!dengan!nama!d_penerima_beasiswa_cari.!
!
Kemudian!masih!pada!d_penerima_beasiswa_cari!klik!pada!menu!Design!!!Data)
Source!yang!akan!membawa!ke!jendela!baru!pilihanGpilihan!tabel.!Kemudian!klik!lagi!
pada!menu!Design)!)Retrieval)Arguments.!
!

Pada!posisi!1!kolom!name!ketik!as_nbp!dan!typeGnya!adalah!String!seperti!gambar!
di!bawah:!

!
Kemudian!tekan!OK,!kemudian!atur!kondisi!pada!tab!where!dengan!Value!bernilai!
:as_npb!(dengan!tanda!titik!dua/semicolon)!seperti!gambar!di!bawah:!

!
jika! sudah,! tekan! tombol!

!dan! pilih! Yes! jika! ada! pesan! konfirmasi.! Jangan! lupa!

untuk!simpan/save!setiap!ada!perubahan!baru!pada!DataWindowGnya.!
)
Prasyarat) #3:! buat! objek! Window! dengan! nama! w_penerima_beasiswa_cari! dan!
desain!window!seperti!gambar!di!bawah!ini:!

!
Tambahkan! DataWindow! Control! dengan! nama! dw_1! dan! atur! DataObjectGnya! ke!
d_penerima_beasiswa_cari.!

!
Prasyarat) #4:! tambahkan) submenu! pada! menu! Proses! dengan! nama! Cari)
Penerima)Beasiswa!seperti!gambar!di!bawah!ini:!

!
dan!atur!script!agar!submenu!tersebut!membuka!window!w_penerima_beasiswa_cari!
seperti!di!atas.!

!
"! Metode)umum)
Tambahkan!beberapa!kontrol!pada!w_penerima_beasiswa_cari!
G! Single!Line!Edit!!!sle_1!
G! Command!Button!!!cb_1!!
sehingga!menjadi!seperti!berikut:!

!
tambahkan!script!pada!event!open()!pada!objek!window/form:!
dw_1.SetTransObject(SQLCA)!
!
pada!cb_1)event!clicked():!
string!ls_npb!
ls_npb!=!sle_1.text!
dw_1.Retrieve(ls_npb)!
!
!

dan!lakukan!ujicoba!pencarian,!hasilnya!akan!seperti!di!bawah!ini:!

!
!
"! Metode)realtime)
Pada! w_penerima_beasiswa_cari! hapus! objek! cb_1,! karena! proses! pencarian!
realtime!tidak!memerlukan!tombol!cari,!sehingga!menjadi!seperti!ini:!

!
Double6click!pada!sle_1,!dan!buat!sebuah!event!pada!pilihan!New)Event!seperti!
di!gambar:!

!
!

dan!buatlah!event!baru!seperti!ketentuan!di!bawah!ini:!

!
Pada!event!ue_enchange!tersebut,!ketikkan!kode!berikut:!

!
!
dan!lakukan!ujicoba!pencarian!seperti!gambar!berikut:!