Editing a Target

If the target is not identified correctly during project execution, you can edit the target and its anchors after you have indicated it by selecting > Edit Target in the body of the activity. This opens the selection mode with the target and any identified anchors highlighted. A menu is displayed when you hover the mouse over a target or anchor.

• To remove a target or an anchor, hover it, and then click Delete in the hover menu. If you remove a target, the first element you click is added as the new target.
• To add an anchor for a target, click the element to add as an anchor. Depending on the settings of your project, you may need to click Add Anchor in the hover menu of the target first. You can add up to three anchors for each target.

• To edit a target or an anchor, hover it, and then click Settings in the hover menu. The properties of the methods used for detecting the element can be edited from the Advanced Settings section of the Selection Options window:

  • Selector / Fuzzy Selector

    • Edit the selector using the corresponding text box. To copy the selector for pasting in another element or for editing in the UI Explorer, click Copy next to it.

      You can use variables in attribute values. The variables must be surrounded in double curly brackets, for example <wnd name='da{{var1}}'/> adds the value of var1 to the selector. The default value of the variable is used at design time. For information on how to create variables for selectors, see Creating Variables for Use in Selectors.

    • For Fuzzy Selectors, you can change the Selector Accuracy level by dragging the corresponding slider from 0.4 to 1. This measurement expresses the level of similarity between the attribute you are searching for and the one to be found. To find results with a higher similarity, increase the value. The default value is 0.7.

      You can find more information about selectors in the Studio guide.

  • Image

    • Change the Image Accuracy level by dragging the corresponding slider from 0.4 to 1. This measurement expresses the level of similarity between the image you are searching for and the one to be found. In situations when the image to be found can be slightly different than the one you are searching for, you can lower the accuracy. The default value is 0.8.
  • Disable / enable a method by clearing / selecting the check box next to the method name.
  • Verify how unique a method is by clicking Show all matches next to it. This checks all the elements in the window and highlights all that have similarities with the currently selected element in yellow.

  • Click Apply to save the changes, and then click Validate if you want to validate the selection. To save the selection, click Confirm.

    
    

    

    
    

Validating Your Selection

Validation enables you to check how effective the current selection is in identifying the target by checking it using all selected methods and anchors. The result of the validation is displayed at the top of the Selection Options window. If adjustments are needed, a message is displayed with information on how to improve the selection.

The performance of each method is displayed in the Advanced Settings section of the Selection Options window using one of the following icons:

The method was the first to successfully identify the element.

The method successfully identified the element.

The method failed to identify the element because too many duplicates were found.

The method failed to identify the element.

Creating Variables for Use in Selectors

You can create variables from the Use Application/Browser activity and most other container activities. The scope of the variable is within the activity where it is created.

To create a variable for use in a selector:

1. In the title bar of a container activity, select Settings > Value Mappings.

2. In the Value Mappings window, click Add, and then provide the following information:

   • Name - Enter a name for the variable. The name should follow naming conventions.

   • Value - Click Plus on the right side of the field, and then use one of the options in the menu to indicate the value to use at runtime. For example, you can enter text, select a cell from an Excel file, or select a previously saved for later text value. The variable type is string.

     
     

     

     
     

After a variable is created, you can add it to selectors in activities added inside the container where it was created. For more information, see Editing a Target. The variable can also be selected from the Plus menu of compatible activity fields inside the container.

For an example of how to use variables in selectors, watch the following video.