Edit XML Locator Dialog

Edit XML Locator

XML Locator

Search

In this field, you can select the search criteria. This field corresponds to the Locator Type field from the panel. The following search options are available:

  • Attribute name
  • The search will be performed using the attribute name of an XML element specified in the below value field.
  • Attribute value
  • The search will be performed using the attribute value of an XML element specified in the below value field.
  • Element text
  • The search will be performed using the text value of an XML element specified in the below value field.
  • Element has index in the parent
  • The search will be performed using the index number of an XML element specified in the below value field. The index is 0 based and represents the order number of an element among the other children of a certain parent.
  • Element exists
  • The search will be performed using the element name without specifying the index in the parent.

Value

In this field, you can define the value of the search operation. This field corresponds to the Value field from the panel.

Caution!If an Element has index in the parent criteria is selected the value field must contain only integer numbers and is a 0 based value. In case a string is supplied the search operation's found value will always return the current element.

Store

If this checkbox is enabled the search operation's found value will be stored inside a property.

This field corresponds with the Result Type field from the panel. The type of the search operation's found value can be one of the following:

  • Attribute name
  • The name of the element's attribute that meets the search criteria will be returned by the search operation.
  • Attribute value
  • The value of the element's attribute that meets the search criteria will be returned by the search operation.
  • Exists element
  • The name of the element that meets the search criteria will be returned by the search operation.
  • Element text
  • The text contained by the element that meets the search criteria will be returned by the search operation.

in

In this field, you can specify the Advanced Installer property where the resulted value will be stored. You can write the name of the property or use the [ ... ] button to display the Property Picker Dialog and select a property. This field corresponds with the Result Property field from the panel.

TipIt is highly advised to use public properties. A public property has its name written in capital letters. If in this field a property is written which is not previously declared, it will be created only if the search proves to be successful; otherwise, it will not exist.

The following combinations for an XML locator are possible:

SearchResult Type
Attribute nameAttribute value
Exists element
Element text
Attribute valueAttribute name
Exists element
Element text
Element textElement text
Element has index in the parentExists element
Element text