Task 6: Deploying rules

To create a RuleApp project and deploy the RuleApp:

1. Make sure that the sample server is started.

   If you have stopped the sample server, click Start > All Programs > IBM > package_group > Sample Server > Start server. package_group refers to the package group specified in Installation Manager during installation. The default package group is Operational Decision Manager V8.5.

2. In the Deploy and Integrate part of the Rule Project Map, click Create RuleApp project.
   Tip: You can also use the File menu, then click New > Project and select RuleApp Project.
3. In the New RuleApp Project wizard, in the Project name field, type my ruleapp.
4. Click Next.

   The my rule project is displayed on the Add Ruleset Archives page.

   Tip: If you cannot see your rule project, click Add, select my rule project, and click OK.
   
5. Click Finish.

   You created a RuleApp project that contains a ruleset archive generated from the project my rule project.

   my ruleapp is displayed in the Rule Explorer and the RuleApp editor opens to let you deploy the RuleApp to Rule Execution Server.

6. Click the Ruleset Archives tab in the editor.
   
7. Under Ruleset Archives, select the myruleproject archive.
8. Add the ruleset property to enable ruleset monitoring:
   1. In the Ruleset Properties section, make sure that ruleset.bom.enabled is absent or set to true.
   2. Click New to create a new property for the ruleset.
   3. In the Edit Property dialog, select the predefined property monitoring.enabled from the list, type true in the Value field, and then click OK.
   4. Save the changes.
9. Click the Overview tab, and click Deploy in the Deployment section.
10. In the Deploy RuleApp Archive wizard, keep Increment RuleApp major version selected, and click Next.
    Note: A warning is displayed if you are using the default Eclipse with JDK 7. If your application server runs with JDK 6, you must modify the settings in Eclipse to use JDK 6.
11. On the next wizard page, make sure that Create a temporary Rule Execution Server configuration is selected, and type the following configuration details:

    URL: http://localhost:<PORT>/res

    Important: Enter the correct port number in the URL. For more information, see Checking the server port number.

    Login: resAdmin

    Password: resAdmin

12. Click Finish.

    The Console displays a message indicating that the 1.0 version of the RuleApp has been deployed.

13. Close the RuleApp editor.

To view the deployed RuleApp:

1. Click Start > All Programs > IBM > package_group > Sample Server > Rule Execution Server Console.

   package_group refers to the package group specified in IBM® Installation Manager during installation. The default package group is Operational Decision Manager V8.5.

   Tip: You can also enter http://localhost:<PORT>/res in a browser. Enter the correct port number for the URL.
2. Sign in to the Rule Execution Server console using the following details:

   Username: resAdmin

   Password: resAdmin

3. Click the Explorer tab.
4. In the Navigator, expand RuleApps, and then /myruleapp/1.0.

   You see that Rule Execution Server contains your 1.0 version of myruleapp, which contains the 1.0 version of the ruleset as expected:

   
5. Click /myruleproject/1.0 to view the details.
   

   Note that the status of the ruleset is enabled, indicating that it can be executed.

6. Click the Show Properties link to view the ruleset properties.

   The property that you added in the previous step is set to true.

To call the integration code in the Miniloan application:

1. Open a new browser window, and enter the following URL with the correct port number:

   http://localhost:<PORT>/miniloan-server

2. Select the Use Rules check box.

   This check box activates the code that calls the execution of the ruleset. From this point, when you click Validate Loan, the miniloan web application executes the rules that you deployed to Rule Execution Server. The behavior of Miniloan is the same, except that the business logic is no longer part of the application code.

   Note that some fields have been temporarily added under Ruleset Information to let you see, as a developer, how the rules are being executed.

3. Click Validate Loan. The results of the validation are as before:

   The loan is rejected 
   Messages: 
   Too big Debt-To-Income ratio 

   The Rules Execution Summary shows that the eligibility.minimum income rule was executed in the rule task miniloan#eligibility.

   A rule is executed when the conditions of the rule are met and the actions of the rule are triggered. This rule sets the approved status of the loan to false.

4. Change the amount to 300000 and click Validate Loan again.

   This time you should see the following response:

   The loan is approved 
   The yearly repayment is 23758 

   The loan is approved, no rule has been fired.

5. Close the Miniloan web application. You will open it again later to monitor the application.

To retrieve the WSDL file:

1. In the Rule Execution Server console, make sure that you are still on the myruleproject ruleset page, and click Retrieve HTDS Description File in the toolbar at the top.
2. Keep the SOAP option selected, and then select Latest ruleset version and Latest RuleApp version, and click Download.
3. Save the WSDL file to <MyEclipseWorkspace>/my rule project and rename it to MyDecisionService.wsdl.

   <MyEclipseWorkspace> refers to your workspace directory on the file system.

   Tip: To import the WSDL file into Rule Designer, you can also use the Import wizard:

   1. On the File menu, click Import.
   2. Click General > File System, and then click Next.
   3. Browse to the folder where you saved the WSDL file, and select the WSDL file to import.
   4. In the Into folder field, select my rule project, and then click Finish.
4. Sign out of the Rule Execution Server console.

To test the web service:

1. In the Rule Explorer, right-click my rule project, and click Refresh.

   The MyDecisionService.wsdl file is displayed in the rule project.

2. Double-click the MyDecisionService.wsdl to open it in the WSDL editor.

   There is one operation (MyRuleProject) of request-response type with an input message, an output message, and a SOAP fault.

3. Close the MyDecisionService.wsdl file.
4. Switch to the Java perspective:
   1. On the Window menu, click Open Perspective > Other > Java.
   2. Click OK.
5. In the Package Explorer, expand my rule project.
6. Right-click MyDecisionService.wsdl, and click Web Services > Test with Web Services Explorer.
7. In the Web Services Explorer, under Operations, click Myruleproject.
   
8. Enter the following values in the empty fields for the borrower:
   • creditScore: 100
   • yearlyIncome: 70000
9. Enter the following values in the empty fields for the loan:
   • amount:8000
   • duration:12
   • yearlyInterestRate:2.5

   The credit score is below the minimum limit so the loan should be rejected.

10. Click Go to call the web service on Rule Execution Server.
11. In the Status section, take a look at the response.

    The loan was not approved.

    
12. Close the Web Services Explorer, and switch back to the Rule perspective.