Control Flow

Do While

This activity executes the activity contained in its body at least once, until the specified condition evaluates to false.

Activity Parameters

The Do While activity has only one parameter and it can be provided by manually inserted values or via IN arguments or variables:

Parameters:

• Condition (text box editor type) (type: boolean): the condition that must be met in order to execute the activity in the body of the Do While. It can be either an explicit condition input directly in the Condition field (as seen in the example above), or via a Boolean variable/IN argument. 

Example:

The following basic example will remove all instances of an IP (192.168.0.11) from a previously defined collection of IPv4 IPs (where it appears twice):


This time, the condition will be provided via a boolean variable (IPexists), which dictates the Do While activity to loop until the the IP is not found in the collection anymore. It has been initialized to True to make sure it enters the Do While sequence at least once

The two getElementFromCollection activities have been added to the workflow to compare the contents of the Collection before and after the Do While activity run.

Before:

After:

ForEach

This activity executes the activities in its body for each element found in a collection/array.

Activity Parameters

The ForEach activity properties can be provided via manually inserted values or via IN arguments or variables:

Parameters:

• Values (text box editor type) (type: dependant on TypeArgument): the collection/array that the activity will iterate. On each iteration, the body of the ForEach activity will be executed.
  
• TypeArgument (ComboBox type): the type of the elements in the collection/array that the activity will iterate.

Example:

This basic example will use the Iterator to go through the collection of IPs (IPv4Collection defined above) and test the connection for each one using a PowerShell script activity contained in the ForEach body.

If

This activity runs an activity/sequence of activities if a condition is true, and can optionally run activities if the condition is false.

Activity Parameters

The If activity properties can be provided via manually inserted values or via IN arguments or variables:

Parameters:

• Condition (text box editor type) (type: boolean): the condition that decides which child activities will be executed
  
  

Example:

This basic example will iterate a previously defined collection of IPv4 addresses, and when a specific one is found (validated via an If activity), test its connection.

The IPv4Collection variable definition:

In this example, the Else branch has been left empty, therefore no activity will be performed against the Iterators that do not meet the condition (Iterator="191.168.0.14").

Parallel

This activity that executes all child activities simultaneously and asynchronously. It completes when all its child activities are completed or when the completion condition is met.

Activity Parameters

The Parallel activity properties can be provided via manually inserted values or via IN arguments or variables:

Parameters:

• CompletionCondition (text box editor type) (type: boolean): the optional condition that decides when the parallel activity is completed. If left blank, the activity is marked as completed when all its branches are completed.

Parallel ForEach

This activity iterates a collection of elements of the same type and executes all child activities simultaneously and asynchronously per each element. It completes when all its child activities are completed or when the completion condition is met.

Activity Parameters

The Parallel ForEach activity properties can be provided via manually inserted values or via IN arguments or variables:

Parameters:

• CompletionCondition (text box editor type) (type: boolean): the optional condition that decides when the parallel activity is completed. If left blank, the activity is marked as completed when all its branches are completed.
• TypeArgument (ComboBox type): the type of the elements in the collection/array that the activity will iterate.
• Values (text box editor type) (type: dependant on TypeArgument): the collection/array that the activity will iterate. On each iteration, the body of the ForEach activity will be executed.

Sequence

This activity runs a set of child activities based on a single defined ordering.

Activity Parameters

The Sequence activity has no paramaters except the its DisplayName which can be customized for easier usability.

Switch

This activity selects one choice from a number of activities to execute, based on the value of a given expression.

Activity Parameters

The Do While activity has only one parameter and it can be provided by manually inserted values or via IN arguments or variables:

Parameters:

• Condition (text box editor type) (type: boolean): the condition that must be met in order to execute the activity in the body of the Do While. It can be either an explicit condition input directly in the Condition field (as seen in the example above), or via a Boolean variable/IN argument. 

Example:

The following basic example will remove all instances of an IP (192.168.0.11) from a previously defined collection of IPv4 IPs (where it appears twice):


This time, the condition will be provided via a boolean variable (IPexists), which dictates the Do While activity to loop until the the IP is not found in the collection anymore. It has been initialized to True to make sure it enters the Do While sequence at least once

The two getElementFromCollection activities have been added to the workflow to compare the contents of the Collection before and after the Do While activity run.

Before:

After: