Chapter 11. Rules in case management

Procedure

1. Create the following business rule file called validate-document.drl:

   package defaultPackage;
   
   import java.util.Map;
   import java.util.HashMap;
   import org.jbpm.casemgmt.api.CaseService;
   import org.jbpm.casemgmt.api.model.instance.CaseFileInstance;
   import org.jbpm.document.Document;
   import org.jbpm.services.api.service.ServiceRegistry;
   
   rule "Invalid document name - reupload"
   when
       $caseData : CaseFileInstance()
       Document(name == "invalid.pdf") from $caseData.getData("hwSpec")
   
   then
   
       System.out.println("Hardware specification is invalid");
       $caseData.remove("hwSpec");
       update($caseData);
       CaseService caseService = (CaseService) ServiceRegistry.get().service(ServiceRegistry.CASE_SERVICE);
       caseService.triggerAdHocFragment($caseData.getCaseId(), "Prepare hardware spec", null);
   end

   Copy to Clipboard Toggle word wrap

   This business rule detects when a file named invalid.pdf is uploaded to the case file. It then removes the invalid.pdf document and creates a new instance of the Prepare hardware spec user task.

2. Click Deploy to build the IT_Orders project and deploy it to a Process Server.

   Note

   You can also select the Build & Install option to build the project and publish the KJAR file to the configured Maven repository without deploying to a Process Server. In a development environment, you can click Deploy to deploy the built KJAR file to a Process Server without stopping any running instances (if applicable), or click Redeploy to deploy the built KJAR file and replace all instances. The next time you deploy or redeploy the built KJAR, the previous deployment unit (KIE container) is automatically updated in the same target Process Server. In a production environment, the Redeploy option is disabled and you can click Deploy only to deploy the built KJAR file to a new deployment unit (KIE container) on a Process Server.

   To configure the Process Server environment mode, set the org.kie.server.mode system property to org.kie.server.mode=development or org.kie.server.mode=production. To configure the deployment behavior for a corresponding project in Business Central, go to project Settings General Settings Version and toggle the Development Mode option. By default, Process Server and all new projects in Business Central are in development mode. You cannot deploy a project with Development Mode turned on or with a manually added SNAPSHOT version suffix to a Process Server that is in production mode.

3. Create a file called invalid.pdf and save it locally.
4. Create a file called `valid-spec.pdf`and save it locally.
5. In Business Central, go to Menu Projects IT_Orders to open the IT_Orders project.
6. Click Import Asset in the upper-right corner of the page.

7. Upload the validate-document.drl file to the default package (src/main/resources).

   

   View larger image

   

   The validate-document.drl rule is shown in the rule editor. Click Save or close to exit the rule editor.

8. Open the Showcase application by either clicking the Apps launcher (if it is installed), or go to /http://localhost:8080/rhpam-case-mgmt-showcase/jbpm-cm.html.

9. Start a new case for the IT_Orders project.

   In this example, Aimee is the case owner, Katy is the manager, and the supplier group is supplier.

   

   View larger image

   
10. Log out of Business Central, and log back in as a user that belongs to the supplier group.
11. Go to Menu Track Task Inbox.
12. Open the Prepare hardware spec task and click Claim. This assigns the task to the logged in user.

13. Click Start and click to locate the invalid.pdf hardware specification file. Click to upload the file.

    

    View larger image

    

14. Click Complete.

    The value in the Task Inbox for the Prepare hardware spec is Ready.

15. In Showcase, click Refresh in the upper-right corner. Notice that a Prepare hardware task message appears in the Completed column and another appears in the In Progress column.

    

    View larger image

    

    This is because the first Prepare hardware spec task has been completed with the specification file invalid.pdf. As a result, the business rule causes the task and file to be discarded, and a new user task created.

16. In the Business Central Task Inbox, repeat steps 12 and 13, but upload the valid-spec.pdf file instead of invalid.pdf.
17. Log out of Business Central and log back in again as Katy.
18. Go to Menu Track Task Inbox. There are two Manager approval tasks for Katy, one with the invalid.pdf hardware specification file, the other with the valid-spec.pdf file.

19. Open, claim, and complete each task:

    1. Check the approve box for the task that includes the valid-spec.pdf file, then click Complete.
    2. Do not check the approve box on the task with the invalid.pdf file, then click Complete.
20. Go to Menu Manage Process Instances and open the Order for IT hardware process instance.

21. Open the Diagram tab. The Order rejected and Place order processes are now marked as Completed.

    

    View larger image

    

    Similarly, the case details page in Showcase lists two Manager approval tasks in the Completed column.