WSO2 Business Process Server v3.0.1 Documentation

##### Overview

- Home
- Release Note
- WS-BPEL Compliance
- License

##### Downloads

- Releases

##### Installation Guide

- Installing WSO2 BPS

##### Quick Start Guide

- Modeling the process
- Deploying the process
- Testing the process

##### User Guide

- Deploying BPEL Processes
- Deploying Human Tasks
- Managing BPEL processes
- Managing BPEL process instances
- QoS for BPEL processes
- Securing BPEL processes
- Invoking secured partner services
- Versioning
- Management API

##### Human Task Guide

- Human Tasks Quick Start Guide
- Deploying HumanTasks
- Managing Tasks
- Developing a Human Task Artifact
- Human Task Management and Configuration
- Human Task Concepts

##### Administrator Guide

- External data sources Configuration
- Registry Configuration
- Events
- Unified Endpoints
- BPEL Extensions
- Transaction Factory Configuration
- Message Exchange Interceptors
- OpenJPA specific properties
- JMS Transport Configuration
- Process Instance Cleanup Tasks
- Process Hydration and Dehydration
- Enabling Peer-to-Peer(P2P) Communication
- Setting up a BPS Cluster

##### Best Practices

- Process Deployment Best Practices

##### Concepts

- Process Versioning
- Process instance events
- Partner links

##### WS-BPEL Extensions

- Activity Failure and Recovery
- Extension Activities and Extensible Assign Operations
- XPath Extensions
- Iterable ForEach
- Flexible Assigns
- BPEL4People Extension

##### Samples

- HelloWorld
- If-Else
- ForEach
- While
- Repeat Until
- Flow and Links
- Pick
- Synchronous and Asynchronous Service Invocations
- Fault Handling
- Split
- XslTransform
- Compensation Handler
- Event Handler

##### Resources

- FAQ
- External Articles
- Library
- Source Code

##### Community

- Forum
- Mailing Lists

##### Project Information

- Issue Tracking

# Sample Guide - ForEach

### Table of Content

- Objective
- Prerequisites
- Overall Idea

### Objective

Explains the functionality of <forEach/> construct, where, user can implement repetitive tasks. The tasks can be sequential or parallel based on `parallel` property. So <forEach/> becomes advantageous comparing to <while/> or <repeatUntil/>, when the repetitive tasks are parallelized.

### Prerequisites

- Log in into BPS server admin console.
- Under Business Processes -> Add BPEL.
- Upload the TestForEach.zip , (all samples are located at our sample repository.)
- Under the Business Processes -> Processes.
- Under the WSDL details widget -> Create instance

### Overall Idea

    <forEach  parallel="no" counterName="ForEachCounter">
        <startCounterValue>"1"</startCounterValue>
        <finalCounterValue>"3"</finalCounterValue>
        <scope bpmn:label="ForEach">
            <sequence>
                <assign>
                    <copy>
                        <from>concat($thisStartRequestMsg.body/text(), $ForEachCounter)</from>
                        <to>$thisStartRequestMsg.body</to>
                    </copy>
                </assign>
            </sequence>
        </scope>
    </forEach>

In this sample, 3 iterations take place based on the values of <startCounterValue/> and <finalCounterValue/>.

The property `counterName` can be used as a local variable inside the child scope to store current iteration value. In the above example, `ForEachCounter` variable value can be 1,2 or 3.

Then inside <scope/>, repetitive task can be implemented.

Note : <forEach/> can have only one <scope/> child.