Red Hat Training

A Red Hat training course is available for Red Hat Process Automation Manager

Chapter 13. Case management Showcase application

The Showcase application is included in the Red Hat Process Automation Manager distribution to demonstrate the capabilities of case management in an application environment. Showcase is intended to be used as a proof of concept that aims to show the interaction between business process management (BPM) and case management. You can use the application to start/close, monitor, and interact with cases.

Showcase must be installed in addition to the Business Central application and Process Server. The Showcase application is required to start new case instances, however the case work is still performed in Business Central.

After a case instance is created and is being worked on, you can monitor the case in the Showcase by clicking the case in the Case List to open the case Overview page.

Showcase Support

The Showcase application is not an integral part of Red Hat Process Automation Manager and is intended for demonstration purposes for case management. Showcase is provided to encourage customers to adopt and modify it to work for their specific needs. The content of the application itself does not carry product-specific Service Level Agreements (SLAs). We encourage you to report issues, request for enhancements, and any other feedback for consideration in Showcase updates.

Red Hat Support will provide guidance on the use of this template on a commercially reasonable basis for its intended use, excluding the provided example UI code provided within.

Note

Production support is limited to the Red Hat Process Automation Manager distribution.

13.1. Installing and logging in to the Showcase application

The Showcase application is included with the Red Hat Process Automation Manager 7.1 distribution in the add-ons Zip file. The purpose of this application is to demonstrate the functionality of case management in Red Hat Process Automation Manager and enable you to interact with cases created in Business Central. You can install the Showcase application in a Red Hat JBoss Enterprise Application Platform instance or on OpenShift. This procedure describes how to install the Showcase application in Red Hat JBoss EAP.

Prerequistes

  • Business Central and Process Server are installed in an Red Hat JBoss EAP instance.
  • You have created a user with kie-server and user roles. Only users with the user role are able to log in to the Showcase application. Users also require the kie-server role to perform remote operations on the running Process Server.
  • Business Central is not running.

Procedure

  1. Navigate to the Software Downloads page in the Red Hat Customer Portal (login required), and select the product and version from the drop-down options:

    • Product: Red Hat Process Automation Manager
    • Version: 7.1
  2. Download Red Hat Process Automation Manager 7.0.0 Add Ons (rhpam-7.1.0-add-ons.zip).
  3. Extract the (rhpam-7.1.0-add-ons.zip). file. The (rhpam-7.0-case-mgmt-showcase-eap7-deployable.zip). file is in the unzipped directory.
  4. Extract the (rhpam-7.0-case-mgmt-showcase-eap7-deployable.zip). archive to a temporary directory. In the following examples this directory is called TEMP_DIR.
  5. Copy the contents of the _TEMP_DIR/rhpam-7.0-case-mgmt-showcase-eap7-deployable/jboss-eap-7.1 directory to EAP_HOME.

    When asked to overwrite files or merge directories, select Yes.

    Warning

    Ensure the names of the Red Hat Process Automation Manager deployments you are copying do not conflict with your existing deployments in the Red Hat JBoss EAP instance.

  6. Add the following system property to your deployment’s EAP_HOME/jboss-eap-7.1/standalone/configuration/standalone-full.xml file: <property name="org.jbpm.casemgmt.showcase.url" value="/rhpam-case-mgmt-showcase"/>
  7. In a terminal window, enter the following command to start Business Central:

    EAP_HOME/bin/standalone.sh -c standalone-full.xml

  8. In a web browser, enter localhost:8080/business-central.

    If Red Hat Process Automation Manager has been configured to run from a domain name, replace localhost with the domain name, for example:

    http://www.example.com:8080/business-central

  9. In the upper-right corner in Business Central, click the Apps launcher button to launch the Case Management Showcase in a new browser window.

    apps launcher showcase button
  10. Log in to the Showcase application using your Business Central user credentials.

13.2. Starting an IT Orders case in the Showcase application

You can start a new case instance for the IT Orders sample case management project in the Showcase application.

The IT Orders sample case management project includes the following roles:

  • owner - the employee who is making the hardware order request. There can be only one of these roles.
  • manager - the employee’s manager; the person who will approve or deny the requested hardware. There is only one manager in the IT Orders project.
  • supplier - the available suppliers of IT hardware in the system. There is usually more than one supplier.

These roles are configured at the case definition level:

Figure 13.1. ITOrders Case Roles

Case Roles

Assign users or groups to these roles when starting a new case file instance.

Prerequisites

Procedure

  1. In the Showcase application, start a new case instance by clicking the Start Case button.
  2. Select the Order for IT hardware case name from the list and complete the role information as shown:

    showcase start case

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

  3. Click Start to start the case instance.
  4. Select the case from the Case List. The Overview page opens.

    From the Overview page, you can monitor the case progress, add comments, start new dynamic tasks and processes, and complete and close cases.

    case management showcase overview
Note

Cases can be started and closed using the Showcase application, but they cannot be reopened using this application. You can only reopen a case using a JMS or REST API call.