Archive for ‘Uncategorized’

July 8, 2012

How to quickly setup a background process in Openbravo ERP

Sysfore Technologies

Introduction

Background Processes are processes that are executed without the direct action of the user. Different rules can be set to schedule when the process is executed. This article discusses about the Openbravo infrastructure for Background Processes – how to create, define, schedule and monitor Background Processes.

Develop a DAL background process

Consider that this is a java class implementing the business logic and that we are demonstrating how a background process is developed. Use the new Data Access Layer which provides mid-tier POJOs through which we can manipulate database tables. If this method is used, your background java class must extend the DalBaseProcess class and implement the doExecute method that performs your task. As a side note: in this how-to we will show how a java process can be implemented as a background process. A java process can however also be called directly from the user interface and have a user interface which allows entering parameters.

Definition within the application dictionary

Background processes are defined within the Application Dictionary || Report and Process window. Use the System Administrator role to create a new record as indicated below in the diagram:

DAL based background process setup in the application dictionary

The following fields are vital for the definition of a background process:

  • Module – your custom module that this new background process will belong to; note that this will consequently indicate the location on the hard drive and the package it must belong to
  • Search Key – unique identifier of the process; a good practice is to use the class name
  • Name – a user friendly name of the process
  • UI Pattern – should be set to Manual since Openbravo ERP does not need to generate any UI windows
  • Background – indicates that this process is a background process which consequently also displays the Java Class Name field
  • Java Class Name – the full specification of the class name including the package (this package must follow the package structure of your module specified above)

Defining a Background Process

Background Processes are defined in the window General Setup || Process Scheduling || Process Request. Firstly, in the field Process, select the process to execute and in the field Timing, time to execute.

Depending on Timing selected, more fields are required to be defined.

The timing frequency is of three types:

Run Immediately

This timing option will execute the Background Process the time at the moment the button to schedule the process is pressed. After it has been scheduled, it can be rescheduled as many times as needed.

This option is very similar to executing a process from a menu option. The difference is that when scheduling a Run Immediately Background Process, there will not be any pop-up that indicates when the execution finished and instead it will register its execution in the Process Monitor.

Run Later

This option is similar to the previous option. In this case the Background Process will be executed only one time in one moment in the future.

The moment when the Background Process will be executed is defined in the fields Start Date and End Date.

Schedule

This is the most versatile option that allows executing a Background Process periodically. These are the fields used to define the schedule plan of a Background Process:

  • Start Date and Start Time: Defines the moment when the schedule plan for this Background Process will start
  • Frequency: Defines the frequency to execute the Background Process. It can be Every n seconds, Every n minutes, Hourly, Daily, Weekly, Monthly, or Cron expression. Depending on the option selected you can define the specific details for each frequency option

Finish Date and Finish Time: These fields can be defined only when the option Finished is selected. And it defines when to stop the schedule plan for this Background Process

Grid view of Background process defined.

Schedule and Unschedule a Background Process

After the Background Process has been completely defined it can be scheduled pressing the button Schedule Process. When a process is scheduled, it will be executed according to the Timing options selected, and every execution will be registered in the Process Monitor.

To stop future executions of a Background Process select the option Unschedule Process. After a Background Process has been unscheduled it can be scheduled again in any moment pressing the button Reschedule Process.

Sample Background process

Monitoring executions of Background Processes

All the executions of Background Processes can be monitored in General Setup || Process Scheduling || Process Monitor.

Process Monitor Window

In this window there is one entry for each Background Process execution and the information of each execution. The most important fields are:

  • Process: The Process executed
  • Start Time, End Time and Duration: When the execution started, when finished and the time it took to complete
  • Status: The final result of the execution of the Process
  • Process Log: The information logged during the execution of the Process. For example if the Status of the execution is Error, here in the Process Log the reason for the error can be detected
March 8, 2012

Data Access Layer Architecture in Openbravo


– Narayanaswamy, Sysfore

1 Introduction

The goal of the DAL development is to strengthen the middle-tier in the application, i.e. to implement business logic in Java. The DAL provides the application developer with the following functionality:

  • Type safe querying and retrieval of business objects from the database.
  • A convenient API to update or create new data in the database.
  • A type safe interface to update information of a business object, increased productivity by making the properties of a business object directly visible through getters and setters (in the IDE).
  • Transaction and context handling.
  • Security and validation checking.
  • Automatically maps new entries in the Application Dictionary to database tables and columns.
  • Generates Java class business objects (and their associations) on the basis of the Application Dictionary model.

The DAL consists of a development-time and runtime part. The development-time part takes care of generating Java business object classes. The runtime part takes care of mapping Java classes to the database and supporting functionality such as security and validation.

2 DAL Architecture

The Data Access Layer (DAL) provides an API to store, query and remove business objects from the database.

The DAL offers three main services to instantiate, create and query Openbravo ERP business objects: OBDal, OBCriteria and OBProvider. The service classes can all be found in the org.openbravo.dal.service package.

3 OBDal

The OBDal instance (available through OBDal.getInstance()) is the main entrance point for retrieving and storing business objects in the database in a validated and secure way. It provides the following functions:

  • save: stores a new business object in the database or an existing business object is updated. For existing business object it is not required to call this method as Hibernate does automatic dirty checking.
  • get: retrieves a single business object using its id. There are two versions: one using the class name (of the generated business object) and one using the entity name.
  • remove: delete a business object from the database, the actual database delete is done at commit time.
  • create OBCriteria: OBCriteria objects are used for querying.
  • commitAndClose and rollbackAndClose: these methods can be used to implement custom transaction handling. Normally this is done by the environment (Openbravo web container or Openbravo test).

The OBDal API makes extensive use of the OBCriteria and OBQuery classes to support querying.

4 OBCriteria

The OBCriteria class implements the Hibernate Criteria interface. It extends the standard Hibernate Criteria functionality for filtering on active, client and organization. In addition it offers convenience methods to set orderby and to perform count actions.

  • Summarizing, the OBCriteria object supports all Hibernate Criteria features:
  • Setting the where-clause of a filter using the Hibernate Criterion concept.
  • Setting paging parameters such as first row and maximum number of results.
  • Setting order by on the query.
  • Specifying joins for performance reasons.
  • Performing counts, average etc.

5 OBQuery

The OBQuery class is an extension of the Hibernate Query object. It extends the standard Hibernate Query functionality for filtering on active, client and organization.

The OBQuery object is created through the OBDal.createQuery method. The first argument of the createQuery is a class or an entity name, the second argument is the where-clause.

6 OBProvider

Openbravo business objects should not be instantiated directly using the new operator. Instead the OBProvider class should be used to create an instance of the required business object. The OBProvider is located in the org.openbravo.base.provider package and can be retrieved using the method OBProvider.getInstance(). The OBProvider offers methods to instantiate using a class name or using an entity name.

February 27, 2012

Sysfore named Openbravo Partner of the Year

Sysfore named Openbravo Partner of the Year

Openbravo Partner of the Year

Proud Moment For Sysfore: Sysfore named Openbravo Partner of the Year!

Leading Openbravo Partner, Sysfore Technologies awarded as the Partner of the Year 2011 – India

Bangalore, India – January 9, 2012: Sysfore Technologies, a specialist provider of business web solutions and IT Outsourcing services, has been named Partner of the Year 2011 (India) by Openbravo. Openbravo, the agile ERP company,announced the winners of its “Partner of the Year 2011” awards recognized for technical excellence in..[Click here to read the official announcement on our website]

February 27, 2012

Free Webinar on HR and Payroll Management

Human Resources and Payroll Management for Openbravo ERP:

Easily manage your company’s most valuable asset!

  • Date: Tuesday, 6 March 2012
  • Time: 9am CET
HR & Payroll for Openbravo ERP by Sysfore

HR & Payroll for Openbravo ERP by Sysfore

Is your growing business getting bogged down by tedious, manual processes for human resources and payroll? Smart companies know that as the business environment grows increasingly complex, their employees represent a sustainable source of competitive advantage. But, understandably, many hesitate to deploy a standalone HR system due to the cost and complexity.

The Human Resources & Payroll Management solution is a fully integrated, native solution for Openbravo, the leading open source ERP. Extremely simple and user-friendly, this solution helps you optimize your workforce, and assists in processing payroll. The HR & Payroll solution is cost-effective, and very easy to configure and further customize using standard Openbravo facilities.

Register now to join Openbravo and Sysfore, Gold Partner of Openbravo and author of the solution, on Tuesday March 6, to discover the benefits of easily managing all of this integrated functionality directly inside of the powerful Openbravo 3 ERP platform:

  • Employee information
  • Time & Attendance
  • Team management
  • Leave management
  • Work shifts
  • Payroll & Benefits
  • Standard and Custom Reports

Now is your chance to register to see this exciting new solution in action, interact with the experts, and get your questions answered!