Compiere开发者指南：从初识到实践

需积分: 10 174 浏览量更新于2024-08-02 收藏 308KB PDF 举报

"Compiere Developer Documentation 是一本关于Compiere开发的指南，由Marco Lombardo创作并享有版权。这本书主要涵盖了Compiere的开发、应用字典、属性集使用、菜单与树结构、报告引擎等内容，并提及了社区的贡献，如Peter Shen的应用字典解析和Redhuan D. Oon的Compiere源代码分析。" Compiere是一款开源的企业资源规划（ERP）和客户关系管理（CRM）系统，其开发者文档旨在帮助开发者深入理解并参与到Compiere的开发中来。文档首先介绍了Compiere的名字和许可协议，强调了其开源性质。"Compilo"是Compiere的灵感来源，代表了将商业逻辑与数据库操作相结合的概念。文档的"First 10 historical topics"部分提供了一系列教程，从基础到进阶，涵盖了如何添加和执行PL/SQL过程，使用Java代码和Jars（例如Jasper Reports），以及理解Compiere的应用字典，这是一套用于定义业务逻辑和数据模型的工具。属性集（AttributeSet）的使用被详细解释，包括如何从开发者的角度操作它。此外，还讲解了菜单（Menus）、菜单栏（MenuBar）、报告引擎的工作原理，如ProcessCtl.process()和ReportCtl.start()函数的调用，以及ReportEngine和Viewer的交互。文档还提到了社区对Compiere的贡献。Peter Shen分享了关于应用字典的深入见解，详细解析了"Tables and Columns"和"Windows, Tabs and Fields"窗口。Redhuan D. Oon则探讨了Compiere的源代码，包括源代码的来源、开放性问题、市场动态，以及如何理解和解析源代码，以理解其商业功能。 "Compiere Developer Documentation"为开发者提供了一条学习和参与Compiere开发的路径，从基本操作到高级开发技术，再到社区的贡献，为开发者提供了全面的参考资料。对于想要深入了解和定制Compiere系统的人员来说，这是一份非常有价值的文档。

Chapter 3: First 10 historical topics 4

Here you have the modiﬁed version of JR in jar and source code, a modiﬁed version of iReport

to design with barcode (download section). Under the “more docs” section there is an Howto

about iReport.

1. Modify AD

We want to use Jasper Reports so we are ﬁrst going to design a report. Those who wants

to use other classes/jars can go to the next point of this topic. What kind of Jasper Report

can we test? I am choosing a Report with a parameter. Let’s design a Report that shows

the Orders a Business Partner have, where our parameter is the Bussines Partner ID. First

we create a view with the information we need:

create or replace view NN_BPartnerOrder_V

select C_BPartner_ID, Name, GrandTotal, DateOrdered

from C_Order join C_BPartner using (C_BPartner_ID);

Then create a Jasper Report on this view with your preferred tool, I used iReport. The

Report should look, more or less, as the ﬁle 001/JRBPartnerOrder.xml . You can use this

ﬁle directly if the dir. /tmp is accessible in your system. Barbecue needs a temporary dir.

in order to create and place the jpg of the barcode. You should modify it if /tmp is not

accessible on your system or you will se e the report without the barcode. Here you can ﬁnd

the .jasper too, in fact you need the xml or the jasper ﬁle for the next step.

2. The java part.

Usually you have some .java ﬁle that uses .jar, directly or indirectly (jars used by others

jars). Where are we going to put the jars? We have 2 options:

• Don’t want to unjar anything. This is the case of oracle.jar used by Compiere. These

jars are then included in the classpath everywhere, when c ompiling and when running

Server or Client or WebStart application. If you want to add a jar of this type you

have to modify some build.xml, some .jnlp, some .sh

• The s ec ond possibility is to include the classes you want to use in a jar already present

in the build/run script classpaths. If you look at the creation of CTools.jar the

build.xml logic compile some code and unjar some jars in the same build directory

then jar everything together.

The build/run scripts need to include only CTools.jar to use new classes created

compiling java code and classes simply expanded in the build directory before packing

CTools.jar

We are going to use the ladder method: our compiled classes will be packe d together

with the expanded version of jasperreports-0.5.2.jar and every jar used by Jasper Re-

ports or by java code. This will result in a NNCompiereJR.jar and build/run scripts

will be modiﬁed to let Compiere use this new jar. You can ﬁnd this work in the

NNCompiereJR module on the CVS.

The ﬁnal step of this point is to generate the NNCompiereJR.jar: download the module

go to the NNCompiereJR dir. and type ant (ant 1.6.1 is required). At the end the jar

will be ready.

Note: if you want to upgrade/downgrade Jasper Reports or any other jar just update

the lib dir. and the new jar present here will be used during jar creation and packed

together in the ﬁnal jar.

3. Modify build/run scripts.

• utils_dev/build.xml

I added my dir here so NNJasperReport get compiled when I compile Compiere. I add

this line: <ant inheritAll="false" dir="NNCompiereJR"> and similar information

in the cle an section.

• client/build.xml

Here we have to add the unjar of one jar more before to create CClient.jar .

The line I added is: <unjar src="..\NNCompiereJR\dist\NNCompiereJR.jar"

dest="${build.dir}" />

Chapter 3: First 10 historical topics 5

• utils/compiereDirectTemplate.jnlp

The precedent modiﬁcations are important at compile time. This and the one that

follow is important at run time. Add the following line to the ﬁle indicated in the

<resources> section: <property name="ru.compiere.report.path" value="/tmp"/>

/tmp is a directory on the client, you can use a network path and is were Compiere

will look for .xml and .jasper ﬁles

• serverRoot/src/web/compiere.jnlp

Same modiﬁcation as above.

4. Modify the Application Dictionary. As you can imagine, if you are not new to JasperReport

our Reports will always be generated by the same class, that will read a diﬀerent .xml or

.jasper from Report to Report. So we need to add a Column/Field in the Process tab. Add

a c olumn:

SQL> alter table AD_Process add (JasperReport VARCHAR2(200));

load the column inside Compiere:

SQL> db/maintain/Maintenance/0_Add_New_Column.sql

create the new ﬁeld:

SQL> get db/maintain/Maintenance/0_Add_New_Field.sql

SQL> /

5. Specify a new Process.

As you can see when you go to specify a new Process there is a new Field. Create a Pro c es s

with:

classname: ru.compiere.report.RusReportStarter

JasperReport: JRBPartnerOrder.xml

with a Parameter with:

ColumnName: C_BPartner_ID

Type: TableDir

This class internally looks ﬁrst at the ru.compiere.report.path property for the path.

Then it uses $COMPIERE_HOME/russian/reports when searching for xml . If you are lazy

and wants it fast, just put reports under $COMPIERE_HOME/russian/reports. Now you can

try the Process: when you run it the ru.compiere.report.RusReportStarter class will

be executed. This class will read from AD Process to know which Jasper Report ﬁle to use,

and look for it in the path inside ru.compiere.report.path (/tmp in our case).

This will read the C BPartner ID from AD PInstance Para and shows you the Sales Orders

this BPartner has.

002, Compiere Application Dicti onary.

(To be continued...)

AD_ Application dictionary

A_ Asset Management

C_ Core Functionality

GL_ General Leder

I_ Import

K_ Knowledge Base

M_ Material Management

PA_ Performance Analysis

R_ Request

RV_ Report Viewer

S_ Service Management

T_ Temporary

W_ Webstore

X_ Generated Model

003, Using Attribute Set.

剩余35页未读，继续阅读

yangmantis

粉丝: 5
资源: 51

Compiere开发者指南：从初识到实践

compiere中文说明

基于C51单片机Proteu仿真实例及软件源码+文档说明 之-电子琴.zip

#_ssm_144_mysql_在线投票系统wlw_.zip

基于java的智乐健身后台管理系统设计与实现.docx

基于java的鲜花销售管理系统设计与实现.docx

数字孪生技术在智能制造的应用与展望

java-ssm+vue线上旅行信息管理系统实现源码(项目源码-说明文档)

网络管理是什么 网络管理做什么 网络管理长什么样 1.带机量（支持用户数） 2.端口数 3.吞吐量，并发连接数 4.

让数据库设计变得更简单！立即使用我们的SQLite3数据库设计工具，提升您的开发效率，轻松应对各种数据库管理挑战！

小程序-滴滴作业.zip

最新资源

基于C51单片机Proteu仿真实例及软件源码+文档说明之-电子琴.zip

网络管理是什么网络管理做什么网络管理长什么样 1.带机量（支持用户数） 2.端口数 3.吞吐量，并发连接数 4.