XMLFullStructure

Set XMLFullStructure to True to enable the WHEN operator for the Query action Text parameter.

The WHEN operator allows you to return only those XML documents in which two fields with the same parent field contain specified terms or phrases. Setting XMLFullStructure to True ensures each occurrence of the same field name in an XML document is given a different field code so that each one can be uniquely identified.

If you perform a geographical search, a single XML document can contain multiple latitude and longitude pairs, as long as each pair has a unique parent tag. In such documents:

FieldText=DIST*

Matches any of the pairs in the document.

FieldText=BIASDIST*

Biases according to the closest pair to the center point.

Sort=DIST*

Sorts according to the closest pair to the center point.

You can use the DISTSPHERICAL operator with the WHEN operator when you have set XMLFullStructure to True.

Notes

• Setting XMLFullStructure to True also ensures that IDOL Content Component treats multiple occurrences of the same field name in an IDX document uniquely.

• XMLFullStructure supports the BEFORE and AFTER operators in FieldText queries for IDX documents. The BEFORE and AFTER operators allow you to return only those XML or IDX documents in which two fields appear in the specified order. You cannot use the WHEN operator for IDX documents, because there are no parent fields in IDX documents.

  For example:

  FieldText=MATCH{Ford}:MAKE BEFORE MATCH{Ferrari}:MAKE

• When you set XMLFullStructure to True, text queries for exact phrases return only phrases that occur in the same instance of a field.

  For example, if an IDX document lists:

  #DREFIELD author="W.C. Henry"
  #DREFIELD author="James Joyce"

  The following query returns this document if you set XMLFullStructure to False in the IDOL Content Component configuration file.

  action=Query&Text="Henry James":author

  If you set XMLFullStructure to True, the document does not return.

• XMLFullStructure applies to XML documents that you submit in a query that uses the TextParse action parameter. For example, if you have an AgentBoolean rule that uses the WHEN operator, IDOL Content Component applies this rule correctly to XML in the Text parameter when you set TextParse to True.

Type:	Boolean
Default:	False
Required:	No
Configuration Section:	Server
Example:	XMLFullStructure=False
See Also:	Query action FieldText parameter Query action