Sequence Template

A Sequence Template is a parametrized sequence , providing an abstract or generic form of a sequence defined in the WSO2 Enterprise Integrator (WSO2 EI). Parameters of a template are defined in the form of XPath statement/s. Callers can invoke the template by populating the parameters with static values/XPath expressions using the Call Template Mediator, which makes a sequence template into a concrete sequence.

1 Configuration | 2 Syntax | 3 Call Template Mediator

Configuration

Let's illustrate the sequence template with a simple example. Suppose we have a sequence that logs the text "hello world" in four different languages.

<sequence>
   <switch source="//m0:greeting/m0:lang" xmlns:m0="http://services.samples">
        <case regex="EN">
            <log level="custom">

      		  <property name=”GREETING_MESSAGE” value=”HELLO WORLD!!!!!!” />

   	    </log>
        </case>
        <case regex="FR">
	    <log level="custom">

      		  <property name=”GREETING_MESSAGE” value=”Bonjour tout le monde!!!!!!” />

   	    </log>
        </case>
	<case regex="IT">
	    <log level="custom">

      		  <property name=”GREETING_MESSAGE” value=”Ciao a tutti!!!!!!!” />

   	    </log>
        </case>
	<case regex="JPN">
	    <log level="custom">

      		  <property name=”GREETING_MESSAGE” value=”???????!!!!!!!” />

   	    </log>
        </case>
    </switch>

</sequence>

Instead of printing our "hello world" message for each and every language inside the sequence, we can create a generalized template of these actions, which will accept any greeting message (from a particular language) and log it on screen. For example, let's create the following template named "HelloWorld_Logger".

<template name="HelloWorld_Logger">
   <parameter name="message"/>
   <sequence>
        <log level="custom">
      		  <property name=”GREETING_MESSAGE” expression=”$func:message” />
   	</log>
   </sequence>
</template>

With our "HelloWorld_Logger" in place, the Call Template mediator can populate this template with actual hello world messages and execute the sequence of actions defined within the template like with any other sequence. This is illustrated below.

<sequence>
   <switch source="//m0:greeting/m0:lang" xmlns:m0="http://services.samples">
        <case regex="EN">
            <call-template target="HelloWorld_Logger">
		<with-param name="message" value="HELLO WORLD!!!!!!" />
	    </call-template>
        </case>
        <case regex="FR">
	    <call-template target="HelloWorld_Logger">
		<with-param name="message" value="Bonjour tout le monde!!!!!!" />
	    </call-template>
        </case>
	<case regex="IT">
	    <call-template target="HelloWorld_Logger">
		<with-param name="message" value="Ciao a tutti!!!!!!!" />
	    </call-template>
        </case>
	<case regex="JPN">
	    <call-template target="HelloWorld_Logger">
		<with-param name="message" value="???????!!!!!!!" />
	    </call-template>
        </case>
    </switch>

</sequence>

The Call Template mediator points to the same template "HelloWorld_Logger" and passes different arguments to it. In this way, sequence templates make it easy to stereotype different workflows inside WSO2 EI.

Syntax

<template name="string">
   <!-- parameters this sequence template will be supporting -->
   (
   <parameter name="string"/>
   ) *
   <!--this is the in-line sequence of the template     -->
   <sequence>
        mediator+
   </sequence>
 </template>

The sequence template is a top-level element defined by the name attribute in WSO2 EI configuration. Both endpoint and sequence template starts with a template element.

The parameters available to configure the Sequence Template are as follows.

Parameter Name	Description
Name	The name of the Sequence Template
onError	Select the error sequence that needs to be invoked.
Trace Enabled	Whether or not trace is to be enabled for the sequence.
Statistics Enabled	Whether or not statistics is to be enabled for the sequence.
Template Parameters	The input parameter that are supported by this Sequence Template.

Sequence template parameters can be referenced using an XPath expression defined inside the in-line sequence. For example, the parameter named "foo" can be referenced by the Property mediator (defined inside the in-line sequence of the template) in the following ways:

<property name=”fooValue” expression=”$func:foo” />

or

<property name=”fooValue” expression=”get-property('foo','func')” />

Using function scope or "?func?" in the XPath expression allows us to refer to a particular parameter value passed externally by an invoker such as the Call Template mediator.

Call Template Mediator

For more information, see the following topics: