Wikiadmin: Created page with "== Introduction == Application elements (windows, tabs and Datab..."

2018-10-14T13:50:56Z

Created page with "== Introduction == Application elements (windows, tabs and Datab..."

New page

== Introduction ==
Application elements ([[Database_Model/org.openbravo.model.ad.ui/AD_Window |windows]], [[Database_Model/org.openbravo.model.ad.ui/AD_Tab |tabs]] and [[Database_Model/org.openbravo.model.ad.ui/AD_Field |fields]]) are liable to change repeatedly during the development or maintenance phases of a project. Openbravo ERP is able to cope with these changes because its architecture is suited to iterative
development. The definitions of all generated Windows, tabs and fields are stored as metadata in the Application Dictionary (AD).

Changing the window of an existing application is a simple process of changing the AD definition.

When using the Openbravo 3 UI this is all that is needed, the changes can be seem immediately when switching role and then opening the changed window again.

When using classic Window additionally a compile step is needed as it was during the Openbravo 2.50 cycle.

This HowTo explains how to modify existing elements of a window. If only new elements (like new fields) should be added to a window the use of a Template (as explained here) is not needed. Instead those new elements can just be added using a normal module as explain in the other HowTo on [[How_to_add_a_field_to_a_Window_Tab |How to add a field to a Window Tab]].

== Objective ==

The objective of this how-to is to illustrate how to make changes to existing generated windows in terms of appearance and behavior. The window used in the example is the Physical Inventory window and the changes illustrated will be:

* Hide a field
* Re-sequence the layout

Physical Inventory is a window that belongs to the Openbravo ERP core module. It comprises of:

* 1 Window - Physical Inventory.
* 2 Tabs - Header and Lines.
* A Header Tab has 19 Fields 10 of which are displayed (A few are displayed conditionally)

Before any changes the header tabs has the following appearance:

[[Image:HowtoChangeExistingWindow1.png|center]]

To customize these window in a Modularity Context a new module of Type '''Template'''/'''Industry Template''' is needed.

If these changes are just planned as local customization then there's an easy way of creating such a module. Navigating to '''General Setup || Application || System Info'' and marking the '''Customization Allowed''' CheckBox automatically creates a new module of type Template which can be used directly.

If the changes are planned to be published then a new module needs to be created and its ''Type'' set to ''Template''. This new template needs to have dependency added to it on all other modules which contain elements which are to be customized. In this HowTo this is only a dependency on the ''Core'' module as the ''Physical Inventory'' window is defined there.

== Changing the window ==

Navigate to the ''Application Dictionary || Windows, Tabs and Fields'' window and select the record for ''Physical Inventory''.

In the ''Fields'' tab we can now do the changes needed to adapt the layout as wanted:

* ''Description'' field, unmark the ''Displayed'' checkbox to hide the field from the tab.
* ''Organization'' field, change sequence number to ''45'' and mark the ''Start in new line'' checkbox. This moves the field below all other normally displayed.

For testing the changed layout switch away from the ''System Administrator'' role to i.e. the ''F&B International Group Admin'' role and open the ''Physical Inventory'' window again. As the instance contains our module marked as ''InDevelopment'' the window layout is reloaded each time the window is opened we can be the changed layout immediate as seen below:

[[Image:HowtoChangeExistingWindow2.png|center]]

To apply the same layout changes to the window in ''classic UI mode'' the windows needs to be recompiled, the changes deployed to tomcat and tomcat restarted. The compile & deploy step can be done by using ''ant smartbuild'' which will recompile all changed windows and deploy the changes.

== Exporting the changes ==

The final step is to export the changes into the module so they are persisted. When exporting changes into a template is it '''very important''' that '''only''' the '''template is in development''' and the module which contains the changed object (i.e. window) is not.

After ensuring that the export of the changes consists of the following two steps:

# ''ant export.database'', same steps as for any other module
# ''ant export.config.script'', analyses the changes done and creates a special file ''configScript.xml'' in the module to contain them.

This concludes this HowTo. Further technical information on ''Template'' and the ''Configuration Script'' they contain can be found in [[How_To_Create_a_Configuration_Script | this]] document.

[[Category:HowTo]]

How to change an existing Window - Revision history

Wikiadmin: Created page with "== Introduction == Application elements (windows, tabs and Datab..."