XML Locator
Search
In this field you can select the search criteria.
This field corresponds with 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 a XML element specified in the below value field.
- Attribute value
- The search will be performed using the attribute value of a XML element specified in the below value field.
- Element text
- The search will be performed using the text value of a XML element specified in the below value field.
- Element has index in parent
- The search will be performed using the index number of a XML element specified in the below value field.
Value
In this field you can define the value for the search operation. This field corresponds with the Value field from the panel.
If an Element has index in 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 of use the button to display the Property Picker Dialog and select a property. This field corresponds with the Result Property field from the panel.
It is highly advised to use public properties. A
public property has it's 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 a 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 parent | Exists element |
| Element text |