ATG Search can calculate refinements based on the query results, in order to offer the end-user a quick way of narrowing the search. This refinement is calculated using configuration data set up in the Search Administration user interface (see the “Facet Sets” chapter in the ATG Search Administration Guide). At query time, ATG Search can control which configuration to use and global parameters for the calculation, using the following attributes:

<structquery refineConfig="name" refineMax="max" refineTop="top"
refineMin="min"

The name value must be a valid name of a refinement configuration loaded into the index.

If no value is given, no refinement calculation is made. The max value is the maximum number of refinement properties to return, even if the refinement configuration could generate more. The default value for max is 0, which means no refinement calculation will be made. The top value is the maximum number of refinement property values (per property). The values are selected in sort order, which usually is in terms of the number of index items that has each value. The default value for top is 5. The min value is the minimum size of a refinement property value, in terms of the number of index items with that value. The default value for min is 0.

 
loading table of contents...