Retry Command
Retry command is used to retry a container command if the condition is true.
The ‘Retry’ command is located under the ‘Other’ icon in the command palette (refer the below snapshot)
In order to make the optimum use of the ‘Retry’ command, we can configure this command by applying transformations. Based on the selection of the XPath, the Retry command accepts conditions.
Example,
If the condition satisfies, we need to enter the name of the retry command, else we need to return an empty string.
Under the ‘Retry’ command, we can configure the options as shown in the below screenshot, as per user requirement.
Command Configuration
The configuration screen for the Retry 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:
General Settings
Retry
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.
Command name: This property specifies the name of the command.
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.
Disabled: This checkbox allows the user to disable the command. When checked, the command is ignored during execution. By default, it is unchecked.
Retry → Selected retry command
When retry command 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 retry command: 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”.
Retry → Retry settings
The ‘Retry settings’ section gives the user the ability to determine the number of retries agent controller should make before returning an error or skipping the content. It also contains option the row in case no content loads post given retries.
Max. retries: This setting defines the maximum number of attempts a container command will make before stopping. The default value is set to 5, but users can adjust it as needed.
Action after max. retries: Once the maximum retry count is reached, this option dictates the next step:
Continue - The agent moves on to process the next command, ignoring the retry limit.
Exit Parent - The parent command exits after the retry actions are specified.
Exit Retry Target - Exit from a specific command which is specified in the condition after specifying retry actions.
Delete data row on exit: This property value when set to True deletes the current data entry when exiting. This will delete the current data row generated by the closest parent list command. The Default value is set to False and does not delete the current data row entry when exiting.
Random delay between retries: The number of seconds the agent will delay a retry. By default this option is Disabled/Unchecked.