Lab 7 - Running rewards process

Time to run the rewards project

Time to run our new rewards process by submitting ourselves for a reward, evaluating this award as the HR department in the user task, submit that decision in the form provided, and verify that the personnel file got updated. We also need to verify that we were notified of the results with an email.

Running Rewards - What about that email?

We have an email task, but no local SMTP mail server? Another problem, email tasks need configuration at project level, so let's start with configuring the email task handling in the project:

This is done with a Work Item Handler (WIH), nothing more than the code behind the service task
We'll use an email WIH that sends to local SMTP server on port 25
Open the project assets view with Menu -> Projects -> (click on) rewards -> Settings

Running Rewards - Install email service task

Select in menus:

Service Tasks -> Email
In right pane click on the Email item Install button

Running Rewards - Configure email service task

Fill in the following fields:

Host: 127.0.0.1
Port: 25
Leave the rest of the fields blank and click on Install button

Running Rewards - Using local SMTP server

Mail is now inbound on port 25, we need a server to listen for it:

Download the latest fakeSMTP-latest.zip
Unzip fakeSMTP-latest.zip for a jar file: fakeSMTP-[VERSION].jar
Launch form console with java -jar fakeSMTP-[VERSION].jar
It captures emails on port 25 after clickoing on Start Server

Running Rewards - Build the project

From project assets view, click on top right BUILD button:

Verify build successful in bottom Alerts pane:

Running Rewards - Deploy the project

Now let's deploy the project by clicking on top right DEPLOY button. If deployed previously, a pop-up appears asking if you want to replace the existing build artifact. Click OVERRIDE to replace the build artifact:

Running Rewards - Successful deployment

If all goes well you'll see a green pop-ups verifying the deployment. Note that deploying also triggers a build:

Running Rewards - Navigate to process definitions

Let's take a look at the process definition deployment by selecting via top Menu -> Manage -> Process Definitions:

Running Rewards - Open process definition

This opens the Manage view pane where you'll see our Rewards definition. Later you can use the drop-down menu at the top to jump between different views. We're going to open the Rewards definition by clicking on it:

Running Rewards - Start a process instance

This view offers choice of definition details or image of the process. Clicking on the button: New Process Instance starts a new process instance:

Running Rewards - Fill in start process form

You're presented with your previously created start process form in a pop-up. Add some valid input data and click on SUBMIT:

Running Rewards - Examining process instance details

A new screen displays the process id and other instance details. Now note the Current Activities and select the Diagram tab for a visual status view of process:

Running Rewards - Examining process instance details

Note the process instance is waiting at the user task, let's open our task inbox to view it:

Running Rewards - Open user task inbox

Open task inbox from Menu -> Track -> Task inbox:

Running Rewards - About the task assignment

Remember we assigned Approve Reward tasks to group Manager and our user is a manager, so the task Approve Reward waits on us. Note the filter at the top applied to show READY, IN PROGRESS, RESERVED status tasks only:

Running Rewards - Claim your user task

Click on Approve Reward task to open. Note that it's waiting for first status of a user task, so click on CLAIM to take ownership:

Running Rewards - Start your user task

The task is now ready for the next stage, so click on START to being the task and make the form editable:

Running Rewards - Complete your user task

Approve the task (or reject), check (or not) the box Approve, then submit the task by clicking on COMPLETE:

Running Rewards - Adjusting task inbox filters

The task is no longer in the inbox, it's due to the filter at the top. Click the filter line to remove, note the Approve Reward task is now green and completed:

Running Rewards - Review process instance (again)

If all went well our process instance is completed, so let's check:

Open the instance with Menu -> Manage -> Process Instance
Instance is not listed due to filter, so remove State: Active

Running Rewards - Open process instance (again)

Click on the rewards process instance to open:

Running Rewards - Verify process instance completion

After opening, select the DIAGRAM tab to view complete process visual status. We see there should be a message in the logs simulating a personnel file entry for reward approval. We also see there should be an approval email waiting for us:

Running Rewards - Verify business level logs

To verify the logging, see Logs tab, but it's business level logging:

Running Rewards - Verify developer level logs

Let's check the server logs, back in the console used to start from. We see there the entire run of our process including the logging and email sent messages. Let's go see what our fakeSMTP server has captured for us: