Overview:
=========
  This is a very basic example of how to manually define and apply a Message
  Transformation within JBoss ESB.  It applies a very simple XSLT to a
  SampleOrder.xml message and prints the before and after XML to the console.
  
  This Quickstart does not use the JBoss ESB Administration Console to manage
  the message Transformation configurations to the ESB.  See the end of this
  README for details on how to manage this Quickstart's transformations via the
  Console.
  
  Check out the Administration Console Flash demos at:
  	http://labs.jboss.com/portal/jbossesb/resources/tutorials/xformation-demos/console-demos.html

Running this quickstart:
========================
  Please refer to 'ant help-quickstarts' for prerequisites about the quickstarts
  and a more detailed descripton of the different ways to run the quickstarts.

  A comprehensive description of message transformation can be found in
  MessageTransformation.pdf, located in the docs/services folder.

To Run standalone mode:
=======================
  1. In a command terminal window in the quickstart folder type
     'ant deploy-jms-dests'.
  2. In a command terminal window in this folder ("Window1"), type 'ant run'.
  3. Open another command terminal window in this folder ("Window2"), type
     'ant runtest'.
  4. Switch back to "Window1" to see the output from the ESB
  5. When finished, interrupt the ESB using Ctrl-C and, in this folder
     ("Window1"), type 'ant undeploy-jms-dests'.

To Run '.esb' archive mode:
===========================
  1. In a command terminal window in this folder ("Window1"), type 'ant deploy'.
  2. Open another command terminal window in this folder ("Window2"), type
     'ant runtest'.
  3. Switch back to Application Server console to see the output from the ESB
  4. In this folder ("Window1"), type 'ant undeploy'.

What to look at in this Quickstart:
===================================
  As stated above, reading MessageTransformation.pdf would be of great benefit
  in understanding JBoss ESB Transformations.

  jboss-esb.xml:
    The ESB configuration file in this Quickstart simply defines a JMS Listener
    for receiving the contents of the SampleOrder.xml file located in this
    folder.  This XML message will be transformed by this service.  

  smooks-res.xml:
    This file defines the Transformations for the Quickstart.  In this case, it
    simply defines a single XSL transformation for the order line items.

  notifyUpdate Ant target:
    JBossESB Transformations are hot reloadable.  To test this out:
    1.  Redeploy the .esb as an exploded archive.
    2.  Run the sample to view the output ("ant runtest").
    3.  Modify the transformation in the exploded .esb.
    4.  Rerun the sample ("ant runtest").  Transformation should still
        be the same i.e. no update.
    5.  Notify the .esb deployment of the transformation update by
        running "ant notifyUpdate".
    6.  Rerun the sample again ("ant runtest") and notice the
        transformation update.

Playing with this Transformation through the Administration Console:
====================================================================
  To load the Transformation Configurations defined in smooks-res.xml into the
  Admin Console, and have them managed from the Admin Console, do the following:
  
  1. Deploy the console as outlined in MessageTransformation.pdf.
  2. Edit the smooks-cdr.lst file in this folder, commenting out both the
     classpath based listings and uncommenting out the listing for the console
     HTTP URI.
  3. In the console:
    a) Add "Message Exchange Participants" for "A" and "B" through the "Manage
       Message Exchange Participants" form.
    b) Add new "Message Contract" against "A" and "B" for "text/xml:messageAtA"
       and "text/xml:messageAtB" respectively.
       Note: "messageAtA" and "messageAtB" are the Message Namespace values and
       "text/xml" is the Message Mime in both cases.
    c) Import "smooks-res.xml" through the "Import Configurations" form.
  4. You are now ready to start managing the message transformations through the
     console.  You can add more transformations and modify the existing
     transformations.