How to Call a TIBCO ActiveMatrix BusinessWorks Service from a BPM Process

This tutorial demonstrates the integration of ActiveMatrix BPM and ActiveMatrix BusinessWorks Service Engine. It shows how to create, deploy, and then test a BPM process that calls an ActiveMatrix BusinessWorks Service.

The ActiveMatrix BusinessWorks application provides a simple address lookup service that takes a postal code as an input, and returns the address (if the postal code specified is valid) or an appropriate message.

You should work through each section in turn to complete the tutorial.

  • The business process in this tutorial calls the virtualized service provided by ActiveMatrix BusinessWorks Service Engine via a web service invocation.
  • The input of the business process accepts a postal code as a text string. The ActiveMatrix BusinessWorks process is designed to recognize and return the address for the following postal codes: SN2 8BL, CA 94304, and MA 02144. For all other values, or for an empty postal code, an appropriate error message is returned.
  • The address lookup service uses structured data (xsd:sequence) to return the address of the postal code.
    Note: In this tutorial, the TIBCO Business Studio variant that is installed with ActiveMatrix BusinessWorks Service Engine is referred to as Studio for Designers, and the one installed with ActiveMatrix BPM is referred to as TIBCO Business Studio.
  • You are familiar with the concepts and working of TIBCO ActiveMatrix BusinessWorks and TIBCO ActiveMatrix BusinessWorks Service Engine.
  • You are familiar with WSDLs and schema constructs.
  1. Setting up the Environment
    Software must be installed and configured to set up the environment.
  2. Importing the TIBCO SOA Project and ActiveMatrix BusinessWorks Project
    The projects - TIBCO SOA Project containing the BusinessWorks component, and the associated ActiveMatrix BusinessWorks project - required to test the integration are supplied.
  3. Importing the Simple Organization Model (Optional)
    A simple organization model that can be used in the tutorial is supplied. However, you can choose to use your own organization model to develop and run the tutorial.
  4. Creating the BPM Developer Project
    The BPM project consists of a user task to collect the data - postal code - followed by a call to ActiveMatrix BusinessWorks Service Engine via web services. The output returned by the web service is displayed in a user task.
  5. Importing the ActiveMatrix BusinessWorks Service Engine WSDL
    When you import the WSDL file into the BPM Developer’s project, the associated Business Object Model is generated under the Generated Business Objects folder.
  6. Defining the Business Process
    The service descriptor will be generated from the web service task and the parameters will be mapped automatically based on the business object model defined previously.
  7. Deploying the Applications
    Before deploying the ActiveMatrix BPM project, ensure that the simple organization model that is referenced by the project is deployed.
  8. Testing the Integration Between Applications
    You can use TIBCO Workspace to test the integration.
  9. Using the Schema Construct xsd groups
    The generated BOM when the output type uses the schema construct xsd:groups is similar to the generated BOM for the output type using xsd:sequence.