Definition and Usage
This command sets the selected option for a drop-down list in a window form. It allows you to select an option from a dropdown menu either by specifying the text of the option or by using the index number of the option in the list.
Parameter Values
Input parameters
Parameter | Description | Possible Values | Required | Options / Notes |
Element | Select or capture an element to operate on | - | Yes | Use the Capture button to select the dropdown element |
Select by | Select an option of the drop-down list by text or index | Text, Index | Yes |
|
Option text | Enter the text to select the option | - | Yes (if "Select by" is "Text") |
|
Match by | Select option content match mode | Fuzzy matches, Text equals, Regex match | Yes (if "Select by" is "Text") | Default is "Fuzzy matches" |
Option index | Enter the index value to select the option | - | Yes (if "Select by" is "Index") | Index typically starts from 0 |
Advanced settings
Parameter | Description | Possible Values | Required | Options / Notes |
Wait after execution (s) | Wait for a specified number of seconds after the action is executed | - | No | Default is 1 second |
Element timeout (s) | Wait time for element to appear (seconds) | - | No | Default is 20 seconds |
Error handling
Parameter Name | Description |
Throw error & stop | When an error occurs, the action will trigger an error and stop the execution of the entire app. |
Retry command | If an error occurs, the action will retry the command in an attempt to resolve the issue and continue the process. |
Ignore error & continue | When an error occurs, the action will be ignored, and the workflow will continue without interruption. |
Variables produced
This action doesn't produce any variables.
Using Variables in Conditions
Parameters with the {x} icon can accept variables. You can insert variables created earlier in your workflow by clicking on the {x} button and selecting the appropriate variable. This is particularly useful when the dropdown option you want to select is determined dynamically during workflow execution.
Notes
Before using this command, ensure the dropdown element is visible and accessible on the screen.
When using "Text" selection mode, "Fuzzy matches" will find options containing the specified text, "Text equals" requires an exact match, and "Regex match" allows for pattern matching.
Index-based selection is useful when the text of options might change but their position remains constant.
If the element cannot be found or the specified option is not available, the command will result in an error based on your error handling settings.