Add Conditional Branch (IF block)

This topic applies to Advanced tasks.

A conditional branch (IF block) defines a condition, and the set of actions to be performed if that condition is met or not met. You can configure a conditional branch anywhere in an Advanced task, including inside a file loop. Any task element except a schedule can appear inside a conditional branch.

A conditional branch takes an action one time if the condition is met. To take an action more than one time, for example, on each file, place the conditional branch inside a File Loop.

Requirements: The conditional branch (IF block) requires the following elements:

The item to be acted upon (for example file name matches *.txt). The condition can act on source files or on the values of task parameters
The action to take if the file meets the condition. Actions include pulling files from a specified source, pushing files to a specified destination, or running the process.

To access this dialog box: Click TASKS. Create a new Advanced task, or select an existing one. Click Step > Conditional (If). Specify a location for the conditional branch by clicking Insert Here.

Conditional branch (IF)	Description
Item to evaluate	The item to evaluate with the condition. Options: File name, file size, file timestamp, file error code, task error code, custom macro. For task parameter values, use a custom macro. For more information, see Macro Keywords.
Condition Operator	Selections correspond to the type of item to evaluate. For example, for File Size, operators are = (equal to) != (not equal to), > (greater than), >= (greater than or equal to), < (less than), <= (less than or equal to).
Value	Value to match/not match. Selections correspond to the type of item to evaluate. For example, for File Timestamp, selections include a number, and type of unit (hours, days, months, or years ago).
Add condition	Click to add another condition. With multiple conditions, the options Match any / Match all become available.

To Add Default (Else) Branch:

Click Step > Conditional (if) and specify a location by clicking Insert Here.
In the row for the IF branch, click the gear icon and select Add Default (Else) Branch. The Else branch is added directly after the conditional branch, and has the label Otherwise.