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).

Note: Conditional branch (IF) matching is not case-sensitive.

Add criterion

Click to add another condition.

With multiple conditions, the options Match any / Match all become available.