Created by 蓝色布鲁斯,QQ32876341,blog http://www.cnblogs.com/zzyan/
iDempiere官方中文wiki主页 http://wiki.idempiere.org/zh
iDempiere 中文社区www.idempiere.org.cn
iDempiere 中文社区QQ群 65713012

本文说明如何给iDempiere创建一个Process,包括如何定义一个插件工程,建立Process,并在系统中进行调用。

本文参考的youtube视频为:https://www.youtube.com/user/evenosconsulting/videos视频下载地址(百度网盘):http://pan.baidu.com/s/1vqLRo

Process表示一段运行的程序,他的输出可以是报表,也可以不输出任何东西。

Process可以在运行过程中对其他对象进行改变,比如销售订单界面上面的Process Order就是一个Process,他将销售订单进行了Complete或者Close操作。又比如MRP运算的process,在运行的过程中生成了采购申请。

Process 也可以用来执行一系列的检查,将结果在运行的过程中输出到文件中或者直接存入数据库。

Process可以设定成为按时、按计划运行,比如每天晚上凌晨3点做MRP运算。

该文档主要分为两个大步骤
1. 在iDempiere系统中定义Process,包括使用到的参数,调用的菜单等
2. 使用eclipse开发该Process的OSGI插件,并部署到iDempiere上

下面为开发process的详细操作

使用System账户登录系统,进入Report & Process
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

建立一个新的process
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

给该process添加几个参数,String, Boolean, Timedate
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

创建一个Menu,对该process进行调用
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

创建Menu,同时将该menu指向刚建立好的Process
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

保存以后,退出登录,重新以GardenAdmin用户进行登录,查看菜单,发现该功能已经显示在菜单里面了
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

打开该功能,已经能够正常录入参数,说明我们的Process和Menu的系统配置正常完成。下一步可以进行Process的实际开发。
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

开发部分,开发部分使用eclipse进行开发,具体的eclipse配置请查看前面的博客:http://www.cnblogs.com/zzyan/p/4124087.html

在eclipse中创建一个plugin project
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

提供一个工程名字,同时选中Target to run with “Equinox”。建议将工程建立在单独的文件夹而不是workspace文件夹,这样可以将自己的代码和系统标准代码分离开来。

选中java6,确保使用java6的用户能够正常使用
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

新的插件创建完成以后,打开项目文件,设置项目的Manifest文件。
为其添加两个Dependencies:
org.adempiere.base和org.adempiere.plugins.utils
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

创建对应的包以及process的java class文件,注意,包名和java class名字组合必须和process系统设置中的名字一样
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

更改java文件,iDempiere的process必须继承SvrProcess
process有两个函数
prepare() – 主要用于参数设置
doIt() – process的主函数,进行该process的主任务
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

具体的process实现我们后续添加

Process建立好了以后,我们需要新建一个factory类,并将其进行注册,这样我们的插件工程在启用的时候,iDempiere的OSGI服务能够通过该注册找到我们提供的service。
新建一个package,并添加一个factory类
在这里我建立org.zzya.factories.MyProcessFactory类
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

Factory类必须继承IProcessFactory。
我们同时重写其函数newProcessInstance如下
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

我们需要创建一个component definition,来告诉OSGI我们提供了这个服务
注意,eclipse需要是J2EE版本的indigo,之前我的eclipse版本为java普通版本,导致没有这个wizard,请重新下载一下开发环境,eclipse文件夹名称为eclipse-jee
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

创建一个component definition
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

设置component definition的参数
其中,service.ranking为每个plugin必须设置的一个参数
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

现在我们可以回去更改MyProcess的定义,执行实际的编程操作
下面的函数中:
getParameter为继承的函数,用于获取process调用时候传入的参数
log为继承的对象,用于输出日志
addLog用于输出结果到process的结果报表
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

编写完毕以后,我们重新启动服务,并尝试调用该process
在运行时,在run -> run configuration中,选中该plugin,同时将auto-start设置为true
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

运行process,设置参数
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

运行结果如下
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

查看eclipse中的log,发现log已经正常打印,说明该process插件已经正常运行
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

Process运行完了以后,可以在process audit中进行查看该运行的历史记录
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

Process audit中可以看到传入的参数值,以及使用addlog输出的log信息
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

下面我们进行一下扩展,看一下怎样能够在报表里面打印出料号信息,同时从报表中导航到料号界面。
更改MyProcess.java文件中的doIt(),同时添加一个getProducts函数,如下
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

重新运行,查看报表,发现报表结果显示了产品信息
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

点击超链接,可以看到界面导航到了产品product 界面
iDempiere 开发指南 Process(iDem后台进程)及插件的开发及部署-冯金伟博客园

 

以上文档说明了怎样对idempiere系统开发及调用一个Process