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.

Conditional branch (Else If)

After an IF block has been added to a task, you can add one or more Else If branches to evaluate additional conditions when the preceding IF (or earlier Else If) condition is not met.

Note: Else If can only be added after an existing IF block. You can chain multiple Else If branches under a single IF.
To add an Else If branch:
  1. Select the IF block (or an existing Else If branch) in your task.
  2. Click Add Conditional (Else If) Branch.
  3. Configure the condition using the same fields as an IF block.
  4. Add the steps that should run when this Else If condition is true.
Each Else If branch is evaluated only if all of the conditions above it (the IF and any earlier Else If branches) evaluated to false.

Default branch (Otherwise)

The Otherwise branch runs when none of the preceding IF or Else If conditions in the chain are met. It acts as a default or catch-all path and does not require a condition of its own.

Otherwise can only be added after an existing IF block or Else If branch. A branch chain can contain at most one Otherwise.

To add an Otherwise branch:
  1. Select the IF block (or an existing Else If branch) in your task.
  2. Click Add Default (Otherwise) Branch.
  3. Add the steps that should run when no earlier condition in the chain matched..
Because Otherwise has no condition, it always runs when reached, that is, only when every IF and Else If above it evaluated to false.