OPENRULES Version 2.2.0 MOVING FROM 2.1.0 TO 2.2.0 September-2005 GENERAL NOTES Release 2.2.0 introduced several important changes (requested by customers) that force you to make small changes in your existing OpenRules projects created under Release 2.1.0 or erlier. While most changes are mainly deal with configuration issues and require mainly some renaming, please make sure that you save your working OpenRules installations before installing a new release. If by some reasons you have to download a previous OpenRules release again, you can find it at: - http://openrules.com/downloads/archive/openrules_2.1.0.console.zip or - http://openrules.com/downloads/archive/Release_2.1.0.zip (Eclipse version) HOW TO MIGRATE A PURE RULE PROJECT The changes are minimal. 1) Your build.xml should use openrules.config instead of lang.config. 2) If you use Eclipse IDE to maintain your basic rules projects with OpenRules nature, update your project properties. Now your project should depend on openrules.config instead of lang.config. If you still have syntax errors, you may add jar-file openrules.config/com.openrules.ruleengine.jar to the list of libraries under you Java Build Path. 3) If you use configuration packages and files inside your src directory, then create a new package "com.openrules" and place in it a flat file "com.openrules.properties". Copy to this file your property definitions from all old property files such as: - openrules/java/openrules.java.ant.properties - openrules/xml/openrules.xml.ant.properties - com/openrules/rules/com.openrules.rules.include.properties. Delete old property packages. HOW TO MIGRATE A WEB APPLICATION You will use "jakarta-tomcat" project instead of combination of old "lib.tomcat" and "deployed.tomcat" projects. A new deployer project is "jakarta-tomcat-deployer" instead of old "lib.tomcat.deployer". To compare web applications for 2.2.0 and 2.1.0 look at a sample project HelloForms. Here what you should do with your old web application. 1) Copy to your project root directory files: - build.xml - build.and.deploy.bat from sample project HelloForms. 2) Under Eclipse, check your project properties: now your project should depend on openrules.config instead of lang.config. Additionally, go to Java Build Path, select Libraries and add jar-file com.openrules.suite.forms.jar from openrules.config. 3) If you use configuration packages and files inside your src directory, then create a new package "com.openrules" and place in it a flat file "com.openrules.properties". Copy to this file your property definitions from all old property files such as: - com/openrules/forms/com.openrules.froms.properties - openrules/java/openrules.java.ant.properties - openrules/xml/openrules.xml.ant.properties - com/openrules/rules/com.openrules.rules.include.properties. Delete old property packages. 4) Copy to your src directory two files: - openrules.properties - openrules.froms.java.build.xml from sample project HelloForms. 5) Look at your index.jsp file in web directory. Make sure that when you create a JspFormsSession you use new JspFormsSession(getClass()); instead of just new JspFormsSession(); See web/index.jsp in the sample project HelloForms. HOW TO MIGRATE A WEB SERVICE You will use "jakarta-tomcat" project instead of combination of old "lib.tomcat" and "deployed.tomcat" projects. A new deployer project is "jakarta-tomcat-deployer" instead of old "lib.tomcat.deployer". Do not forget to update "lib.axis" project from a new installation. To compare web services for 2.2.0 and 2.1.0 look at a sample project HelloWS. Here what you should do with your old web service. 1) Copy the following files to your project root directory: - build.xml - build.and.deploy.bat - generate.webservice.java.bat - undeploy.bat from sample project HelloWS. 2) In the file build.properties make sure that property "ws.compile.user.classpath" refers to openrules.config instead of lang.config. As usual, make sure that you are using correct package and class name in web/WEB-INF/server-config.wsd. 3) Other changes (if any) are similar to those for the basic rules project. Copyright (C) 2005, OpenRules, Inc. All rights reserved. http://www.openrules.com