Edit XML Locator Dialog
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.
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 Property Picker Dialog and select a property. This field corresponds with the Result Property field from the panel.
button to display theIt 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:
Search | Result Type |
---|---|
Attribute name | Attribute value |
Exists element | |
Element text | |
Attribute value | Attribute name |
Exists element | |
Element text | |
Element text | Element text |
Element has index in the parent | Exists element |
Element text |