Customize how objects are identified (Windows only)

You can instruct LeanFT which identification properties to use for learning test objects or child objects in the Object Identification Center (OIC).

  1. Open the Setting dialog box in one of the following ways:

    • Right-click the LeanFT runtime engine icon in the task bar and select Settings
    • From your IDE's LeanFT menu > Engine and Object Identification Settings.
  2. In the Object Identification tab, you can specify two sets of properties:

    Tip: These object identification settings apply only on the computer where you configure them. If you plan to identify objects on other computers, you can use the Export and Import buttons to export the settings from the current computer, and import them on multiple computers.

    To ensure that all settings are properly preserved, configure the object identification using this dialog box only, and not via the XML file used in previous versions.

    • Identify by. These properties are always used when learning an object or child objects. In addition, the properties listed in the Identify by list are shown as the recommended properties when spying on an object.
    • Assist with. These properties are used only when the regular properties (shown in the Identify by list) are not enough to uniquely identify an object. In that case, LeanFT uses as few of the properties as necessary to get a unique description, according to the order in the list.
    • To select properties to use for identifying an object:

      1. Select the object on the left.
      2. On the right, drag properties from the Available properties list to the Identify by or Assist with property set.
      3. Save your changes.
  3. Restart the LeanFT runtime engine.

    After the LeanFT runtime engine restarts, the new object identification settings are applied every time you spy or learn child objects in the OIC.

Tip: You can restore original test object identification settings by clicking the Restore button.


For a WebElement object, you have specified the following properties in the Object Identification settings:

In the OIC, if the Assist with properties are not needed, they are not displayed as part of the recommended properties:

However, if the Assist with properties are needed, then they appear in the Spy:

See also: