Compiere Frans Tjhi CustomChapter
Seri Solusi Enterprise Open Source Cara Cepat Menerapkan ERP Menggunakan
Compiere
Frans Thamura Tjhi Yanti
Seri Solusi Enterprise Open Source
Lampiran 1
Membuat Window Compiere Baru
Seperti yang dijelaskan dibab-bab sebelumnya, dan seperti yang telah dirasakan oleh para pembaca, Compiere terdiri dari 2 bagian utama, yaitu Window dan Form, dimana Window adalah sebuah
form yang digenerate oleh sistem dan Form melalui proses
pemograman menggunakan Java.Adapun lampiran ini akan memberikan contoh kecil bagaimana membuat sebuah Window dan meregistrasikannya pada menu dari Compiere sehingga dapat dieksekusi.
Persiapan untuk kustomisasi
Untuk membuat sebuah Window ataupun kustomisasi lainnya didalam Compiere, sebenarnya ada beberapa mekanisme kerja, beberapa sarana yang popular adalah dengan menggunakan Enterprise Manager dari Oracle, TOAD dari Quest ataupun menggunakan Eclipse.
Eclipse adalah sebuah IDE untuk pengembangan, yang dapat didownload di http://www.eclipse.org. secara default Eclipse IDE datang tidak dengan kemampuan untuk mengakses database, untuk itu diperlukan sebuah plugins yaitu SQL Explorer yang dapat didownload dari http://www.sf.net/projects/sqlexplorer. Ilmu dasar mengenai Java dan Eclipse sebaiknya telah dimiliki sebelum melakukan kustomisasi Compiere, atau dapat membaca buku “Pengembangan Aplikasi Enterprise menggunakan Teknologi Cara Cepat Menerapkan ERP Menggunakan Compiere
Setelah semua telah disiapkan, buatlah sebuah koneksi database ke Oracle menggunakan JDBC Oracle Thin Client. Sebenarnya Oracle telah datang dengan JDBC, tetapi untuk lebih mudahnya pakai saja oracle.jar dari folder dimana Compiere diinstall, masuklah ke perspective SQL Explorer, kemudian pada view sebelah kiri, settinglah Driver JDBC Oraclenya agar dapat berkomunikasi dengan server Oracle.
SQLExplorer dengan extra JDBC Oracle (oracle.jar)
Bilamana telah selesai memodifikasi driver JDBC, maka sebuah icon silang merah akan berubah menjadi tanda petik biru, yang
berarti setting dapat dikatakan telah selesai. Masuklah ke Alias pada SQLExplorer, kemudian settinglah, masukan URL, Driver, username dan password dari Oracle. Sebaiknya username dan password menggunakan compiere
Seri Solusi Enterprise Open Source
account yang mana didapat saat mensetup Compiere pertama kali.
Setting Alias di SQLExporer
Bilamana telah selesai mensetting Alias, Eclipse telah siap untuk melakukan koneksi ke database Oracle, untuk membuat koneksi, klik saja Connection icon (paling kiri), dan pilih Oracle.
Connection View
Bilamana Connection Oracle telah dipilih, akan muncul dialog box untuk menanyakan username dan password untuk mengakses Oracle. Cara Cepat Menerapkan ERP Menggunakan Compiere
Dialog Conection Oracle
Setelah melalui tahap proses autorisasi telah selesai, maka di View Database structure akan muncul semua informasi dari Oracle, ini artinya proses kustomisasi telah dapat dilakukan.
Eclipse + SQLExplorer yang telah terkoneksi dengan Oracle
Memulai Pembuatan Window pada CompiereDalam kasus ini, akan dikembangkan sebuah Window diatas
Seri Solusi Enterprise Open Source
VARCHAR2 (20) NULL , Blood_Type
VARCHAR2 (20) NULL , NPWP
VARCHAR2 (20) NULL , Bank_Name
VARCHAR2 (20) NULL , Bank_Account
VARCHAR2 (25) NULL , Hobby
VARCHAR2 (20) NULL , Id_Card
VARCHAR2 (20) NULL , Hand_Phone
VARCHAR2 (6) NOT NULL , Res_Phone
VARCHAR2 (20) NOT NULL , Res_Zip
VARCHAR2 (20) NOT NULL , Res_City
VARCHAR2 (10) NULL , Res_Address
VARCHAR2 (10) NULL , Marital
VARCHAR2 (10) NULL , Citizen
VARCHAR2 (10) NULL , Religion
VARCHAR2 (20) NULL , Birth_Date DATE NULL , Birth_Place
transaksi informasi pegawai. Untuk mempermudahnya, akan dibuat sebuah table dengan nama Employee. Sebenarnya ada 2 table yang terhubung yaitu Location dan Level, tetapi belum diimplementasikan untuk kasus ini.
VARCHAR2 (20) ,
Start_Date DATE NOT NULL ,
SexVARCHAR2 (20) , Location_Id
VARCHAR2 (20) , Status
VARCHAR2 (20) , Company_Name
VARCHAR2 (20) , Dept_Name
VARCHAR2 (10) , Job_Title
VARCHAR2 (5) NOT NULL , Level_Id
VARCHAR2 (20) NOT NULL , Emp_Initial
CONSTRAINT Employee_ID PRIMARY KEY , Emp_Name
CREATE TABLE Employee ( Employee_ID NUMBER (10)
didesain harus diisi (NOT NULL) dan boleh kosong (NULL atau tidak ada sama sekali). Untuk lebih jelasnya dapat melihat SQL Statement untuk membuat table dibawah ini:
field-field yang telah
Table Employee akan dibuat dengan beberapa
VARCHAR2 (20) NULL ,
AD_Client_ID NUMBER (10) NOT NULL ,
AD_Org_ID NUMBER (10) NOT NULL , Cara Cepat Menerapkan ERP Menggunakan Compiere IsActive CHAR (1),
Created DATE NOT NULL ,
CreatedBy NUMBER (10) NOT NULL ,
Updated DATE NOT NULL ,
UpdatedBy NUMBER (10) NOT NULL
);Yang patut diperhatikan adalah AD_Client_
field terakhir yaitu
ID, AD_Org_ID, IsActive, Created, CreatedBy, Updated,
UpdatedBy . Ke- field ini adalah harus ada disetiap table yangdibuat untuk Compiere, tanpa ini semua table tidak dapat digunakan. Masukan semua SQL Statement diatas ke dalam sebuah SQL Editor, caranya membuat SQL file di Eclipse.
SQL Editor dan table Employee yang berhasil digenerate
Setelah SQL untuk membuat table telah diketik di SQL Editor, eksekusilah SQL tersebut, caranya dengan menekan icon orang
Seri Solusi Enterprise Open Source
berlari, tetapi jangan lupa untuk memilih koneksinya, untuk kasus
Employee
disini adalah Oracle. Sebuah table akan tergenerate dan untuk melihatnya dapat mendrilldown table Compiere di Database
Structure View.
Membuat Element, Window dan melink Table/Field
Table yang telah dibuat sebenarnya belum dapat digunakan, untuk itu diperlukan registrasi dan beberapa step menggenerate didalam Compiere, step pertama adalah dengan membuat Element, yaitu memaping database.
Element dapat diakses di menu System dibawah Application
Dictionary.
Menu Application Dictionary
Isilah DB Column Name dan Name di tab Element pada window
Element, rekamlah. Jangan lupa memasukan user maintened
di Entity Type, sehingga bilamana Compiere diupgrade semau informasi ini tidak terhapus. Cara Cepat Menerapkan ERP Menggunakan Compiere
Tab Element yang telah terisi informasi Employee
Step setelah membuat element adalah membuat Table dan Window,
step ini agak
ping-pong, artinya informasi diperlukan oleh keduanya tetapi dibuat tidak bisa bersamaan.
Seri Solusi Enterprise Open Source
Tip termudahnya adalah mengisi informasi di window Table terlebih dahulu, kemudian saat mengisi Window, klik kanan, pilih
Zoom, dan window “Windows, Tab and Field” akan muncul,
isilah, setelah selesai, kembali ke window “Table and Columns”, klik kanan lalu pilihlah window yang telah dibuat dalam kasus ini adalah Employee.
Window Employee baru
Bilamana semau proses telah selesai, sebuah hubungan Table dan Window akan terbentuk. Cara Cepat Menerapkan ERP Menggunakan Compiere
Table yang telah direferensikan dengan Employee
Employee
Step berikutnya adalah mendaftarkan table dan
field
kedalam Column dari window Table, caranya adalah dengan menekan tombol “Create Columns from DB”, maka sebuah proses pengisian informasi akan segera dilakukan, sebuah dialog box akan keluar untuk menjalankan proses ini.
Dialog pertanyaan pembuatan perpustakaan.
Bilamana proses berhasil sebuah dialog informasi akan keluar yang berisikan kolom yang berhasil dipindahkan.
Seri Solusi Enterprise Open Source
Daftar Field yang berhasil dimapping
Proses ini dapat dilakukan beberapa kali, dan bilamana kolom/ field yang digenerate sudah ada, maka dialog informasi hanya menampilkan table yang tergenerate saja. Kembalilah ke window Table and Columns, kemudian pilih tab Colum, maka semua Employee akan terisi ditab ini,
field-field
ini artinya proses pembuatan perpustakaan kolom table telah berhasil. Cara Cepat Menerapkan ERP Menggunakan Compiere
Informasi Field yang telah berhasil digenerate
Informasi pada tab Column sebenarnya berguna untuk memudahkan pemakai Compiere untuk mengetahui
field ini bermakna apa, karena
secara default Compiere hanya mengisi Name dan DB Column Name dengan isi yang sama, dan ini tidak mudah dimengerti oleh pemakai. Untuk itu rubahlah semua Name menjadi informasi yang lebih enak dibaca, dan tentu saja, jangan menggunakan huruf besar semua, sehingga window yang dibuat menjadi lebih formal.
Step berikutnya adalah meregistrasi window Employee ke menu, caranya dengan masuk ke System Rule pada menu Compiere.
Seri Solusi Enterprise Open Source
Menu System Rules
Setelah window Menu muncul, buatlah Menu baru dengan menekan
icon New. Isilah Name dengan nama menu yang diinginkan, Action
dengan Window, dan secara otomatis sebuah
field isian Window
akan muncul, pilihlah Employee, artinya menu ini akan mengakses window Employee yang telah dibuat sebelumnya. Rekamlah setelahnya.
Window Menu untuk membuat menu di Compiere Cara Cepat Menerapkan ERP Menggunakan Compiere
Secara default, menu akan dibuat menjadi top branch, untuk itu pindahkanlah dengan cara mengklik kanan pada node yang ingin dipindahkan, pilih Move Item untuk memindahkan, dan pilih Insert Item here untuk lokasi tujuannya.
Merapikan Window Window datang dengan 2 kolom layout
, dan memiliki fitur yang memungkinkan untuk mengurutkan urutan pengisian data bukan berdasarkan urutan dari table Employee yang dibuat, tetapi sesuai dengan keinginan.
Untuk mengurutkan pengisian, masuklah ke tab Field Sequence, pada window Employee yang telah dibuat. Kemudian urutkan semua
field sesuai dengan urutannya, caranya dengan mengurutkan menggunakan mouse di sequence.
Seri Solusi Enterprise Open Source
Field Sequence untuk mengurutkan Field
Setelah itu untuk window Employee akan tetap berlayout satu baris, untuk itu masuklah ke tab Field, dan isilah Same Line secara
zig- zag, dan dimulai dengan tidak terpilih diawalnya.
Setting Field agar mendukung format 2 kolom
Bilamana telah selesai, coba klik node Employee di menu Compiere, dan sebuah window Employee yang cantik akan muncul Cara Cepat Menerapkan ERP Menggunakan Compiere
Window Employee
Semua window dalam Compiere memiliki beberapa pewarnaan, yaitu merah artinya harus diisi, dan hubungan harus diisi sebenarnya terlink dengan databasenya, bilamana NOT NULL maka akan membuat isian menjadi berwarna merah.
Sedangkan abu-abu artinya field merupakan foreign key dari table lain, yaitu Location dan Level, yang mana belum diimplementasikan.
Seri Solusi Enterprise Open Source
Data Employee yang berhasil terekam
Bilamana semua informasi telah terekam, maka di status bar dari setiap window akan tertulis Record saved, artinya window telah merekam data. Ini juga mengartikan window yang telah dibuat adalah benar.
Coba pilih search, kemudian lihatlah, search form kosong, masuklah ke Advanced, kemudian tekan Ok, maka semua data yang terekam akan muncul dalam format grid. Cara Cepat Menerapkan ERP Menggunakan Compiere
Hasil pencarian data pegawai dalam Grid
Coba perhatikan dialog search dibawah ini, tab Find record memiliki isian Name, sedangkan kasus diatas tidak.
Dialog Search yang benar
Search didalam Compiere melink
field Name dan Description,
bilamana sebuah table memiliki
field Name dan Description, maka
dialog search akan otomatis ada, tetapi kasus Employee diatas,
nama pegawai sebenarnya ada, tetapi penulisannya adalah EMP_
Seri Solusi Enterprise Open Source
NAME , ini merupakan penamaan yang tidak salah, tetapi akibatnya find record tidak dapat dilakukan
Contoh diatas adalah pembuatan window satu tab, untuk aplikasi yang kompleks sebaiknya menggunakan tab yang lebih banyak. Setiap tab didalam window selalu saling berhubungan, informasi ini dapat dilakukan penghubungan dengan mengisi isian “Link Column” ditab “Tab” pada window “Window, Tab and Field”.