Web Loop Table
Description
The step is used to traverse through an HTML table in Legacy Web GUI. 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
| Field Name | Description |
|---|---|
| Web Browser Name | You can select any one Web Browser Name from the given list. Basically, you must select the same Web Browser Name which was selected in Start Browser Step. |
Web Table Tab:
| Field Name | Description |
|---|---|
| Swift mode | Select the checkbox if you want the table records to be read quickly.The checkbox is selected by default. **Important:**If an existing workflow already contains the step, then you will need to manually select the checkbox. |
| Criteria* | Choose the element locator from the list. |
| Criteria value | Provide the value of the element locator to search with. |
| Multiple elements with same criteria | Check this option if there are multiple web elements in the web page having same criteria value you have specified. By default, it will be unchecked. |
| Element index | 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. |
| Get Values Table: | |
| Table Column Index | Specify column index to be retrieved. For multiple columns, mention column index on different rows. |
| Output Field Name | New field to store the retrieved value of the respective column for each row. |
Loop Tab:
| Field Name | Description |
|---|---|
| Conditional Loop? | Checkbox to activate the Conditions block, else Number of rows is active. |
| Number of rows | Specify the number of rows to pass through the loop. Select the following values: - All Rows - 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. |
| Name | Provide names of all additional fields you want to define. |
| Type | Select a data type for the additional field. |
| Format | Select a format for the data Type selected above. |
| Default value | Provide a default value for the additional field. |
| 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. |
| 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 side Right 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. |
| 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. |
*Criteria The table below contains the description of criteria.
| No. | Field Name | Description |
|---|---|---|
| 1 | Xpath | Xpath defines the hierarchy of the tags through which you can reach to a particular element. For example /html/body/div[1]/div/div[3]/div[2]/div/div[2]/div/div/div[2]/div[2]/div[1]/div[1]/div[1]/span/span |
| 2 | Id | Id attribute of a web element can be best way to identify an element if it is present and is going to constant and unique. There are cases however when it is either absent or its value changes every time you access the application in the browser |
| 3 | Name | Name is another attribute of a web element which can be used to identify an element. |
| 4 | Link Text | If a HTML page contains a hyperlink element <a href=www.google.com>Search On Google</a>, you can identify this href element by providing complete text ‘Search On Google’ as the Link value. |
| 5 | Partial Link text | This criterion is same as Link, just that, in this case, you can give partial string for finding a match |
| 6 | Tag Name | Every HTML element has a tag associated with it. The element can be located using that tag name. For example, textbox has a tag <input>. |
| 7 | Class Name | Class name is the css class associated with an HTML element. If there is a div element <div class=’someclass’>MyDiv</div>, you can locate it by giving class name ‘someclass’. |
| 8 | Css Selector | This criterion is useful when an HTML element has multiple associated css classes. Consider an HTML element <div class="btn primary-btn submit"></div>. To identify this div element you can use Css selector as “.btn.primary-btn.submit” |