GUI: ComboBox Actions
Description
GUI: ComboBox Actions plugin step allows user to select the list item from the ComboBox.
Prerequisites
- If you want to use Java technology in the step, ensure you have Java 1.8 32-bit installed on your system. For details on installing Java 1.8 and setting up access bridge, see Appendix: Java access bridge installation
- If you want to use Web technology in the step, ensure valid extensions are added to corresponding web browser.
Limitation
The step will not work for Java and Windows technologies on Linux.
For Java technology:
- The scaling factor of the machine must be 100% only.
- Resolution and scaling of workflow recorder machine and workflow runner step must be same.
- This release does not support minimizing frames or maximizing internal frames. Designers can use GUI: Universal Actions step for robot handling
- Max Timeout in step configuration is only applicable for Java and Windows technology.
Known issues
- For Java technology: When the Access Bridge is configured to run the GUI Java automation steps, then SAHI automation will not work.
- For Windows technology: When using SPY, the ComboBox Action step name does not appear in the Step Name field of the dialog.
Configurations
| No. | Field Name | Description |
|---|---|---|
| 1 | Step Name | Name of the step. The name must be unique in a single workflow. The data type is string and the field is mandatory. |
| 2 | Technology | Select the technology used by the target application: Java, Web, or Windows. The data type is string and the field is mandatory. |
| 3 | Action Information | Click to open the Action information dialog. Select the field details, as required. Click OK, and the selected Action Information details appear in the tabular format. Note: The fields will change depending on the selected technology. The data type is string, and the field is mandatory. |
| For Windows/Java Technology | Provide the following field details in the Action Information dialog | |
| I. | Window Path | Window Path is the relative\absolute path of the Windows application on which element exists. It is captured by GUI Spy in the Generate Step dialog. It is then populated in the step configuration upon Step Generation. You may also enter or modify Windows path manually on the Step Generation window or step configuration. Windows path may be provided as a String or regex. Sample of Windows Path as string: w[Desktop]/w[Application Name], w[Desktop]/w[/Application N/], w[Desktop]/w[/Application .*/]. If you are providing partial application name then put it as a regex between / and /. Also, if the Application name changes dynamically, it is a good idea to provide it as a regex. Java: Provide the Window Name on which automation actions should be performed.For example, Windows Name: AutomationEdge Applet App Window Path is the relative\absolute path of the Windows application on which element exists. It is captured by GUI Spy in the Generate Step dialog. It is then populated in the step configuration upon Step Generation. You may also enter or modify Windows path manually on the Step Generation window or step configuration. Windows path may be provided as a String or regex. Sample of Windows Path as string: w[Desktop]/w[Application Name], w[Desktop]/w[/Application N/], w[Desktop]/w[/Application .*/]. If you are providing partial application name then put it as a regex between / and /. Also, if the Application name changes dynamically, it is a good idea to provide it as a regex. Java: Provide the Window Name on which automation actions should be performed. For example, Windows Name: AutomationEdge Applet App Users can also utilize a regex pattern to match the window name, instead of specifying the exact window name of Java Application. For example: Suppose the Java application window title is, “Oracle Apps 2024-11-26“, a user can provide: - Oracle Apps \d4-\d2-\d2 - ^Oracle - Any other valid regex |
| II | Element Index(Starts with 0) | For Multiple elements with same criteria, specify index of the element you want to locate. Provide index 0 if you want first element from the located elements, increment index by 1 for the next elements. Default Value: 0. |
| III. | Criteria | ‘Criteria’ is the criterion to locate element on Windows Desktop\Java application It is captured by Windows Spy in the Generate Step dialog. Upon Step Generation it is populated in the step configuration. You may change criteria by choosing from list in Step Generation window or step configuration. |
| IV | Criteria Value | Specify relevant criteria value for the criteria provided above. |
| V | Action Type | Choose any of the following options: - Select Item If chosen, the Selection By and Selection Value fields are shown - Read Value If chosen, the Read Type and Output Field fields are shown. The data type is string and the field is mandatory. |
| In Action Type | If you choose Select Item, then provide following field details: | |
| a. | Selection By | Select any of the following options from the list: - Name. - Index |
| b. | Selection Value | Select or specify the value of the item as a name or index value. Note: In the Selection By field, if you select: - Name: Select item name from the list. For example, India. - Index: Specify the index value, which starts from 0. |
| In Action Type | If you choose Read Value, then provide following field details: | |
| a. | Read Type | Select any of the following option from the list: -Selected Value -All Options. If the Read Type Is Selected Value, then the field holds the selected dropdown value. If the Read Type Is All Options, holds all available dropdown options. Note: Option is available only for Java technology. |
| b. | Output Field | Provide name which hold the result on successful execution. Default Name: Result. |
| For Web Technology | provide the following field details in the Action Information dialog: | |
| I. | Web Browser Name | Select Web Browser Name from the given list. Note: Select the same Web Browser Name, which was selected in Start Browser Step |
| II | Element Index(Starts with 0) | Specify the index of the element you want to locate. Note: One can also specify First or Last. First, if you want the first element from the located element or specify Last if you want the last element. Default Value: 0 |
| III | Criteria | ‘Criteria’ is the criterion to locate elements on Web GUI. GUI Spy can capture it in the Generate Step dialog. Upon Step Generation, it is populated in the step configuration. You may change criteria by choosing from the list in the ‘Step Generation’ window or step configuration. Note: For list and description of criteria values, See Criteria Table. The data type is string, and the field is mandatory. |
| IV | Criteria Value | Specify relevant criteria value for the criteria provided above. It is a mandatory field. |
| V. | Iframe Indices | Specify Iframe Indices value. Specifying Iframe indices ensures that the target element is identified correctly within the nested frame structure. You can provide comma-separated values. For e.g. 0,1,2 |
| VI. | Iframe Xpath | Iframe Xpath is a uniquely generated path that represents the location of an <iframe> or <frame> relative to the top-level window. Iframe Xpath identifies each frame using a unique attribute such as id, name, or title if available, for example, iframe[@id='mainFrame']. If no such attributes exist, the frame is identified by its position among sibling frames, like iframe[2] for the second iframe. For nested structures, each frame is joined in sequence to form a full path. For example, if an element is inside an iframe[@id='outer'], which contains a frameset with a frame[@name='middle'], and that frame contains iframe[@title='inner'], the generated path would be: iframe[@id='outer'];frame[@name='middle'];iframe[@title='inner']. Note: If an iframe or frame has no id, name, or title, its origin (i.e., the src URL) will be used as a fallback in the path for unique identification. For example: iframe[@origin='https://example.com']. |
| VII | Frame ID | Provide the current Iframe Id to target a specific iframe to perform the action. Default Value: frameID |
| VII. | Selection By | Method to select value from the dropdown. Values: Index: Suppose located dropdown has 3 options "A, B, C", now if you want to select "A" give the index value as "0" and so on. VisibleText: Visible Text is the value of the option which user can see on the web page. |
| VIII | Selection Value / Selection Value(Starts with 0) | Relevant value needs to be specified for the method selected in Selection By. Note: 1.If Index is selected in Selection By, provide value in field Selection Value (Start with 0). 2.If Value or Visible Text is selected in Selection By, provide value in field Selection Value |
| 4 | Max Timeout (In Second) | Specify the timeout value for the action to be performed. |
| 5 | Step Description | Describe the intended action for better step-row clarity. It is a mandatory field. |
| Common Buttons: | ||
| No | Field Name | Description |
| 1 | Edit Element | Click Edit Element to start spying and change step details as desired. Opening spy from step is restricted to the scope of the step. i.e. only relevant elements are detected with active spy. Use Hotkeys (‘Shift’ or ’~’) to detect the element. For better understanding call it, Step Restricted Spy. For example, suppose spy is started from ComboBox Selection step. Now spy is restricted to elements that support ComboBox Selection. All elements that support ComboBox Selection will be highlighted in blue color and the rest will be highlighted in red color upon hover. Notice Step dropdown is disabled and the selected value is ComboBox Selection. Note: Option is visible for Java Technology or Windows Technology. |