Apache OfBiz Cookbook

Apache OfBiz Cookbook

Overview of this book

Apache Open For Business (OFBiz) is an enterprise resource planning (ERP) system that provides a common data model and an extensive set of business processes. But without proper guidance on developing performance-critical applications, it is easy to make the wrong design and technology decisions. The power and promise of Apache OFBiz is comprehensively revealed in a collection of self-contained, quick, practical recipes in this Cookbook. This book covers a range of topics from initial system setup to web application and HTML page creation, Java development, and data maintenance tasks. Focusing on a series of the most commonly performed OFBiz tasks, it provides clear, cogent, and easy-to-follow instructions designed to make the most of your OFBiz experience. Let this book be your guide to enhancing your OFBiz productivity by saving you valuable time. Written specifically to give clear and straightforward answers to the most commonly asked OFBiz questions, this compendium of OFBiz recipes will show you everything you need to know to get things done in OFBiz. Whether you are new to OFBiz or an old pro, you are sure to find many useful hints and handy tips here. Topics range from getting started to configuration and system setup, security and database management through the final stages of developing and testing new OFBiz applications.

Apache OFBiz Cookbook

Credits

About the Author

About the Reviewers

Preface

Free Chapter

Getting Started

Introduction

Getting the project code

Getting code from the Subversion repository

Fixing IP port collision errors

The JAVA_HOME setting

"Class Not Found" errors

Installation verification

SSL verification

Running JUnit tests

Locating an OFBiz Component

Locating an OFBiz Application

Java Development

Introduction

Java runtime CLASSPATH

Java compile time CLASSPATH

Naming conventions

Writing OFBiz Java Events

Writing OFBiz Java Services

Debugging using the logfile

Calling OFBiz Services from a Java program

Getting and validating request parameters (Events)

Getting and validating request parameters (Services)

Managing error messages

Using Java properties files

Sending e-mail from an OFBiz Event or Service

Handling XML files

The User Interface

Introduction

Creating HTML web pages

Adding actions to Screen widgets

HTML markup in Screen widgets

CSS styling in Screen widgets

Platform-specific widgets

OFBiz Tree widgets

OFBiz Menu widgets

OFBiz Form widgets

Creating web pages using FreeMarker

Passing Screen widget parameters to FreeMarker

Calling Java methods from FreeMarker

Forcing FreeMarker to render HTML markup

Uploading files in FreeMarker forms

OFBiz Services

Introduction

Managing existing OFBiz Services

Calling a Service from an HTML form

Calling asynchronous Services from HTML forms

Calling a Service many times from an HTML form

Creating a new Service definition file

Creating a new Service definition

Implementing Services

Defining Service attributes (INPUT/OUTPUT)

Service Event Condition Actions

Service groups

Handling Service errors

Writing Groovy Services

Mail Event Condition Actions

Entity Event Condition Actions

The OFBiz Entity Engine

Introduction

Changing the default database

Connecting to a remote database

Connecting to multiple databases

Creating entity groups

Disabling automatic database checks

Mapping database data types

Creating a new entity model

Modifying an existing entity model

Building a view-entity

OFBiz Security

Introduction

Securing communications ports

Disabling demonstration user accounts

Protecting OFBiz web pages

Creating user accounts

Protecting applications using security groups

Protecting views ("Tarpitting")

Retrieving forgotten passwords

Changing your password

Adding or changing SSL certificates

OFBiz single sign-on and the external login key

WebTools

Introduction

Cache maintenance

Changing debug settings

Exporting database data to XML documents

Loading database(s) from XML documents

Managing internationalization labels

Using the SQL processor

Exploring the entity reference tool

Viewing OFBiz usage statistics

Uncovering artifact information

Working with temporal expressions

Web Services

Introduction

Requesting web services using URL parameters

Requesting web services using an HttpClient

Creating HttpClients and passing XML documents

Creating XML-RPC web service clients

Becoming an XML-RPC web service provider

OFBiz SOAP messaging clients

Generating a WSDL document

Creating SOAP-compliant web services

OFBiz Tips and Tricks

Introduction

Fixing Java memory allocation errors

Reloading OFBiz seed and demo data

Creating new seed data files

Changing the administrative user's password

Creating a new administrative user

Getting the OFBiz version number

Building an OFBiz instance

Building a single OFBiz Component

Creating a new OFBiz Component or Application

Creating a FreeMarker transform

Preparing data using Groovy

Pop-up new browser windows

Installing an OFBiz Visual Theme

Creating an OFBiz Visual Theme

Entity Engine by Example

Introduction

Putting it all together with a data model example

Reading data from an OFBiz data source

Working with large result sets (EntityListIterator)

Removing data from the database (Java)

Writing data to the database (Java)

Using the automatic sequence generator

EntityUtil

EntityOperator reference

Customer Reviews

5 star

4 star

3 star

2 star

1 star

Running JUnit tests

Beyond simple "is it running ok?" types of tests, OFBiz comes with many JUnit tests that you can run. JUnit exercises very specific processing logic within OFBiz, and success or failure of any particular JUnit test is not an indication of OFBiz overall health.

Getting ready

The following must be performed first of all:

1. If OFBiz is running, shut it down by running the shutdown script provided or by killing the Java process from the command line.
2. Navigate to the OFBiz install directory.

How to do it...

JUnit tests can be run in the following way:

1. Open a command line in the OFBiz install directory.
2. Run the following ANT command to start all available JUnit tests, ant run-tests
3. Observe the results by reviewing the OFBiz ofbiz.log logfile located in the ~runtime/logs directory or the output on the command line from which the JUnit test command was invoked.

How it works...

Out-of-the-box OFBiz comes complete with many JUnit test scenarios embedded within the code base. The provided ANT target directives, when invoked, run through all available tests, redirecting results to the primary OFBiz logfile located in the ~runtime/logs/ofbiz.log file.

There's more...

JUnit test results are intermixed with standard logfile text. A sample of what you may expect to see after running all tests from the command line is extracted from the OFBiz logfile (~runtime/logs/ofbiz.log) and shown here:

Apache OfBiz Cookbook

Apache OfBiz Cookbook

Overview of this book

Related Content you might be interested in

Current Title:

Apache OfBiz Cookbook

Running JUnit tests

Getting ready

How to do it...

How it works...

There's more...