GUI: Web Loop Table
Description
GUI: Web Loop Table step is allow user to traverse through an HTML table in Web GUI automation. Either entire table or specific columns can be the output. The Web Loop Table step is designed to be used within a loop. On drag n drop of this new step, Continue step is also added on the canvas and the validations are same as the Start Loop- Continue Loop steps. Each row of the table is processed for a single iteration (The rows to be processed are specified in the Loop Tab as All or specific rows or based on a condition). Processing of all the rows specified for a single iteration completes a loop. The input row and additional fields are passed in the false path after all the rows (as specified in the Loop Tab) are processed.
Validations:
- If the workflow is using switch case for path decisions inside loop or error handling, all of them must end with Loop Continue Step.
- Both the steps must be present and connected properly in the workflow.
- Infinite loop will not be verified.
- Cannot have Blocking Steps in the loop.
- Steps like Merge Join, Join Rows which wait for all rows before execution start will not be allowed in the loop.
- Row generating steps like Microsoft Excel Input are not allowed in a loop.
Configurations
| No. | Field Name | Description |
|---|---|---|
| 1 | Step Name | Name of the step. This name must unique in a single workflow.The data type is string, and the field is mandatory. |
| 2 | Loop Name | Contains Loop table name with its unique Id. |
| 3 | Web Browser Name | Select any one Web Browser Name from the given list.Note: Select the same web browser name which was selected in Start Browser Step. |
Web Table Tab:
| No. | Field Name | Description |
|---|---|---|
| 1 | 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. |
| 2 | Criteria Value | Provide the value of the element locator to search with. |
| 3 | Element Index (Starts with 0) | If you have checked Multiple elements with same criteria specify index of the element you want to locate.You may also select option FIRST if you want first element from the located element and select LAST if you want last element.Default Value: 0 |
| 4 | 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. |
| 5 | 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']. |
| 6 | Frame ID | Provide the current Iframe Id to target a specific iframe to perform the action. Default Value: frameID |
| Get Value(s) Table: | ||
| 7 | Table Column Index (Starting from 0) | Specify column index to be retrieved. For multiple columns, mention column index on different rows. |
| 8 | Output Field Name | New field to store the retrieved value of the respective column for each row. |
Tab Loop:
| No. | Field Name | Description |
|---|---|---|
| 1 | Checkbox: Conditional Loop? | Checkbox to activate the Conditions block, else Number of rows is active. |
| 2 | Number of rows | Uncheck to Conditional Loop? Check to enable the field. Specify the number of rows to pass through the loop. Select the following values: -All -First -Last Also, a text box is provided to enter a numeric value N, in case First or Last is selected. |
| Table: Additional Fields | This table is used to create user defined additional fields. Additional fields are added as columns to the row. They are permanent and visible even after the loop is over.Note: Any fields created within a loop are not permanently available after loop execution. Only Additional fields specified in Loop Start are available even after loop execution. | |
| 3 | Name | Provide names of all additional fields you want to define. |
| 4 | Type | Select a data type for the additional field. |
| 5 | Format | Select a format for the data Type selected above. |
| 6 | Default value | Provide a default value for the additional field. |
| 7 | Set empty string? | Select Y or N. If default value is not provided set ‘Set empty string?’ to Y. This sets a null value as an empty string. |
| 8 | Block: Conditions For more detailed description with screen shots refer Start Loop step. | Conditions Block is a set of five fields. These fields can be populated with Previous field, Addition fields or Static values. Click the field to populate a value as a toggle or from a popup that comes up. The first field specifies a toggle for a condition. Leave it default to blank or click once to toggle it to NOT. The second is the field to compare. The third field is an operator The fourth field is the field to be compared against or alternately specify a static value in the sixth field to be compared against. Click on the small rectangular icon on the right-hand side of the block to add a condition. You can Add a condition with the following operators: OR, AND, OR NOT, AND NOT, XOR. Multiple condition list by icon on right sideRight click on a condition to get a pop-up menu with the following options: Edit condition, Delete condition, Add sub - condition, Move condition to sub-condition (-->), Move condition to parent (<--) and more copy options. These options can be used to create Nested conditions. |
| 9 | Button: Get Fields | In the Conditions Block above only previous fields are available.Click Get Fields to make Additional fields also available in the conditions block. |