The SIBLING and SIBLING_VALUE properties specify the name and value of the sibling node of an .xml property. Sibling nodes have the same parent node.
SIBLING and SIBLING_VALUE exist as attributes of the XML_PATH node. For more information, see XML_PATH.
Use SIBLING and SIBLING_VALUE together when an XML_PATH value refers to a rule or template node with an .xml hierarchical location that has multiple properties in the path.
Example 1
The following shows an excerpt from a dimension rule file. The property names are the values of the CATEGORY nodes VHL_VisibleLineStyle, VHL_HiddenLineStyle, and VHL_OccludedLineStyle. Each property value is contained in the VALUE node that is a sibling of that property's <CATEGORY> node. In the following example, the respective category property values are Double Chain Black Matchline, Dotted, and Dashed Red.
<RULE>
<ACTION>
<CATEGORY>VHL_VisibleLineStyle</CATEGORY>
<VALUE type="string">Double Chain Black Matchline</VALUE>
</ACTION>
<ACTION>
<CATEGORY>VHL_HiddenLineStyle</CATEGORY>
<VALUE type="string">Dotted</VALUE>
</ACTION>
<ACTION>
<CATEGORY>VHL_OccludedLineStyle</CATEGORY>
<VALUE type="string">Dashed Red</VALUE>
</ACTION>
</RULE>
In the common properties schema file, if you specify the .xml location for the VHL_HiddenLineStyle property as <XML_PATH>RULE/ACTION/VALUE</XML_PATH>, the software does not read all of the properties at that path, and thus uses the VALUE node that corresponds to the VHL_VisibleLineStyle category because it is the first node in the path. To correct this ambiguity, use the SIBLING and SIBLING_VALUE properties in the common properties schema file to specify which VALUE node in the rule file contains the hidden line style.
Example 2
The following shows how to use SIBLING and SIBLING_VALUE to specify the VALUE node containing the hidden line style.
<XML_PATH LOCATION="Rule" SIBLING="CATEGORY" SIBLING_VALUE="VHL_HiddenLineStyle">RULE/ACTION/VALUE</XML_PATH>
LOCATION="Rule" specifies that the CATEGORY and VALUE nodes exist in the rule .xml file (as opposed to the template .xml file). For more information, see LOCATION.