Home » Java » Enterprise Java » Beginners Guide: How to Configure an Email Service Task for Red Hat Process Automation Manager

About Eric Schabell

Eric D. Schabell
Eric is Red Hat’s Portfolio Architect Director. He's renowned in the development community as a speaker, lecturer, author, and baseball expert. Follow on https://www.schabell.org.

Beginners Guide: How to Configure an Email Service Task for Red Hat Process Automation Manager

Recently I’ve been updating my free online workshops, specifically the series based on JBoss BPM Suite so that you can get started with the newerRed Hat Process Automation Manager.

In this article I’m sharing something that I’ve stumbled on while trying to use email notifications in my automation project.

I discovered while updating this project that the email service task, a task type that should allow you to send emails from a process, is not pre-configured out of the box. Not only that, I’m unable to find the solution online for Red Hat Process Automation Manager.

Email Service Task

Let’s fix that shall we and take a look at what’s needed to get our emails flowing in our processes?

Configuring email tasks

Many years ago I published a few articles aroundautomating email user tasks.  This included details requiring adjusting the underlying JBoss Enterprise Application Server mail configuration, but with the current version 7.2 we’re using that’s working for your local machine right out of the box.

Email Service Task
<outbound-socket-binding name="mail-smtp">
     <remote-destination host="localhost" port="25"></remote-destination>

As you can see, the localhost port 25 will be used for binding all email activity our Red Hat Process Automation Manager generates, so all we need to do is configure our current project to process the email task correctly.

Email Service Task

There are a few concepts in using a service task like email in our project. First off, any service task requires aWork Item Handler (WIH) to be defined for handling the task. In our case it’s defining the email task to use a WIH that’s included in the product, but not pre-configured for our projects.

The second item is that you’ll need something to listen to port 25 and process the messages our email task generates. Normally you’d setup some sort of SMTP or email server, but that’s a bit much for just testing our process. We’ll be using a simple java solution to capture these messages and display them in a simple inbox.

Email Work Item Handler

First, let’s look at configuring the project itself to make use of a specific handler specification. From the project assets view shown, shown in figure 2, select the settings tab. This provides all the project configuration options and we’ll start on the left side choosing deployments and then work item handlers.

Email Service Task

From there we add a new work item handler and fill in the details for the email handler as shown in figure 3. For completeness the details are included here so you can cut-and-paste them in to your projects.


new org.jbpm.process.workitem.email.EmailWorkItemHandler(“localhost”, “25”, “”, “”, “true”)

Save these settings and you can now build and deploy this project with an email task sending emails on the localhost SMTP over port 25.

Email Service Task

The final question is how can we capture these emails on port 25 without setting up our own SMTP server?

Capturing email

Included in the Red Hat Process Automation Manager installation demo project (used in the online workshops) you’ll find in the support directory a java helper application called fakeSMTP.

This project provides a simple java application you can run as shown in figure 4, which once started provides a SMTP server and inbox capture. Run this before executing any process that is configured as shown in this article and your emails are sent, processed, and captured in this application.

For more details on how that looks you can see thefree online workshop lab 7 which details it all for you step by step.

Happy automation integrating!

Published on Java Code Geeks with permission by Eric Schabell, partner at our JCG program. See the original article here: Beginners Guide: How to Configure an Email Service Task for Red Hat Process Automation Manager

Opinions expressed by Java Code Geeks contributors are their own.

(0 rating, 0 votes)
You need to be a registered member to rate this.
Start the discussion Views Tweet it!
Do you want to know how to develop your skillset to become a Java Rockstar?
Subscribe to our newsletter to start Rocking right now!
To get you started we give you our best selling eBooks for FREE!
1. JPA Mini Book
2. JVM Troubleshooting Guide
3. JUnit Tutorial for Unit Testing
4. Java Annotations Tutorial
5. Java Interview Questions
6. Spring Interview Questions
7. Android UI Design
and many more ....
I agree to the Terms and Privacy Policy
Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Inline Feedbacks
View all comments