A SYN element specifies synonyms and processing settings for a particular DIMENSION value.
Synonyms provide alternative ways of describing and consequently, searching a particular dimension. If you created your dimension elements within the Endeca Developer Studio, Developer Studio generates XML with the same name for SYN and DIMENSION value.
<!ELEMENT SYN (#PCDATA)> <!ATTLIST SYN DISPLAY (TRUE | FALSE) #REQUIRED SEARCH (TRUE | FALSE) #REQUIRED CLASSIFY (TRUE | FALSE) #REQUIRED >
The following sections describe the SYN element's attributes.
DISPLAY
Specifies which synonym is displayed to the user. TRUE indicates the synonym is displayed. FALSE indicates it is not.
SEARCH
Specifies whether Dgidx indexes the dimension. TRUE indicates that the value is indexed during property-to-dimension mapping. FALSE indicates it is not.
CLASSIFY
Controls property-to-dimension mapping. TRUE indicates that the value is used during property-to-dimension mapping. FALSE indicates the value is not.
The SYN element does not have any sub-elements.
This example shows SYN elements where US, USA, and United States are synonyms but only "United States" displays for dimension searches using "US" or "USA".
<DIMENSION NAME="Country" SRC_TYPE="INTERNAL">
<DIMENSION_ID ID="2"/>
<DIMENSION_NODE>
<DVAL TYPE="EXACT">
<DVAL_ID ID="2"/>
<SYN SEARCH="TRUE" DISPLAY="FALSE" CLASSIFY="TRUE">USA</SYN>
<SYN SEARCH="TRUE" DISPLAY="FALSE" CLASSIFY="FALSE">US</SYN>
<SYN SEARCH="FALSE" DISPLAY="TRUE" CLASSIFY="TRUE">United States</SYN>
</DVAL>
</DIMENSION_NODE>
</DIMENSION>