Facet Field Parameter

Syntax

The syntax for the facet field parameter is:

s.ff=<facetField>, <combineMode>[, <pageNumber or whiteList>, <pageSize>]

A query string may contain many s.ff parameters. The default value for pageNumber is 1, if unspecified. The default value for pageSize is 10, if unspecified.

A whiteList has the form value1:value2:.... It specifies a set of facet values that are to be returned whether or not their counts are in the top pageSize, provided only that their counts are non-zero.


Function

The facet field parameter requests facet counts for a given facet field to be returned with results. This command can only be used on facetable fields.

Example - Using the facet field parameter

This query string causes facet counts for the ContentType field to be returned with the results:
 
  s.ff=ContentType,or,1,15

Try It


Example - Using the facet field parameter with a white list

This query string will return facet counts for the ContentType field including counts for Journal and eJournal, unless their counts are zero:

  s.ff=ContentType,or,Journal:eJournal,5

Try It