The amazing world of IBM ODM and more

The amazing world of IBM ODM blog - Angello Manrique Vigil
  • HOME
  • ABOUT ME
  • CONTACT ME

Working with the Decision Center API

Wednesday, 21 June 2017 by Angello Manrique Vigil

In many IBM ODM rules implementation projects we are going to have requirements that involve working with the IBM ODM API. Even though the Decision Center has a lot of powerful features to customize our rules, there are some things that can only be achieve by working with the API, this means we will have to work with java code and be familiar with the ODM API classes to accomplish our goals. In this tutorial I will show you the basics of how to establish a connection with the Decision Center from the Rule Designer and retrieve valuable project information. You can apply this for your particular requirement.


Steps:

  1. Getting familiar with ODM API
    • We first need to take a moment and review some of the most important classes in the IBM ODM API documentation (IlrSession) , it’s ok if you don’t fully understand how they work at first. It is all about practice.
    • Enter here to access the documentation.
  2. Creating a Java project
    • Open Rule Designer and create a new Java Projectnew java project odm sample
    • Now we have to add the teamserver libraries to the build path for our Java project:properties java build path sample odm
    • Tip: the libraries are in <your_installation_path>\teamserver\lib
  3. Establishing the decision center connection
    • Create a new main class to test our remote ODM API decision center connectionjava main class sample odm
    • Our java class needs to implement the IlrSession class:remote connection sample session odm api
    • Create your connection parameters, in my case:ibm odm api connection remote session parameters sample
    • Now in our main class we need to create an object of the IlrSessionFactory class that implements IlrRemoteSessionFactory
    • Lets call the connect method:ibm odm api connection remote session parameters sample
    • Tip: be sure to work in a try/catch block to manage any connection exceptions
  4. Obtaining Decision Center data
    • Now that we are able to connect to the Decision Center repository let’s try to obtain information about the project
    • Create an object of IlrSession to obtain the current session:factory odm api sample
    • Lets obtain the rule project name:ibm odm api rule project name code sample

Results:

We can work and obtain pretty much any data, object or method that is inside the Decision Center repository. We can also create our custom jar classes and repackage the teamserver.ear with it.

I hope you enjoy this tutorial and please let me now if you need help working with the ODM API and what do you want to see next. Thank you!

DecisionCenterODMAPIRuleDesigner
Read more
  • Published in Decision Center, ODM API, Rule Designer
No Comments

Automating deployments with Ant tasks

Monday, 12 June 2017 by Angello Manrique Vigil

To deploy RuleApps to Rule Execution Server, automate managerial tasks within Decision Center, and run many of the samples, you must have Ant installed on your computer. IBM ODM comes with Ant in the <InstallDir>/shared/tools/ant path. In this tutorial I will show how to use Ant tasks to automate RuleApp management tasks, including reading a specified RuleApp archive from the RES console, create a well-formed RuleApp archive with all its mandatory execution resources and deploy a RuleApp archive to a running Rule Execution Server instance.


Steps:

First of all we need to set up our environment to automate processes, please follow the steps in this link.

  1. Downloading RuleApp instances from RES
    • Create an Ant Build file, you can this directly in your Rule project in Eclipse:build file eclipse sample
    • Define your project and property variables values.
    • Tip: You can define properties for your common values like hostname, destfile, userid and password.
    • Please find the next sample as a demonstration of a working Ant build file:res fetch all build ant sample odm res
    • The target res-fetch command extracts a specific Ruleapp value, the res-fetch-all will generate a .war file with all the Ruleapps present in the RES
  2. Deploying into RES with Ant Tasks
    • Now that we have our jar file ready, we can automate the deployments with Ant Tasks by using the res-deploy command.
    • You will need to add a new target to your build ant file or create a new one, this command requires the login credentials, jar path and hostname.
    • Please refer to the following example:res deploy ant task command sample

Results:

After running our deploy command we see our Ruleapp deployed in the RES:

res ruleapp sample

There are many more automation and integration to be done with Ant Tasks, please let me know what you wish to see next, and as always feel free to comment or contact me with any feedback or support! Thank you!

AntTasksRuleAppRuleDesigner
Read more
  • Published in Ant Tasks, Rule Authoring, Rule Designer, Rule Execution Server (RES)
2 Comments

Editing business rules in Microsoft Office

Sunday, 04 June 2017 by Angello Manrique Vigil

IBM ODM Decision Center Business Console provides a powerful web-based decision table editor. Since V8.8.1, this includes exporting a decision table to Excel. But what if we are working in previous versions? or what if the business users still want to use Microsoft Office tools like Excel or Word to create/edit the rules? That is when Rule Solutions for Office comes in handy.

Rule Solutions for Office enables you to edit business rules in Microsoft Office documents called RuleDocs. You can update and share rules with RuleDocs, which can also provide supporting documentation and information such as the original policies for the rules. It works in conjunction with Decision Center, which serves as a workspace for business users to collaborate on authoring, editing, organizing, and searching for business rules.

In this tutorial I will you show the steps to set it up correctly and start editing your business rules in Office!


Steps:

  1. Go to <Your ODM Installation Path>\Rule Solutions for Office and install the plug in.Rule Solutions for Office
  2. Login to your Decision Center Enterprise Console, you will need to have the Decision Service project already synced with Decision Center.
  3. Tip: Click here to learn more about synchronizing with Decision Center from the Rule Designer.
  4. Select the Decision Service that contains the rules you need to edit.
  5. Tip: Remember to Select the Rule Project too.IBM ODM Decision Center Rule Project selection example
  6. Now select the package with the Decision Table or Rule Action you want to edit. You will notice there is no option to edit the rule in Microsoft Office:IBM ODM Decision Center rules sample
  7. That is because we need to add configuration parameter to enable the Rule Solutions for Office editing:
    • Go to Configure and click “Installation Settings Wizard”
    • Tip: you will need to be logged in with a user that has the rtsInstaller and rtsConfigManager role to see this option.
    • Click “Step 5: Set Configuration Parameters” and click “New”
    • Search for “Enable editing in Rule Solutions for Office” option and type “true” in the value textbox:IBM ODM Decision Center configuration parameters example
    • Click Apply and Exit
  8. Go back to your rule package in the “Explorer” tab and now you should be able to see new options:IBM ODM Decision Center Rule Solutions for Office options sample

Results:

Now you are able to edit the rules in Word/Office! Explore the options that the Rule Solutions for Office provide, remember that the Rule will remain lock until you finish the editing. I hope this article helps you, please feel free to contact me with any feedback or questions! Thank you!

DecisionCenterRuleSolutionsForOffice
Read more
  • Published in Decision Center, Rule Solutions for Office
No Comments

Monitoring ruleset execution with ODM RES Decision Warehouse

Thursday, 01 June 2017 by Angello Manrique Vigil

After we finish developing and deploying a Rule Project into the Rule Execution Server (RES), oftentimes we need to review and analyze which and when a ruleset has been executed. Luckily for us the Rule Execution Server comes with the Decision Warehouse tool for monitoring and storing ruleset execution traces in a database. We can also connect and save this data to an external Database by configuring the Datasource in the Application Server console. In this article I will explain how to easily configure the properties of the Ruleset to enable the monitoring and then read and review the decision from the Decision Warehouse.


Steps:

  1. Configuring the Ruleset
    • Login into the RES console and navigate to the Ruleapp that contains the Ruleset you wish to monitor.
    • Click the Ruleset, now you should be in the Ruleset view:IBM ODM RES Ruleset view sample
    • By default, if you didn’t add any property before the deployment, the properties list is empty. There are 3 necessary properties you need to have to enable monitoring:
      • ruleset.bom.enabled
      • monitoring.enabled
      • ruleset.sequential.trace.enabled (if the ruleset contains tasks that use the sequential or the Fastpath execution mode)
    • Instead of adding them manually, navigate and click the next option “Show Monitoring Options” and select “Enable tracing in Decision Warehouse”.
    • The following options will depend on what you need to trace:IBM ODM RES Monitoring Options sample
    • After clicking save you will notice that the properties were added automatically (you might need to refresh the webpage):IBM ODM RES Ruleset properties sample
    • Execute a call or multiple calls of this Ruleset WS from Decision Validation Services, a client application, or a hosted transparent decision service.
    • Tip: I use SoapUI software to execute and test the rulesets.
  2. Searching Rulesets executions in the Decision Warehouse
    • Login to the RES console.
    • Click on the “Decision Warehouse” tab.
    • These filters are useful when you have more projects and need to review specific Rules, Time frames, parameters, etc:IBM ODM RES Decision Warehouse search sample
    • Click search and “View Decision details” for a particular Decision ID.

Results:

All the information about the Ruleset Execution will appear:IBM ODM RES Decision Warehouse Decision Trace Sample

You can review which rules were fired, the timestamp, processing time, rules names, input/output parameters, etc. The goal is to provide business users with data from which they can generate reports and measure how well a business is running.

Tip: You can send a Decision ID tag while executing the ruleset so it is easy to find the Decision Warehouse:SoapUI Decision ID tag sample

I hope you enjoy this article about IBM ODM RES Decision Warehouse and as always feel free to contact me with any questions or feedback. Thank you!

DatabaseDecisionWarehouseRESRuleset
Read more
  • Published in Database, Decision Warehouse, Rule Execution Server (RES)
3 Comments

Recent Posts

  • RPA – UiPath: Working with Excel

    In this blog post we will talk about working wi...
  • ODM on Docker!

    If you are a DevOps enthusiast like me you prob...
  • RPA: UiPath and ODM integration

    In this technical tutorial we will have a look ...
  • Populating Decision Tables with external data sources

    One of the most used artifacts in IBM ODM is th...
  • Decision Composer, integration with Rule Designer

    In this post I will show a new way to start you...
  • Connecting to external Database with ODM API

    The IBM ODM Decision Center and the Rule Execut...
  • Custom log file with ODM API

    Given the positive feedback from previous post ...
  • Working with the Decision Center API

    In many IBM ODM rules implementation projects w...
  • Automating deployments with Ant tasks

    To deploy RuleApps to Rule Execution Server, au...
  • Editing business rules in Microsoft Office

    IBM ODM Decision Center Business Console provid...

Categories

  • Ant Tasks
  • Bluemix
  • Cloud
  • Database
  • Debug
  • Decision Center
  • Decision Operation
  • Decision Table
  • Decision Warehouse
  • Docker
  • Domains
  • Java
  • ODM API
  • RPA
  • Rule Authoring
  • Rule Designer
  • Rule Execution Server (RES)
  • Rule Solutions for Office
  • Ruleflow
  • UiPath

Recent Posts

  • RPA – UiPath: Working with Excel

    In this blog post we will talk about working wi...
  • ODM on Docker!

    If you are a DevOps enthusiast like me you prob...
  • RPA: UiPath and ODM integration

    In this technical tutorial we will have a look ...
  • Populating Decision Tables with external data sources

    One of the most used artifacts in IBM ODM is th...
  • Decision Composer, integration with Rule Designer

    In this post I will show a new way to start you...

Recent Comments

  • Mastan on Debugging a simple Ruleflow in Rule Designer
  • Angello Manrique Vigil on ODM on Docker!
  • brian on ODM on Docker!
  • Angello Manrique Vigil on Populating Decision Tables with external data sources
  • Pramod on Populating Decision Tables with external data sources

Subscribe

  • Register
  • Log in
  • Entries RSS
  • Comments RSS
  • WordPress.org

All rights reserved. Made by Angello Manrique Vigil.

TOP