Wikiadmin: Created page with "==Introduction== Version 2.50 of Openbravo ERP represents a change in the way the software is structured. The introduction of that the community can develop new functions as d..."

2021-11-25T08:19:35Z

Created page with "==Introduction== Version 2.50 of Openbravo ERP represents a change in the way the software is structured. The introduction of that the community can develop new functions as d..."

New page

==Introduction==
Version 2.50 of Openbravo ERP represents a change in the way the software is structured. The introduction of that the community can develop new functions as discrete modules and make them available to the rest of the community quickly and easily. It also makes it easy to extend Openbravo ERP to suit the needs of your business. A module can be a simple as a particular report, or as sophisticated as a complete localization pack.

==About Modules==
There are three types of modules:
*Modules
*Packs
*Industry Templates
===Modules===
A module represents the most basic module. It is a container for:
*Application Dictionary components
*Software resources (e.g. .jar files)
*Reference data such as account trees

===Packs===
A pack is a collection of modules that work together to achieve a particular task, for example a localization pack which contains translations, chart of accounts and local taxes.

===Industry Templates===
An industry template is a collection of packs that work together to achieve a particular work area, containing all the functions, reference data and reports necessary for that work area. For example, an industry template for a distributor of frozen foods in Mexico could include:
*Translation of the Openbravo ERP into Mexican Spanish.
*The appropriate charts of accounts.
*Mexican taxes.
*Lists of of typical products, product categories and prices.

Industry templates are different from modules and packs because they are able to alter other modules and also the Openbravo ERP Core using a configuration script.

==Information for developers==
The [[:Category:Concepts#Modularity|Modularity]] section in the Developer's Guide contains information on how to create modules and make them available to the community.

==The Core module==

Openbravo ERP's core functionality is held in a central module, called Core. If you require a change to the application that affects the Core module, for example enabling an inactive menu, it is recommended that you create a separate industry template module to hold this kind of configuration change. Creating a separate configuration module has the following advantages:
* If you upgrade Openbravo ERP, the changes you make are not overwritten.
* You can share the configuration changes with other instances of Openbravo ERP, just as with any other module.

There are two ways to create a configuration module:

* By putting Openbravo ERP into configuration mode. In configuration mode, Openbravo ERP creates the industry template automatically to house your changes. If you do not plan to share your customizations this is the recommended method. To enable configuration mode, select the option in '''General Setup > Application > System Info'''
* Manually, by creating an industry template. If you plan to share your customizations within your own organization or with the community, this is the recommended method. The name of the industry template should follow the Java naming standard, for example ''org.myname.myconfiguration''.

==Installing a module from the repository==
#Log into Openbravo ERP as System Administrator.
#From the Application menu, select '''General Setup > Application > Module Management'''. The Module Management Console displays.
#Select the '''Add Modules''' tab.
#To search for a particular module, enter your search terms and click '''Search'''. Alternatively, to view a full list of available modules, click '''View All'''.
#The list of modules appears. To find out more about each module, click '''View Details'''.
#For the module you want to install, click '''Install Now'''. A confirmation window appears with the details of your chosen module.
#To continue installing the module, click '''Continue'''. To abort the installation, click '''Cancel'''.
#The license agreement for the module appears. Select '''I accept all license agreements''' to accept the license agreement.
#Click '''Continue'''. A message appears when the installation is complete.
#Repeat the installation procedure for any further modules that are required.
#In '''General Setup > Application > Module Management''', select the '''Installed Modules''' tab. All the modules currently installed on the system appear in a list.
#Click '''Rebuild Now'''. The '''Apply Modules''' window appears, showing the progress of the rebuild.
#Click '''Rebuild now'''. A new window appears showing the rebuild in progress.
#When the rebuild is complete, you must choose an option for how to restart Openbravo ERP. You can choose from the following:
#*Restart the servelet container: restarts Tomcat and reloads the application.
#*Reload the context: reloads only the contexts that have changed.
#*Take no action: does not reload any part of the application. Select this option if you want to manually restart Openbravo ERP later.

==Installing a module from your local machine==
As well as installing modules from the central repository, you can also install modules directly from your own machine. For example, a developer in your organization could create a module and distribute the .obx file to other users via e-mail, rather than uploading it to the repository.
#Save the .obx file to a suitable location on your machine.
#From the Application menu, select '''General Setup > Application > Module Management'''.
#Select the '''Add Modules''' tab.
#Click '''Browse file system'''. The '''Install Module''' box is displayed.
#Click '''Browse'''.
#Navigate to the location of the .obx file you want to install, and select it.
#Click '''Continue'''. The confirmation window appears. If your chosen module is dependent on other modules, a message will list those additional modules which are required.
#Click '''Continue''' to begin installing the module. The License agreement window appears.
#The license agreement for the module appears. Select '''I accept all license agreements''' to accept the license agreement.
#Click '''Continue'''. A message appears when the installation is complete.
#In '''General Setup > Application > Module Management''', select the '''Installed Modules''' tab. All the modules currently installed on the system appear in a list.
#Click '''Rebuild Now'''. The '''Apply Modules''' window appears, showing the progress of the rebuild.
#When the rebuilding process is complete, log out of Openbravo ERP.
#Access the Tomcat server management page. If you are working on the machine where Openbravo ERP is installed, you can access the page by typing ''http:localhost:8080/manager/html'' into your web browser. If you are accessing Openbravo ERP from a remote location or through a virtual machine, use the URL ''http:IP_address/manager/html'', where ''IP_address'' is the IP address you use to access Openbravo ERP. A password box is displayed.
#Type the username and password for the Tomcat server. By default these are:
#*Username:admin
#*Password:openbravo
#Scroll down to the Openbravo context and click '''Reload'''.
#Click '''OK''' to confirm that you want to reload the context.
#Start Openbravo ERP and log in in the usual way.

==Updating Modules==
In the Module Management Console, you can check whether updates are available for the modules installed on your system.
#From the Application menu, select '''General Setup > Application > Module Management'''.
#Click '''Scan for Updates'''.
#If updates are available, the "updates available" message is displayed, and each module that has an applicable update is marked with the update symbol.
#Select the modules you want to update.
# Click Install Updates Now. A confirmation window appears with the details of your chosen module.
# To continue installing the module, click '''Continue'''. To abort the updates, click Cancel.
# The license agreement for the module update appears. Select '''I accept all license agreements''' to accept the license agreement.
# Click '''Continue'''. A message appears if the update has been successful.
#In '''General Setup > Application > Module Management''', select the '''Installed Modules''' tab. All the modules currently installed on the system appear in a list.
#Click '''Rebuild Now'''. The '''Apply Modules''' window appears, showing the progress of the rebuild.
#When the rebuilding process is complete, log out of Openbravo ERP.
#Access the Tomcat server management page. If you are working on the machine where Openbravo ERP is installed, you can access the page by typing ''http:localhost:8080/manager/html'' into your web browser. If you are accessing Openbravo ERP from a remote location or through a virtual machine, use the URL ''http:IP_address/manager/html'', where ''IP_address'' is the IP address you use to access Openbravo ERP. A password box is displayed.
#Type the username and password for the Tomcat server. By default these are:
#*Username:admin
#*Password:openbravo
#Scroll down to the Openbravo context and click '''Reload'''.
#Click '''OK''' to confirm that you want to reload the context.
#Start Openbravo ERP and log in in the usual way.

==Uninstalling Modules==
If you no longer require a particular module you can uninstall it.
#From the Application menu, select '''General Setup > Application > Module Management'''.
#Select the module you want to uninstall.
#Click '''Uninstall selected'''.
#When the uninstall process is complete, click '''Rebuild Now'''. The Apply Modules window appears, showing the progress of the rebuild.
# When the rebuilding process is complete, log out of Openbravo ERP.
# Access the Tomcat server management page. If you are working on the machine where Openbravo ERP is installed, you can access the page by typing http:localhost:8080/manager/html into your web browser. If you are accessing Openbravo ERP from a remote location or through a virtual machine, use the URL http:IP_address/manager/html, where IP_address is the IP address you use to access Openbravo ERP. A password box is displayed.
# Type the username and password for the Tomcat server. By default these are:
#* Username:admin
#* Password:openbravo
# Scroll down to the Openbravo context and click '''Reload'''.
# Click '''OK''' to confirm that you want to reload the context.
# Start Openbravo ERP and log in in the usual way.

==Reference data at client and organization level==
Reference data modules are a convenient way to load reference data into Openbravo ERP. Reference data is data such as accounting structures, reports, product lists or price lists.
You can apply reference data at client or organization level, so, for example, if a client has two organizations in two different regions, you can apply the appropriate regional accounting structures to each organization.
===Applying reference data at client level===
#Install the reference data module you want to apply.
#From the Application menu, select '''Application > Client > Initial Client Setup'''.
#In the '''Reference Data''' section, a list of available reference data modules appears as a list.
#Select the reference data you want to apply to the Client.
#Click '''Save'''.

===Applying reference data at organization level===
#Install the reference data module you want to apply.
#From the Application menu, select '''Application > Enterprise > Organization > Initial Organization Setup'''.
#In the '''Reference Data''' section, a list of available reference data modules appears as a list.
#Select the reference data you want to apply to the organization.
#Click '''Save'''.

Modularity - Revision history

Wikiadmin: Created page with "==Introduction== Version 2.50 of Openbravo ERP represents a change in the way the software is structured. The introduction of that the community can develop new functions as d..."