XML Search Properties

File Path

This field specifies the search path and the XML filename on which the search operation will be executed. This field is of Formatted Type and can be edited using the Advanced Installer Smart Edit Control. The name of the XML Search operation will also display this path.

Locators

This field will display in the left pane the XML Search Elements which contain the XML locators based on which the search operations are performed. Multiple XML elements can be defined and under every XML element multiple XML locators can be created. For every XML element the locators can be declared or modified in the XML Locator view in the right pane.

XML Search Elements

In this panel you can create, delete or modify the position in the node hierarchy of the XML elements. The following operations are possible:

New Element

A new XML element can be created by selecting [ New Element ] from the context menu or by pressing the Insert key while the left panel if focused.

Rename an element

To rename an XML element select [ Rename ] from the context menu or press the F2 key while the element is selected.

Move Up

To move the selected node up use [ Move Up ] option from the context menu or press Shift+Up Arrow key keys while the element is selected.

Move Down

To move the selected node down use [ Move Down ] option from the context menu or press Shift+Down Arrow key keys while the element is selected.

Move Left

To move the selected node to the left use [ Move Left ] option from the context menu or press Shift+Left Arrow key keys while the element is selected.

Move Right

To move the selected node to the right use [ Move Right ] option from the context menu or press Shift+Right Arrow key keys while the element is selected.

Delete an element

To delete an element use [ Delete ] from the context menu or press the Delete key while an element is selected.

Warning!The hierarchy of the XML elements defined here must be the same with the one from the actual XML file. If the structure is different in the XML file no search operation can be performed.

TipOnce an XML element is created it is possible to assign one or multiple XML locators from the XML Locator panel.

XML Locator

This panel will display the XML locator assigned for the selected XML element from the XML Search Elements panel. Based on this XML locator the XML Search operation will be performed. It is possible to declare multiple XML locators for one XML element.

Create an XML locator

To create a new XML locator press the [ Add... ] button, use "Add..." context menu option or press the Insert key while the list is focused. The Edit XML Locator Dialog will appear.

Modify an XML locator

To modify an existing XML locator press the [ Edit... ] button, use "Edit..." context menu option or press the Space key while an element is selected. The Edit XML Locator Dialog will appear.

Delete an XML locator

To delete an existing XML locator press the [ Remove ] button, use "Remove" context menu option or press the Delete key while an element is selected.

NoteIf multiple XML Locators are defined you can modify the order in which the searches are performed. The order in this list is the order in which the search operations are executed.

Move Up an XML locator

To move an XML locator up press the [ Up ] button, use the "Move Up" context menu option or press the PageUp key while an XML locator is selected.

Move Down an XML locator

To move an XML locator down press the [ Down ] button, use the "Move Down" context menu option or press the PageDown key while an XML locator is selected.

Warning!If one of the search operations assigned to an XML element fails, all the search operations assigned to that element will fail and no search result property will be set for any of the search operations assigned to that element.

TipIf you want each search to be evaluated individually you can define the same element multiple times, maintaining the same hierarchy, and assign to each instance an XML locator.

Topics