Goodwill Consulting
ADempiere How To Series
Membuat Window Baru di ADempiere Oleh: Armen Rizal ADempiere mengizinkan kita untuk menambahkan sebuah Window baru ke dalam sistem. Sebuah Window biasanya terdiri atas satu atau lebih Tab yang dapat tersusun secara hierarkikal, dan Tab terdiri atas satu atau lebih Field. Sebenarnya sebuah Tab mewakili sebuah tabel dalam database dan Field mewakili kolom-kolom yang terdapat di dalamnya. Ok. Untuk membuktikannya, sekarang marilah kita mencobanya langsung. Ada dua cara dalam pembuatan tabel dan kolom baru. Cara pertama anda buat terlebih dahulu di dalam database anda dengan perintah SQL dan kemudian anda tarik definisinya ke dalam Application Dictionary ADempiere. Cara kedua adalah langsung membuat definisi tabel dan kolom baru kita di dalam Application Dictionary ADempiere dan sesudahnya kita sinkronisasi setiap kolom terhadap database kita. 1. Membuat database table Langkah pertama adalah membuat tabel baru di database. Jika anda hendak memakai cara kedua, maka anda dapat melewati langkah ini. Biasakanlah untuk memberi awalan Z_ untuk setiap tabel yang kita buat sendiri (bagian dari kustomisasi). Misalnya Z_MyWindow. Harap diingat bahwa setiap penamaan dalam ADempiere adalah case-sensitive. Contoh perintah SQL untuk membuat tabel baru adalah sebagai berikut: Oracle: CREATE TABLE Z_MyWindow Z_MyWindow_ID AD_Client_ID AD_Org_ID IsActive Created CreatedBy Updated UpdatedBy First_Name Last_Name Address Phone_Number );
( NUMBER(10) NOT NULL, NUMBER(10) NOT NULL, NUMBER(10) NOT NULL, CHAR(1 BYTE) DEFAULT 'Y' NOT NULL, DATE DEFAULT SYSDATE NOT NULL, NUMBER(10) NOT NULL, DATE DEFAULT SYSDATE NOT NULL, NUMBER(10) NOT NULL, VARCHAR2(20), VARCHAR2(20), VARCHAR2(100), VARCHAR2(15)
Goodwill Consulting
ADempiere How To Series
PostreSQL: CREATE TABLE Z_MyWindow Z_MyWindow_ID AD_Client_ID AD_Org_ID IsActive 'Y'::bpchar, Created DEFAULT now(), CreatedBy Updated DEFAULT now(), UpdatedBy First_Name Last_Name Address Phone_Number );
( numeric(10) NOT NULL, numeric(10) NOT NULL, numeric(10) NOT NULL, character(1) NOT NULL DEFAULT timestamp without time zone NOT NULL numeric (10) NOT NULL, timestamp without time zone NOT NULL numeric(10) NOT NULL, character varying(20), character varying(20), character varying(100), character varying(15)
Yang perlu diperhatikan adalah ketika membuat tabel baru, pastikan anda mempunyai kolom-kolom mandatory di bawah ini:
_ID AD_Client_ID AD_Org_ID IsActive Created CreatedBy Updated UpdatedBy
NUMBER(10) NUMBER(10) NUMBER(10) CHAR(1) DATE NUMBER(10) DATE NUMBER(10)
Column ID adalah kolom identifier yang akan bertindak sebagai primary key. Ketiadaan kolom-kolom di atas dapat mengakibatkan kegagalan kelas Persistency Object (PO) ADempiere dalam mengenali tabel kita. 2. Membuat Element di Application Dictionary ADempiere bekerja berdasarkan informasi yang terkandung di dalam Application Dictionary. Oleh sebab itu supaya tabel kita ini dapat dikenali oleh ADempiere maka kita perlu mendaftarkannya ke dalam Application Dictionary ADempiere. Log on sebagai SuperUser/System. Buka window Element yang ada di bawah menu Application Dictionary. Sekarang buatlah sebuah Record baru. Isilah field-field mandatory di bawah ini: DB Column Name: Name: Print Text: Description
First_Name First Name First Name The first name
Goodwill Consulting
ADempiere How To Series
Isilah Client dengan System dan Entity Type dengan User Maintained. Jika anda tidak memilih User Maintained maka ketika migrasi ke versi berikutnya, kustomisasi anda tersebut akan tertimpa. Ulangi hal yang sama untuk Last_Name, Address, Phone_Number dan Z_MyWindow_ID. 3. Membuat Table dan Column Sekarang bukalah window Table and Column. Buatlah record baru dan isilah field-field seperti berikut: Name: Description: DB Table Name: Data Access Level: Entity Type:
Z_MyWindow Table of my new window Z_MyWindow Client+Organization User Maintained
Jika anda sudah melakukan langkah pertama, anda tinggal meng-klik tombol Create Columns from DB untuk menarik definisi kolom-kolom anda ke dalam ADempiere. Setelah itu pindah ke Column tab. Kita akan membuat kolom Z_MyWindow_ID terlebih dahulu karena ini adalah kolom identifier kita jadi agak sedikit berbeda penanganannya daripada kolom-kolom sisanya. Isilah field-field sebagai berikut: DB Column Name: System Element: Name: Reference: Entity Type: Mandatory: Key Column: Identifier:
Z_MyWindow_ID Z_MyWindow_ID Z_MyWindow_ID TableDir User Maintained Y Y Y
Jika anda melewati langkah pertama, maka anda perlu untuk mensinkronisasikan kolom tersebut ke dalam database kita. Klik tombol Sychronize Columns. Lakukan ini terhadap masing-masing kolom yang kita buat. Kolom berikutnya yang kita buat adalah kolom-kolom wajib: DB Column Name: System Element: Name: Reference: Dynamic Validation: Entity Type:
AD_Client_ID AD_Client_ID Client Table AD_Client Trx Security validation User Maintained
Goodwill Consulting
ADempiere How To Series
Mandatory:
Y
DB Column Name: System Element: Name: Reference: Dynamic Validation: Entity Type: Mandatory:
AD_Org_ID AD_Org_ID Organization Table AD_Org Trx Security Validation User Maintained Y
DB Column Name: System Element: Name: Reference: Entity Type: Mandatory: Updatable:
Created Created Created DateTime User Maintained Y N
DB Column Name: System Element: Name: Reference: Reference Key: Entity Type: Mandatory: Updatable:
CreatedBy CreatedBy Created By Table AD_User User Maintained Y N
DB Column Name: System Element: Name: Reference: Entity Type: Mandatory: Updatable:
Updated Updated Updated DateTime User Maintained Y N
DB Column Name: System Element: Name: Reference: Reference Key: Entity Type: Mandatory:
UpdatedBy UpdatedBy UpdatedBy Table AD_User User Maintained Y
Goodwill Consulting Updatable:
ADempiere How To Series N
Sedangkan untuk kolom lainnya, buatlah seperti ini: DB Column Name: System Element: Name: Length: Reference: Entity Type:
First_Name First_Name First Name 20 String User Maintained
4. Membuat Window, Tab & Field Langkah selanjutnya adalah bukalah window Window, Tab & Field. Buat sebuah window baru dan namakan MyWindow sebagai nama window baru tersebut. Pastikan WindowType adalah Maintain dan Entity Type adalahUser Maintained. Klik Tab dan isilah field-field mandatory seperti di bawah ini: Name: Table: Entity Type:
MyWindow XX_MyWindow User Maintained
Klik tombol Create Fields untuk menarik semua kolom-kolom yang sudah dibuat dalam langkah sebelumnya. Hasilnya dapat anda lihat pada tab Field. Anda dapat menambahkan pengaturan seperti kolom mana saja yang mau ditampilkan, posisi kolom saat ditampilkan, menambahkan display logic, dan sebagainya. Setelah selesai, tutuplah window tersebut. Sekarang bukalah kembali window Table and Column karena kita perlu untuk menset tabel kita untuk merujuk ke window yang barusan kita buat. Buka kembali tabel kita Z_MyWindow dan masukan MyWindow sebagai Windownya. 5. Menambahkan ke menu Langkah terakhir sebelum bisa digunakan, kita harus menambahkan Window baru kita ini ke dalam menu ADempiere. Di bawah General Rules|System Rules, bukalah window Menu. Buatlah sebuah menu baru. Name: Entity Type: Action: Window:
MyWindow User Maintained Window MyWindow
Goodwill Consulting
ADempiere How To Series
Maka selesailah sudah window baru kita ini. Selamat berkreasi!
Goodwill Consulting is an open source solution provider and pioneering open source ERP implementation in Indonesia. Goodwill Consulting is an active ADempiere contributor and currently sponsoring ADempiere Indonesia localization project. For further information, you can visit www.goodwill.co.id
