Page Area List Command

The Page Area List command is used to select a list of elements on a web page. When executed, the parent command and all its sub-commands run once for each web element in the list with the web selection of each sub-command being relative to the current element.

To add this command, simply select a list of elements on the web page and click the "List" button, as shown in the screenshot below:

In order to make the optimum use of the Page Area List command, we can configure the options as can be observed in the snapshot, as per the user requirement.

Command Configuration

The configuration screen for the Link Repeater command has three tabs viz. Browser, Options, and Text. Use the Browser tab to select command XPath and apply selection transformations. Use the ‘Options’ tab to set the command name and other command properties. Use the Text tab to navigate to the text of the agent where the command part is present.

Command Properties

On the Options tab of the command, we have three options:

1. General Settings

2. List

3. Export

General Settings → General Command Settings

The ‘General command settings’ section is designed for user customization to give the command a desired name, comment to describe in brief about the usability or requirement for the command and the disabled option to not execute this command at all.

• Command name: This property specifies the name of the command.

• Comments: Provides a field for entering metadata or a brief description regarding the command. These annotations are used internally to provide context for developers or team members. Comments are not part of the exported data and are only used for documentation purposes within the configuration.

• Disabled:  This checkbox allows the user to disable the command. When checked, the command is ignored during execution. By default, it is unchecked.

List → Selected list elements

When list element missing: This option specifies what happens if the selection does not exist in the current page. The drop-down provides the option to select the action to be performed when a selection is missing. The Default Value is “Fail”.

• Fail:  It specifies if this selection does not exist in the current page then it Fails the agent from that command and doesn’t execute further.

• Warn: It specifies if this selection does not exist in the current page then it ignores the current command as well as sub-commands and logs a Page Load error.

• Ignore: It specifies if this selection does not exist in the current page then it ignores the current command as well as sub-commands.

• Passthrough: It specifies if this selection does not exist in the current page then it ignores the current command, but executes sub-commands of the command.

Selected list element: This shows the content selected by the command on the current page. If no content is selected on the current page or a selection is missing on the current page then it will show the below Message: “No selected Content”

List → List settings

Process List in Parallel: This setting allows you to choose how the list will be processed. It includes an option to enable or disable parallel processing by clicking the checkbox. By default, this checkbox is unchecked, indicating that "Process List in Parallel" is disabled.

• Disabled (default): When this option is selected, the list will be processed in a single session, meaning each element will be handled one at a time in a sequential manner. 

• Enabled: When this option is selected, the list will be divided and processed across multiple sessions (assuming the agent supports session ranges and a valid session range is specified).

Export

Please refer to the “Export” section for more insight.