Customizing Send Action Class - EnterWorks_Process_Exchange_(EPX) - 10.5

EnterWorks EPX Process Modeling

Product type
Product family
Precisely EnterWorks > EnterWorks Process Exchange (EPX)
Product name
Precisely EnterWorks
EnterWorks EPX Process Modeling
Topic type
First publish date

The custom send action class may be used for anything that the user wants to do as part of the send operation. This class will only be called on work items that have the Send Action Class field specified on the Custom Action tab of certain activities. It allows the user to create a custom code that can perform certain actions or tasks before sending the work item to the next activity. Customizing the send action class, for example, can override the date and time specified in the Work Item Key field set on the Delayed Send option. Instead of using the Work Item Key field in delaying the send of the work item, you can indicate the code you created in the Send Action Class field and satisfy the conditions set on that code before sending the work


A sample custom code is made available for your reference if you installed the EPX documents during EPX installation. The file located in the <EPX>\examples\custom directory would be included in your EPX install. The sample program file aims to send the work item to the next activity according to the value set in the sendWaitPeriod variable located in the file.

There are certain steps to follow before you can use the java file in the Send Action Class field:

  1. Edit the build.bat file. Change the values of the variables EPX_HOME and EXAMPLE_JDK_HOME.

Here is an example:



  1. If you want to edit the java file, you can do so by adding more conditions or tasks in it. If you do not want to edit the java file, compile the file by using the build.bat file on Windows or the file.

  2. After compiling, the custom.jar file is created. You need to include this jar file in your application server and webtools classpath.

Note: Do not forget to add a semicolon at the end of the path.

If you are using JBoss as the application server:

  • Go to your JBoss directory <EPX>\bin and edit the: EPX_JBOSS_<port>_wrapper.conf file.

In the EPX_JBOSS_<port>_wrapper.conf file, find the CLASSPATH variable and add at the end, the path of the custom.jar file. A sample path would be D:/Enterworks/EPX/examples/custom/custom.jar;

Also, add the code below at the end of the file:





"D:/Enterworks/EPX/examples/ custom/">


  • On your Tomcat webtool go to the <EPX>\bin directory and edit the EPX_WebServices_<port>_<port>_wrapper.conf and EPX_WebTools_<port>_<port>_wrapper.conf files located in the directory.

Add the classpath:



  1. After adding the custom.jar file on the application server and webtools classpath, you can now use the file. In the Send Action Class field, type in examples.custom.SampleCustomSendAction.

An example would be if both the Work Item Key in the Details tab and the Send Action Class field in the Custom Action tab have valid entries, the value set in the sendWaitPeriod variable located in the file would override the value specified in the Work Item Key.