How to Deliver Work by Email

The body of the email message contains a link to either TIBCO Openspace or TIBCO Workspace (depending on which BPM client you are using) and to the location of the work item.

Clicking this link enables you to open the work item directly from the email message. If, when you installed your BPM runtime you specified localhost in your client properties, the link points to localhost rather than the actual address for TIBCO Openspace or TIBCO Workspace. As the work item is not on the localhost, the link does not resolve. To change this, you must amend the following properties in the EmailChannelProperties.properties file:

  • For TIBCO Openspace BaseOSFormAppUrl=http://localhost:8080/openspace/openform
  • For TIBCO Workspace - BaseGIFormAppUrl=http://localhost:8080/workspace

The EmailChannelProperties.properties file is located under the folder BPM_CONFIG_FOLDER/tibco/data/bpm/configuration/. On Windows platforms, the default value for BPM_CONFIG_FOLDER is C:\ProgramData\amx-bpm\tibco\data.

This tutorial shows you how to deliver work by email by editing email attributes and pushing an email notification to a user for a work item.

Note: This tutorial assumes that you have an smtp server installed locally. Please contact TIBCO if you require assistance with this procedure.

You should be familiar with the basics of designing, implementing and deploying process-based applications using TIBCO Business Studio. If you are not familiar with these things, you should run through the previous tutorials before attempting this one.

Before you start this tutorial, you can become familiar with TIBCO Business Studio by completing the initial WelcomeUsers tutorials.

After completing the tutorial, you will be able to specify that email notifications of work will be pushed to users, and to enter email attributes that control how work will be displayed to a user at runtime.

  1. Importing the Initial Resources
    Import a project containing a simple organization model to which your business process can refer.
  2. Creating the Project
    Create a basic project containing a user task which can be used to generate a work item.
  3. Creating the Business Service
    The application uses a business service to pass the input parameters (the value of the Customer Name field) to the start event of the business process.
  4. Editing the Email Attributes in the Presentation Channel
    Push notification means that notification of a work item is pushed out to a user via email.
  5. Deploying the Project
    You can now deploy the project. You should already have a deployment server available, for example the one you created in the How to Implement and Deploy the WelcomeUsers Application tutorial.
  6. Editing and Using Organizational Entity Push Destinations
    In a pushed distribution model, when a work item is generated, it is sent to a user as an email. The email contains the URL of the work item, which the user can click to open and process the work item.
  7. Verifying the Results
    You can verify the results of your tutorial by installing the tutorial from the samples folder in the product directory. Your project must look similar to the sample solution project.