Version 236

    Welcome to the wiki of page for JBoss Rules. Otherwise known as Drools 3. Please feel free to add your own tips/gotchas - you just need to signup for a jboss.com account (free and open to everyone). Currently the JBoss wiki is still on the jboss.com site so you will find the links for the naviation on the left may have change if you linked through from JBoss Labs, confusing I know. This will be resolved in next JBoss Portal release when JBoss Wiki will be properly integrated with Jboss Labs.



    IMPORTANT note re manual/documentation for 4.0

    The documentation is now up to date, the language reference is now comprehensive, but it always needs improvement. If you want to get involved in improving this your help would be very much appreciated, we use docbook with the XMLMind editor which si very esay to get into. We will soon be looking for people to help out with i18n of the docs.



    SNAPSHOT Releases

    We are now running the excellent Hudson build tool. Whenever a change is made, it will build. You can track it from https://hudson.jboss.org/hudson/job/drools/. To get the latest SNAPSHOT releases, go to https://hudson.jboss.org/hudson/job/drools/lastSuccessfulBuild/artifact/trunk/target/. After a commit, a new build is usually available 30-ish minutes later (if successful), depending on load/time of day etc.


    ATTENTION Eclipse plugin

    Eclipse GEF is now required. So if you want to use the plug-in, you will need to download the GEF from Here. Or, you can use the Eclipse update feature to locate GEF. The rules update site should soon be updated to automatically install GEF if you don't have it already (but it isn't now).


    ATTENTION: converting Eclipse projects with 3.0.5 plug-in to 4.0.n version

    The 4.0.n Eclipse plug-in Builder has been moved to a different package. If you have Drools projects developed with the 3.0.5 plug-in and then you install the 4.0.n plug-in, you will have to edit the .project files and update the plug-in Builder name. Go to the the top directory of the project, open .project, find the line with "org.drools.ide.droolsbuilderorg.drools.eclipse.droolsbuilder</name>". It should start working as soon as you save the change.


    Eclipse plug-in v. 4.0.0 Installation Instructions for Rational Application Developer v. 7.0



    To clarify - Drools is the project development name, our R&D play pen. JBoss Rules is productized stable branch of Drools with additional support, consultancy and training; backports of bugs will be applied to JBoss Rules, but almost never to Drools.


    NOTE: There is also a complete manual for JBoss Drools, this wiki supplements the formal manual (see below for links).


    Important links

    Online documentation

    Drools Roadmap

    Testing framework add-on

    Project homepage

    Jar Dependencies

    Migrating from Drools 2.x to 3.0

    JBoss Rules blog (stay up to date !)

    JBoss Rules Student Projects




    IDE/Eclipse plug-in

    Prerequisite GEF

    Getting help or helping out

    • As normal, the maniacs can be found in the drools IRC room at irc.codehaus.org. Web client available for those behind a firewall http://irc.codehaus.org. Mark Proctor is known as "conan", and he is a vegetiarian, so he won't bite. The others are not though

    • Use the mailing lists. Use the "user" list for end user issues, "dev" for when you are mucking about with the internals.

    • Use jira to log issues.

    • Developer Tools





    From the download page there are samples to show of various aspects. Some samples may be found on the wiki from time to time which are more up to date/richer.


    Its important to note that the default textual language input for Drools 3 and up is a non XML format (XML support will be coming shortly as an alternative). It uses an Antlr3 grammar to parse rules and compile. See the RuleLanguageFAQ for some more info.

    There is an examples project you can download.



    Drools Puzzles - (A Regular Drools Programming Contest)

    Since August 2007 we have a regular programming contest for JBoss-Drools. Initiated by E.Zhao, open to everyone. See the JBoss-Drools puzzle page for details. You might even win a price...





    TIPS, TRICKS & FAQ for users (rule developers)




    Rule patterns and practices



    Tips for JBoss Rules developers/contributors




    Miscellaneous Questions


    Presentations (feel free to use as needed)

    Maven2 Repository

    JBoss Rules is made available at the JBoss maven2 repository http://repository.jboss.com/maven2/ in the following direcotry http://repository.jboss.com/maven2/org/drools/. We do not currently upload to ibiblio, but community members are welcome.


    Wiki guidelines

    • Feel free to edit/add to this wiki - the aim of the wiki is not to be a manual, but to be a general "catch all" area for helpful tips and links. Also, articles and documentation may be entered here first, when its ready, it will then be formally moved into the manual for future reference. In the old Drools web site, the wiki was also the documentation, but for Drools 3 onwards, we are providing a formal manual for this purpose.

    • Many tips are from real world deployments, add more of your own  Feedback/contributions are always appreciated. Its a wiki !



    .Net version

    • Information can still be located here



    Design and Enhancement ideas

    This section is for contributors (of ideas and code) or people interested in the future directions of JBoss Rules. Some of these ideas are works well in progress, some are just concepts/thoughts. Jump in, the water is warm (its a wiki !).





    BRMS (repository) designs

    Rule Deployment Agent

    DSLs, Natural Language and rules

    SBVR standard (s beaver)



    Event Stream Analysis




    Backward  Chaining





    Rule Test Manager




    Decision tables:


    Next gen. Decision tables