|Table of Contents|
<iterate [sequential=(true | false)] [continueParent=(true | false)] [preservePayload=(true | false)] (attachPath="xpath")? expression="xpath"> <target [to="uri"] [soapAction="qname"] [sequence="sequence_ref"] [endpoint="endpoint_ref"]> <sequence> (mediator)+ </sequence>? <endpoint> endpoint </endpoint>? </target>+ </iterate>
The parameters available to configure the Iterate mediator are as follows.
|Iterate ID||The iterate ID can be used to identify messages created by the iterate mediator. This is particularly useful when aggregating responses of messages that are created using nested iterate mediators.|
This parameter is used to specify whether the split messages should be processed sequentially or not. The processing is carried based on the information relating to the sequence and endpoint specified in the target configuration. The possible values are as follows.
This parameter is used to specify whether the original message should be preserved or not. Possible values are as follows.
This parameter is used to specify whether the original message payload should be used as a template when creating split messages. Possible values are as follows.
The XPath expression used to split the message.. This expression selects the set of XML elements from the request payload that are applied to the mediation defined within the iterate target. Each iteration of the iterate mediator will get one element from that set. New messages are created for each and every matching element and processed in parallel or in sequence based on the value specified for the Sequential Mediation parameter.
To form new messages, you can specify an XPath expression for elements that the split elements are attached to (as expressed in Iterate expression).
Each Iterate mediator has its own target by default. It appears in the mediation tree as shown below once you configure the above parameters and save them.
The parameters available to configure the target configuration are as follows.
|SOAP Action||The SOAP action of the message.|
|To Address||The target endpoint address.|
This parameter is used to specify whether split messages should be mediated via a sequence or not, and to specify the sequence if they are to be further mediated. Possible options are as follows.
The endpoint to which the split messages should be sent. Possible options are as follows.
You can configure the mediator using XML. Click switch to source view in the Mediator window.