Conditional Loop

Operation name

Conditional Loop

Function Overview

Repeat processing when the specified conditions are satisfied.

Conditional Loop Configuration

Icon Name Description
Start Conditional Loop Start of Conditional Loop.
End Conditional Loop End of Conditional Loop.

Properties

For details on use of variables, refer to “Variables”.
Basic settings
Item name Required/Optional Use of variables Description Remarks
Name Required Not available Enter the name to show on the script canvas.  
Required settings
Item name Required/Optional Use of variables Description Remarks
Condition list Optional - Specify conditions to continue loop processing.

Each column can be operated with the following buttons.
  • [Add]:
    Add a column.
  • [Up]:
    Move the selected column upwards by one row.
  • [Down]:
    Move the selected column downwards by one row.
  • [Delete]:
    Delete the column.
  • The maximum number of [Condition list/Condition] is 253.
  • For priority of conditions, refer to here.
Condition list/Condition Optional Not available Specify conditions.

A specified variable can be compared with a fixed value or another variable.
  • Condition type
    • [Comparison between variable and fixed value]: (default)
      Select to compare a variable with a fixed value.
    • [Comparison between variable and variable]:
      Select to compare a variable with another variable.
  • Condition details
    The condition options differ depending on the selected variable type as follows.
    • Integer/Decimal type variables
      • [equal to]:
      • [not equal to]:
      • [less than]:
      • [greater than]:
      • [not more than]:
      • [not less than]:
    • String type variables
      • [equal to]:
      • [not equal to]:
      • [start with]:
      • [not start with]:
      • [end with]:
      • [not end with]:
      • [contain]:
      • [not contain]:
    • Boolean type variables
      • [equal to]:
      • [not equal to]:
  • Variable types that can be specified in loop operation are as follows.
    • Integer
    • Decimal
    • String
    • Boolean
  • Depending on the variable type specified in the left-hand side of the condition, the condition detail and the variable type in the right-hand side will change.
Condition expression Optional Not available Conditional expressions specified in [Condition] are displayed as string.  
Property actions
Item name Description Remarks
[and]/[or] Select [and] or [or].  
Edit parentheses Specify the priority of conditions using parentheses.  
Log settings
Item name Required/Optional Use of variables Description Remarks
Change log settings Optional Not available Select whether or not to temporarily change log settings of the loop processing.
  • [Checked]:
    Log settings will be changed.
  • [Not checked]: (default)
    Log settings will not be changed.
  
Output log Optional Not available Select whether or not to output log.
  • [Checked]: (default)
    Output log.
  • [Not checked]:
    Do not output log.
  • Enabled when [Change log settings] is checked.
Log level Optional Not available Select a log level to be set.
  • [NOTICE]:
  • [INFO]: (default)
  • [FINFO]:
  • [FINEST]:
  • [DEBUG]:
  • Enabled when [Output log] is checked.
Comment
Item name Required/Optional Use of variables Description Remarks
Comment Optional Not available You can write a short description of this adapter.
The description will be reflected in the specifications.		  

Right-click Menu

Icon Item name Description Remarks
Fold/Expand Show/hide icons between [Start Conditional Loop] and [End Conditional Loop].
When folded, only [Start Conditional Loop] will be displayed.

PSP Usage

PSP is not supported.

Available Component Variables

Component variable name Description Remarks
count The number of loops is stored.
  • Default value is null.

Priority of Conditions

Priority of conditions is as follows.

How to operate Conditional Loop

Create Conditional Loop

Place operations to loop between [Start Conditional Loop] and [End Conditional Loop].

Specification Limits

Major Exceptions

None.

Sample

The following script is an example of using Conditional Loop to execute Launch External Application operation 3 times.
  1. Create a script as follows.



  2. The property settings for Conditional Loop operation are as follows.



    Use component variable “count” of Conditional Loop operation.

  3. Check the result in the execution log view after executing the script.