Tạo mới một cửa sổ trong Openbravo ERP (How to develop a new window)

I. Giới thiệu:
 Mục tiêu của phần này là hướng dẫn cách tạo một cửa sổ người dùng mới trong OpenBravo. Trong cửa sổ này sẽ kết nối đến một bảng cơ sở dữ liệu mà ta đã tạo sẵn. Có mục đích thêm xóa sửa, cập nhật từ cửa sổ mới này xuống bảng dữ liệu mà ta thêm vào database Openbravo ERP
 
 Giả sử chúng ta sẽ phát triển một module nhân sự và cần một cửa sổ để cho phép người sử dụng nhập tiền lương của nhân viên. Ta cũng cần phải theo dõi mức lương của nhân viên để đưa ra những báo cáo cần lưu trữ. Mỗi bản ghi tiền lương cần phải có một trường " Valid From Date" cho biết thời điểm một mức lương cụ thể được tạo ra. Lưu ý rằng nhân viên phải thuộc hệ thống và được chứa trong bảng C_BPARTNER và chỉ định bởi các cột C_BPARTNER.ISMEPLOYEE. Vì vậy, chúng ta chỉ cần tạo một bảng cơ sở dữ liệu mà sẽ giữ tiền lương thực.
  Cho nên việc đầu tiên là tạo mới một bảng trong Openbravo, điều này đã hướng dẫn trong phần tạo bảng . Bây giờ chúng ta sẽ đi thẳng vào phần tạo mới một cửa sổ (Có thể gọi là một trang mới) trong Openbravo

II. Tạo một cửa sổ mới:

- Đăng nhập với quyền System Administrator --> Sau đó vào đường dẫn Application Dictionary || Windows, Tabs and Fields. Create a new record, sau đó bạn nhập các thông tin tương tự như sau:

Các trường dữ liệu trong cửa sổ trên (Để biết thêm thông tin bạn tham khảo AD_Window ):

• Name Defines the name that Openbravo ERP uses to recognize this window.
• Description Gives a small description of the table.
• Help/Comments Defines the text that is displayed in Help window.
• Window Type Defines some user interface specifics for a window:
• Maintain: is used for windows with few entries.
• Transaction: for transactional windows.
• The header tab's underlying table must contain the PROCESSED and UPDATED columns
• by default this window filters out old (n days – General Setup > Application > Session Preferences window setting) and processed documents.
• Query Only: for read-only windows that only enable viewing of data.

Save lưu thông tin và chuyển vào Tab Tab - Ở đây ta sẽ tạo ra một tab mới trong cửa sổ vừa tạo để hiển thị thông tin nhân viên --> Create a new record, và nhập thông tin như sau:

Các trường dữ liệu trong cửa sổ trên (Biết thêm thông tin xin tham khảo AD_Tab):

• Name Defines the name that Openbravo ERP uses to recognize this tab.
• Description Gives a small description of the table.
• Help/Comments Defines the text that is displayed in Help window.
• Table Specifies the table that the tab will show the data from.
• Table Level Defines the hierarchy of tabs, 0 being the highest level.
• UI Pattern This dropdown offers the following options:
• Standard - standard interface where multiple records can be added, viewed and edited
• Read Only - this option disables any editing/creating capabilities for any user within this tab
• Single Record - this option enforces a one-to-one relationship between a parent and a child tab, allowing the user to enter maximum one record in the tab
• SQL Where Clause By using this SQL filter, the user will never be able to see data that does not fit the criteria. In our case, we use it to display only business partners that are our employees.

- Nhấn nút Save và sau đó nhấn vào nút Copy Tab Fields để copy các trường từ tab chính của cửa sổ Business Partner vào cửa sổ mới của chúng ta. Chọn Business Partner-Business Partner và nhấn OK.
- Di chuyển tới Tab Field bạn sẽ thấy những trường bạn đã tạo. Bạn cũng có thể thay đổi các trường này ngay tại đây. Trong ví dụ của chúng ta, tôi sẽ không thay đổi gì cả.

- Bây giờ, quay trở lại tab Tab và tạo một record mới sẽ đại diện cho các tab con của tab Employee nơi mà tiền lương sẽ được quản lý:

- Nhấn nút Save
Bạn cần chắc chắn đã chọn:

• Table = HT_Salary
• Tab Level = 1

- Bằng cách nhấn vào Create Fields và xác nhận lại, Openbravo sẽ tự động chèn các cột của bảng được chọn vào các trường tab Salary.
- Sau đó chuyển tới tab Field Sequence để xác định các lĩnh vực mà sẽ được hiển thị (bên phải) và không được hiển thị (bên trái) và thứ tự của những hiển thị (mũi tên lên và xuống):

Sau khi điều chỉnh hợp lý bạn nhấn nút Save

 Đối với Openbravo để tạo ra các liên kết tới các thành phần bảng, hệ thống cần phải biết được cửa sổ đại diện cho bảng, nơi một thành phần nhất định được chứa. Trong ví dụ này, cửa sổ Employee Salary được sử dụng để quản lý nội dung của các bảng cơ sở dữ liệu HT_Salary. Do đó, tất cả record tiền lương cần phải được hiển thị trong cửa sổ đó. Để chỉ ra điều đó, đi đến Application Dictionary || Tables and Columns, tìm bảng EP_Salary và thiết lập các cửa sổ như dưới đây:

(Thực ra là bạn chỉ cần chỉnh lại trường Windows để chọn cửa sổ bạn mới tạo ra)


III. Tạo các thành phần Menu

 Một thành phần Menu là yêu cầu cho người dùng có thể gọi cửa sổ ứng dụng mới mà chúng ta vừa tạo.
 - Đăng nhập bằng quyền System Administrator và đi tới General Setup || Application || Menu và create a new record, sau đó bạn nhập các thông tin như sau:

Các trường thông tin của cửa sổ trên (Bạn có thể tham khảo thêm tại AD_Menu ):

• Name Defines the name that Openbravo ERP uses to recognize this menu item.
• Description Gives a small description of the table.
• Summary level Defines a folder containing menu items (windows, processes, reports and so on).
• Action Defines the type of menu item.
• URL If Action is External link or Internal link, defines the URL to be linked.
• Special Form If Action is Form, defines the form to be linked.
• Process If Action is Process, defines the process to be launched.
• Report If Action is Report, defines the report to be linked.
• OS Task If Action is Task, defines the operating task to be launched.
• Window If Action is Window, defines the window to be linked.
• Workflow If Action is Workflow, defines the workflow to be linked.

Nhấn nút Save và sau đó Click vào biểu tượng Tree  --> Tại đây bạn có thể kéo và thả các thành phần của menu Employee Salary tới nhóm menu khác. Sau khi thực hiện xong bạn đóng cừa sổ này lại.

IV. Biên dịch ứng dụng với cửa sổ mới

 Cuối cùng, ứng dụng cần phải được biên dịch lại để tạo ra code cửa sổ mới và triển khai nó đến Tomcat. Nếu sử dụng Eclipse, dùng lệnh ant eclipse.compile và nhập Employee Salary vào hộp thoại. Nếu dùng môi trường dòng lệnh với Openbravo, sử dụng:  ant compile.development -Dtab='Employee Salary'

  Lưu ý: Khi quá trình biên dịch kết thúc, khởi động lại Apache Tomcat server. Trong windows, tốt nhất là Stop Tomcat trước khi chạy lệnh build và start lại từ cửa sổ khóa file nhất định. Nếu bạn dùng lệnh ant compile.development -Dtab='Employee Salary'  không thành công bạn có thể dùng lệnh ant compile.development
  Xem thêm tại Build Tasks.

 Quá trình biên dịch thành công, bạn khởi động lại Tomcat và đăng nhập lại vào Openbravo để xem kết quả!!!

----------------------------------------------------------------------------------------------------------
Tham khảo:
http://wiki.openbravo.com/wiki/ERP/2.50/Developers_Guide/How_to_develop_a_new_window