Surface Set Value
Description
Surface Set Value enters text or data into a screen element identified through image recognition. Use this step when you need to type into input fields, text boxes, or other editable areas in remote or virtual environments — such as Citrix sessions — where standard UI object handles are not available. It locates the target element by matching a reference image, then performs the input action at a specified position (left, right, center, or a custom relative offset). This step is commonly used alongside Surface Click and Surface Get Value to build complete form-filling workflows on image-based screens.
Configurations
| Field Name | Description |
|---|---|
| Step Name | Name of the step. This name has to be unique in a single workflow. |
| Match Pattern | - Retrieve Single closest match: It searches for and retrieves a single closest match. If the image is not found or multiple matches are found, then it throws an error. - Retrieve Multiple close matches: It searches for matching patterns and retrieves the closest matches. - Retrieve All matches: It searches for and retrieves all matches (not below 50% or above 150% of the original size). |
| Position | Choose position o selected image to Set Value action. |
| Left | Center left position of the image |
| Right | Center right position of the image |
| Center | Center of image |
| Custom | Relative position from the entire Image. It could be anywhere on the screen. If the relative position of the relative element to click is closer it is preferable. |
| Image Index | Image index is generated by the image locator of surface spy. |
| Timeout(in seconds) | Specify a timeout in seconds to locate the image. |
| Image | Depicts the image with respect to which we need to Set Value. |