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.

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.