Using Mediation to Transform and Route an Event to TIBCO BPM

TIBCO Business Studio can be used to create a mediation flow that routes the incoming request to the correct service implementation (either US or UK service) based on the country name contained in the incoming request message.

Prerequisites

You should be familiar with the basics of designing, implementing and deploying composites and mediation components using TIBCO Business Studio. If you are not familiar with these things, you should run through the following tutorial before attempting this one:

  • How to Create and Package a Content-Based Routing Mediation Flow - You can find this tutorial in the TIBCO Business Studio Help under Help > Cheat Sheets > TIBCO SOA Development > Mediation, and elsewhere.
  • Each WSDL used in this tutorial implements a call to an Apache Axis2 web service. Before you begin, you must deploy these web services to a J2EE server (such as Apache Tomcat) that is running version 1.4.1 of the Axis2 engine.

Procedure

  1. Download the AddressServiceAARs.zip file to a temporary directory and unzip it. The zip file contains the following Axis2 web service archives:
    • AddressService.aar
    • UKAddressService.aar
    • USAddressService.aar
  2. Deploy the three aar files to a J2EE server that is running the Axis2 engine, version 1.4.1.

    See http://ws.apache.org/axis2/index.html for more information about Axis2.

  3. Make sure that these web services have been properly deployed and are running.

Result

If you wish to deploy and test a project that invokes the services implemented in this project, you will need to have completed the How to Call a Web Service From a Process tutorial.

  1. Creating a TIBCO SOA Project
    Use the SOA Resource wizard to create a new SOA project.
  2. Importing the WSDL Files
    The wsdl files that you need for this project are provided with TIBCO Business Studio.
  3. Creating and Configuring the Mediation Flow Diagram
    In this procedure you create the diagram that defines the mediation flow.
  4. Adding a Route Mediation Task
    To associate the LookUpAddress operation from the Mediation Interface with the target operation you need to perform some steps.
  5. Adding Transform Mediation Tasks
    To associate the LookUpAddress operation from the Mediation Interface with the target operation you need to perform some steps.
  6. Creating the Shared Resources
    You must create the substitution variables which will be bound to the shared resources variables; then create the shared resources themselves; and then carry out the binding.
  7. Configuring the Mediation Composite
    Use the Composite Editor to configure the Mediation Composite.
  8. Creating the Service
    This procedure shows how to create the service.
  9. Creating the References
    This procedure shows you how to create the references.
  10. Creating the Distributed Application Archive
    The Distributed Application Archive (DAA) is what is deployed to the node.
  11. Importing a Tutorial Solution
    The solution to the tutorial is provided in the TIBCO Business Studio installation.