Branch Command

The Branch command executes a group of commands if a specified condition is met.

The ‘Branch’ command is located under the ‘Other’ icon in the command palette (refer the below snapshot)

In order to make the optimum use of the ‘Branch’ command, we can configure this command by applying transformations. Based on the selection of the XPath, the Branch command accepts conditions. 

Example,

If the condition satisfies, we need to enter the name of the branch, else we need to return an empty string.

Under the ‘Branch’ command, we can configure the options as shown in the below screenshot, as per user requirement.

Command Configuration

The configuration screen for the Branch command has three tabs viz. Browser, Options, and Text. Use the ‘Browser’ tab to select command XPath and apply selection transformations. Use the ‘Options’ tab to set the command name and other command properties. Use the ‘Text’ tab to navigate to the text of the agent where the command part is present.

Command Properties

On the Options tab of the command, we have two options:

1. General Settings

2. Export

General Settings → General Command Settings

The ‘General command settings’ section is designed for user customization to give the command a desired name, comment to describe in brief about the usability or requirement for the command and the disabled option to not execute this command at all.

1. Command name: This property specifies the name of the command.

2. Comments: Provides a field for entering metadata or a brief description regarding the command. These annotations are used internally to provide context for developers or team members. Comments are not part of the exported data and are only used for documentation purposes within the configuration.

3. Disabled:  This checkbox allows the user to disable the command. When checked, the command is ignored during execution. By default, it is unchecked.

General Settings → Selected content

When Content is Missing: This dropdown menu lets users define how the agent should behave when the content is not found. The default option is Fail, meaning the agent will stop execution or log an error and proceed to the next sibling command.

The available options are:

• Fail: The agent will stop and return an error, or if there are parallel commands, it will log the error and move to the next parallel command.

• Warn: The agent logs a warning but continues processing further commands.

• Ignore: The agent neither logs an error nor a warning, and it skips any child commands, moving to the next parallel command.

• Passthrough: The agent ignores the error but continues to execute the child commands.

Selected content: This shows the content selected by the command on the current page. If no content is selected or a selection is missing on the current page, then it will show the message as “No selected Content”. 

Export

Please refer to the “Export” section for more insight.