Configuring whether to display refinement counts

Refinement counts represent the number of records (in the current navigation state) available beneath a given refinement value. These counts are computed dynamically at run-time by the Oracle Endeca Server and can be displayed in the user interface.

By showing the user the number of records that will be returned for each refinement, refinement counts can enhance the front-end application’s navigation controls by providing more context at each point in the user's Guided Navigation process.

By default, attributes are enabled to display refinement counts, and no further configuration is needed to display them. So long as there are attribute values returned for a given request, refinement value counts are also returned as an attribute attached to each attribute value.

You configure whether to show record counts for an attribute by changing the value in the system-navigation_ShowRecordCounts attribute in the PDR, using either the Configuration Web Service or Integrator.

The valid settings for system-navigation_ShowRecordCounts are:
  • true means that record counts are enabled and will display. This is the default.
  • false means that record counts are disabled and will not be displayed.

For information on how to change the value for the system-navigation_ShowRecordCounts in the PDR, see Using the Configuration Web Service and the Oracle Endeca Server API Reference, the section about the Configuration Web Service. For information on using Integrator for the same purpose, see the Oracle Endeca Information Discovery Integrator User's Guide.

For information on how to retrieve the record counts for a refinement, see How refinement counts are returned.

You can also control the number of available refinements to display, in addition to the number of records under each refinement. For information, see Increasing the number of refinements to be displayed.