GUI: Capture Web Page
Description
Capture Web Page takes a screenshot of the active browser page or a specific element on it and saves the result as a PNG image file. Use this step when your workflow needs to capture visual evidence — for example, saving a confirmation screen, documenting error states, or creating audit-trail screenshots. You can choose to capture the entire web page or target a specific element using criteria and locator values. An Add Image File To Result option lets you attach the captured image to the workflow result, and an Ignore Errors option allows execution to continue even if the capture fails.
Configurations
| Field Name | Description |
|---|---|
| Step name | Name of the step. The name must be unique in a single workflow. |
| Web Browser Name | Select any one web browser from the list. Note: Select the same name, which is selected in the Start Browser step. |
| Capture Web Page Options | Select which part of the web page of the active web browser you want to capture. You can capture the entire web page or an element on the page. Available options are: Capture web page Or Capture element. Note: Criteria, Criteria Value, Element Index and Iframe Indices fields are available if Capture Element option is selected. |
| Criteria | Select the criteria based on which you want to capture an element on the web page. |
| Criteria value | Select or specify relevant criteria value for the selected criteria. |
| 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 |
| 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 |
| 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']. |
| Frame ID | Provide the current Iframe Id to target a specific iframe to perform the action. Default Value: frameID |
| Output Image File Name | Select or specify the name with which you want to save the image file. Note: This field only supports files with a .png extension. |
| Button: Browse | Click to browse the output image path. |
| Checkbox: Add Image File To Result | Select the checkbox if you want the image file available in the workflow result. |
| Checkbox: Ignore Errors | Select the checkbox if you want the workflow to continue executing by ignoring errors in the step. |