ADempiere 3.6 Cookbook

Table of Contents

ADempiere 3.6 Cookbook

Credits

About the Author

About the Reviewers

www.PacktPub.com

Support files, eBooks, discount offers, and more

Why Subscribe?

Free Access for Packt account holders

Preface

What this book covers

What you need for this book

Who this book is for

Conventions

Reader feedback

Customer support

Errata

Piracy

Questions

1. Preparing the Ground

Introduction

Creating the installer from the source code

How to do it...

How it works...

There's more...

Using RUN_Build.bat to create the installer

Installing ADempiere

Getting ready

How to do it...

How it works...

There's more...

See also

Debugging the ADempiere client application (Desktop version)

Getting ready

How to do it...

How it works...

See also

Debugging the ADempiere server application (web version)

Getting ready

How to do it...

How it works...

See also

Running multiple instances on a single server

Getting ready

How to do it...

How it works...

See also

Giving ADempiere your identity

Getting ready

How to do it...

See also

2. ADempiere Customization Part I

Introduction

Creating a new window

Getting ready

How to do it...

How it works...

There's more...

Customizing an existing window

How to do it...

How it works...

There's more...

Creating a window with multiple tabs

Getting ready

How to do it...

How it works...

There's more...

Creating a search widget

Getting ready

How to do it...

How it works...

Populating the combo-box list

Getting ready

How to do it...

How it works...

Configuring a zoom window

How to do it...

Creating a read-only window

How to do it...

Creating a read-only tab

How to do it...

How it works...

There's more...

Making the tab read-only for everyone

Creating read-only fields

How to do it...

Creating a new menu tree

How to do it...

Role set up and assigning a menu tree to a role

How to do it...

Defaulting the data display to single/multi-row mode

How to do it...

Showing the entity and line items on the same tab

How to do it...

3. ADempiere Customization Part II

Introduction

Copy another tab widget into this tab

How to do it...

Filtering data at tab level

Getting ready

How to do it...

Configuring Display Logic

How to do it...

Configuring Default Logic

How to do it...

Creating a new window from an existing window

How to do it...

Configuring a Lookup Record

How to do it...

Dynamic validations

Getting ready

How to do it...

Customizing the default print format of a window

How to do it...

Configuring a new print format for a window

How to do it...

Generating a model

Getting ready

How to do it...

Creating a new info window for the desktop version

How to do it...

There's more...

Role-based access to the info window

Creating a new info window for the web version

How to do it...

Creating a callout

Getting ready

How to do it...

Modifying hooks for a model

How to do it...

Creating a process

How to do it...

Extending the desktop version of the toolbar

How to do it...

Extending the web version of the toolbar

How to do it...

Grouping the fields in a tab

How to do it...

4. Web services

Introduction

Building Web services support

Getting ready

How to do it...

See also

Configuring Web services

Getting ready

How to do it...

Configuring a Web service to create a record

Getting ready

How to do it...

Configuring a Web service to read a record

How to do it...

Configuring a Web service to read a list of records

How to do it...

There's more...

Reading a list of records using getList

Configuring a Web service to update a record

How to do it...

Configuring a Web service to remove a record

How to do it...

Configuring a Web service to run a process

Getting ready

How to do it...

There's more...

5. VirtueMart Integration

Introduction

Setting up the environment

How to do it...

How it works...

Bridging with Apache ActiveMQ

Getting ready

How to do it...

How it works...

Building ActiveMQ adapters for ADempiere and VirtueMart

How to do it...

How it works...

There's more...

Publishing products and prices to the VirtueMart

How to do it...

Linking VirtueMart checkout with ADempiere

How to do it...

How it works...

6. JasperReports with ADempiere

Setting up the environment

Getting ready

How to do it...

Developing a new report using view

Getting ready

How to do it...

Developing a report without a view

Getting ready

How to do it...

Using the context in a report

How to do it...

Developing a report with sub-report

How to do it...

Using custom report for printing

How to do it...

7. PayPal Integration

Introduction

Preparing the ground

Getting ready

How to do it...

How it works...

There's more...

Working with PayPal APIs

Getting ready

How to do it...

How it works...

There's more...

Making payment to a PayPal account

Getting ready

How to do it...

How it works...

There's more...

Integrating PayPal Instant Payment Notification (IPN)

Getting ready

How to do it...

How it works...

8. Equifax Integration

Introduction

Equifax session service

Getting ready

How to do it...

How it works...

There's more...

Invalid Session

Session Timeout

Equifax address matching service

How to do it...

How it works...

There's more...

Equifax bank validation service

How to do it...

How it works...

There's more...

Equifax company matching service

How to do it...

How it works...

Equifax consumer bureau service

How to do it...

How it works...

Equifax password change service

Getting ready

How to do it...

How it works...

9. Mondrian Integration for Analysis

Introduction

Setting up the environment

Getting ready

How to do it...

How it works...

Defining analysis cube

Getting ready

How to do it...

Analyzing data using Mondrian and JPivot

Getting ready

How to do it...

Slicing and dicing

How to do it...

Producing charts and graphs

How to do it...

Creating reports from the analyzed data set

How to do it...

10. E-mail Integration with Mozilla Thunderbird

Introduction

Setting up the environment

How to do it...

Extending the Thunderbird toolbar

Getting ready

How to do it...

Working with ADempiere contacts from Thunderbird

Getting ready

How to do it...

Index

ADempiere 3.6 Cookbook

ADempiere 3.6 Cookbook

Copyright © 2011 Packt Publishing

All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews.

Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the author, nor Packt Publishing, and its dealers and distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book.

Packt Publishing has endeavored to provide trademark information about all of the companies and products mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy of this information.

First published: March 2011

Production Reference: 1040311

Published by Packt Publishing Ltd. 32 Lincoln Road Olton Birmingham, B27 6PA, UK.

ISBN 978-1-849513-38-8

www.packtpub.com

Cover Image by Asher Wishkerman (<a.wishkerman@mpic.de> )

Credits

Author

Ajit Kumar

Reviewers

Anuj Agarwal Bahman Movaqar

Acquisition Editor

Steven Wilding

Development Editor

Susmita Panda

Technical Editor

Prashant Macha

Indexer

Hemangini Bari

Editorial Team Leader

Mithun Sehgal

Project Team Leader

Lata Basantani

Project Coordinator

Vishal Bodwani

Proofreader

Lisa Brady

Graphics

Nilesh R Mohite

Production Coordinator

Melwyn D'Sa

Cover Work

Melwyn D'Sa

About the Author

Ajit Kumar started his IT career with Honeywell, Bangalore in embedded systems area and moved on to enterprise business applications (such as ERP) in the 11 years of his career. From day one, he was a staunch supporter and promoter of Open Source and believes, strongly, that Open Source is the way for a liberal, diversified, and democratic setup like India.

He dreams and continuously endeavors that the architecture, frameworks, and tools must facilitate the software development at the speed of thought.

Ajit holds a B.E. degree in Computer Science and Engineering from Bihar Institute of Technology and has co-founded Walking Tree, which is based out of Hyderabad, India. This is the place where he plays the role of a CTO, and works on fulfilling his vision.

I would like to thank my wife, Priti, my 4 year old son, Pratyush, and the new born who was very patient and supportive; my work colleague, Suman, whom I've had the pleasure to learn from; my business partners, Alok and Pradeep who relentlessly talk about the book; friends who always encouraged me; the reviewers, and all the people behind the ADempiere project and other Open Source projects.

About the Reviewers

Anuj Agarwal has a passion for providing easy solutions to complex business problems using information technology as a key tool.

Anuj started his career in merchant banking/investment banking and worked for a while in general management functions including finance, legal, and investor relations.

Anuj's passion to create smart solutions for business problems led him to consulting on large projects. He consulted for companies in the public sector and the private sector on solutions relating to finance, accounts, inventory, corporate loan management, housing loan management, treasury, personnel, and HR management.

Anuj has been involved in ERP implementation for the last 10 years.

Anuj is currently the Director of Aditi Business Solution, a startup providing smart business solutions to the corporate sector, public sector, and government sector in the areas of ERP, CRM, Hospital Management, IT Trainings, Mobile APPS, and Scanning and Digitization of documents and maps.

I would like to dedicate my work to Mr. B.K. Seth, my teacher, friend, and philosopher, and would like to thank my wife Siddhi for all the support she extended to me, while I spent extra hours on this book.

Bahman Movaqar is an ERP and Information Systems consultant specializing in Open Source solutions. He has been working on ADempiere and Compiere projects for more than 5 years and has made several contributions to the ADempiere project, most notable among them is finding and patching a major security hole. He is currently working with the Iranian National Tax Administration Bureau as the CTO of an ERP project. He sometimes blogs on http://BahmanM.com.

I'd like to thank my lovely wife Nahid for her patience during all those nights I spent working on this book and my dear friend Timo for opening the gateway to free Internet for me.

www.PacktPub.com

Support files, eBooks, discount offers, and more

You might want to visit www.PacktPub.com for support files and downloads related to your book.

Did you know that Packt offers eBook versions of every book published, with PDF and ePub files available? You can upgrade to the eBook version at www.PacktPub.com and as a print book customer, you are entitled to a discount on the eBook copy. Get in touch with us at for more details.

At www.PacktPub.com, you can also read a collection of free technical articles, sign up for a range of free newsletters, and receive exclusive discounts and offers on Packt books and eBooks.

http://PacktLib.PacktPub.com

Do you need instant solutions to your IT questions? PacktLib is Packt's online digital book library. Here, you can access, read, and search across Packt's entire library of books.

Why Subscribe?

Fully searchable across every book published by Packt

Copy and paste, print and bookmark content

On demand and accessible via web browser

Free Access for Packt account holders

If you have an account with Packt at www.PacktPub.com, you can use this to access PacktLib today and view nine entirely free books. Simply use your login credentials for immediate access.

Preface

ADempiere is one of the leading open source ERP products in today's business market. ADempiere offers everything you need to make your business successful. Efficient data management, streamlining business processes, reduction in costs, and minimal complexity.

What this book covers

Chapter 1, Preparing the Ground: This is the starting point. The chapter prepares us for the journey ahead. In this chapter, we would learn how to set up a typical development as well as deployment environment. This chapter introduces the different tools and teaches us how to make use of them in the development.

Chapter 2, ADempiere Customization Part I: In this chapter, we are going to look at the overall customization capability of ADempiere, mainly through the Application Dictionary configuration. The chapter covers topics such as creating a new window, how to customize an existing one, how to create multiple tabs in a window, the search widget, zoom option, and menu tree. A case study-based approach has been taken to explain the practical relevance of each of the topics.

Chapter 3, ADempiere Customization Part II: In this chapter, we will look into the advanced configuration options of ADempiere and topics such as data filtration, using display and default logics, lookup record, dynamic validation, customizing print format, working with the models, callouts, processes, and toolbars.

Chapter 4, Web Services: This chapter covers the recipes and the steps required to get the Web services capability built into the ADempiere. The chapter explains the different types of ADempiere Web services and how to make use of them.

Chapter 5, VirtueMart Integration: This chapter introduces Joomla!'s VirtueMart shopping cart component and its integration with ADempiere. The recipes try to provide the required information using which we shall be able to use VirtueMart as the web store.

Chapter 6, JasperReports with ADempiere: JasperReports is at the heart of ADempiere's reporting framework. In this chapter, you learn how to set up the environment, how to develop a new report with/without a database view, how to make use of ADempiere's context in a report, using sub-reports, and how to use a custom report for printing.

Chapter 7, PayPal Integration: This chapter is dedicated to the integration of PayPal with ADempiere. The recipes include setting up the environment, making use of the PayPal APIs, and the specific use cases, like, making payment to a PayPal account, receiving payment from a PayPal account, and the Instant Payment Notification.

Chapter 8, Equifax Integration: Equifax