Manual Navigation

The Manual Navigation command pauses an agent and allows the end-user to navigate manually in the web browser. When the end-user has finished navigating, he can press a Continue button to continue running the agent. A Manual Navigation command is often used to navigate sections of a website that cannot be automatically processed, such as advanced CAPTCHA pages.


Below screenshot shows the simplest example where the Manual Navigation command can be used.


Command Properties


Command Description: A custom description for the command.Default value is Empty.

Command Transformation Script:  A script used to change command properties at run time. The default value is disabled.

Disabled: This property set to True allows user to disable the command. A disabled command will be ignored. The default value is set to False.

ID:  This property indicates the internal unique ID of the command and is always auto- generated e.g. 58c8e4ac-e4c0-48f7-a63d-77064945380b.

Increase Data Count: This property indicates the data count every time this command is processed. The default value is set to False. Set it to TRUE if you want to get the count of the number of times a specific command is executed to get the data. The data count value is increased during data extraction, so it is used to measure agent progress and basis this increased data count, the agent  decides the success criteria.

Name:  This property specifies the name of the command.

Notify On Critical Error:  A notification email is sent at the end of an agent run if the command encounters a critical error, and the agent has been configured to notify on critical errors. Critical errors include page load errors and missing required web selections. Default value is set to False.


Debug BreakPoint: Debugging will break at this command if the break point is set.Default value is set to False.

Debug Disabled: A disabled command will be ignored during debugging. Default value is set to False.

Debug Error Option: This property specifies what action to take when an error occurs in the debugger. Default value is set to Notify which indicates that when an error occurs at debugging time , then it will be notified. If we want to ignore the error at debug time , then we need to set this property value as Ignore.

Exit or Retry

Condition: The Exit or Retry  condition . Value in the Condition Text area comes from  ‘Condition Type’.

  • Compare to Value: A constant value compared to the input value or selected web content. When comparing input data, the constant value will be converted from a string into the same type as the input data. The operation fails if the conversion fails.
  • Condition Type: The types of condition to check .
    • Compare Data Value: Compares a specified input value with a specified constant.
    • Compare Web Selection: Compares the content of a selected web element  with a specified constant.
    • Compare Last Status Code: Compares the  status code.
    • Condition Script: A script is used to decide if the condition is True  or False.
    • Always True: The Condition is always True.
    • Always False: The Condition is always False.
  • Data Consumer: Specifies the input data to use when processing this command.
    • Captured Data Command: Specifies the previously captured data column name which you want to use as  input data .
    • Data Source:  The source of the data consumed.
    • Data Transformation Script: Data transformation script. Default value is set to Disabled which is reflected by "Enabled" property value False. If you want to enable the data transformation script then you need to set to "Enabled" property value as True.
    • Input Parameter Name : Specifies the input parameter name to use .
    • Provider Column Name: Specifies a column from the data source that should provide the data to this command. specifies a command that provides data to the agent. A command can provide data to itself.
    • Provider Container: Specifies a command that provides data to this command.
  • Data Type: The data type of specified value.
  • HTML  Attributes: Specifies the input data to use when processing this command.
  • Operator: The Operator to use when comparing two values. Some of the operators are unary operators which don’t use the Compare To value. We  use operators such as Exists, Does Not Exists, IsEmpty, IsNotEmpty, Equals, Does Not Equal, Is  Greater Than, Is Greater Than or Equal, Is Less Than , Is Less Than or Equal, Contains, Does Not Contain, Starts With, Ends With, Matches, Does Not Match etc.
  • Script: A script used to define the condition check.
    • C# Script: Specifies C# script.
    • Enabled: To use the Script we need to set this Property as True. The default value is set to False, which indicates that the script is disabled.
    • Library Assembly File: The name of a custom assembly file when "Use Default Library" is set to false.
    • Library Method Name: The method to execute when using the default script library.
    • Library Method Parameter: A custom parameter passed to the script library method.
    • Python Script: Specifies Python script.
    • Regex Script: Specifies Regex script.
    • Script Language: Specifies the scripting language which you want to use e.g C#, VB.NET, Python, Script Library, Regular Expressions.
    • Template Name: The template name of the referenced template.
    • Template Reference: Loads this script from a template when the agent is loaded.
    • Use Default Library: Uses the default script library when Script Language is set to Script Library.
    • Use Selection: The script is provided with the selected web element. The script will not be provided with the selected web element if this value is False.
    • Use Shared Library: Uses a script library that is shared among all agents.
    • VB.NET Script: Specifies VB.NET script.
  • Selection: The selection XPaths of the web elements associated with this command.
    • Paths:  List of selection XPaths.
      • Path:  The selection XPath.

Data Consumer: Specifies the input data to use when processing this command.


Export Enabled: A command with Export Enabled set to false will not save any data to data output. Default value is set to True indicates that data will be output.

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.