Apama 10.15.0 | Connecting Apama Applications to External Components | Correlator-Integrated Support for the Java Message Service (JMS) | Using the Java Message Service (JMS) | Mapping Apama events and JMS messages | Using the XPath Helper | Setting node properties
 
Setting node properties
The XPath Helper enables you to set a node in the document tree (shown in the left pane of the XPath Helper dialog) as the target, key, or root node.
*To set node properties
1. Right-click a node in the left pane of the XPath Helper dialog.
2. From the resulting context menu, choose one of the following commands:
Command
Description
Set Target
Sets the node as the target (indicated with a red circle). Enables you to test whether the selected node is present in the result set of an XPath expression. It also enables you to test whether that node appears once or multiple times in the result set.
When you evaluate the XPath expression, the number of hits found for the selected node is shown in the Results pane. If the target node appears in the result set only once, the Results pane displays the message Reached target uniquely, and the target indicator (red circle) in the left pane of the XPath Helper dialog changes to a check mark. If the node appears more than once, it displays the message Reached target with the target indicator changed to a check mark. If it does not appear at all, it displays the message Did not reach target and the target indicator remains as it is.
Remove Target
Removes the current target.
Set Key
Sets the selected node as the key (indicated by a yellow key symbol) and displays the appropriate XPath expression in the text area of the XPath Expression tab.
Each time you set a key, a text box is shown next to the key symbol where you can enter a condition or constraint.
You can also enter a condition or constraint in the text area of the XPath Expression tab.
Remove Key
Removes the current key.
Set Root
Sets the selected node as the root. Only the subtree starting from this node will be considered as the input parameter for evaluating and generating XPath expressions. 
Remove Root
Removes the current root.