Category

Applies to: SharePoint Server 2010

Specifies the filter category for the custom refinement filters.

<Category 
    Title="string"
    Description="string"
    Type="TypeName"
    MappedProperty="PropertyName"
    MetadataThreshhold="value"
    NumberOfFiltersToDisplay="value"
    MaxNumberOfFilters="value"
    SortBy="Frequency|NumericValue|Name|Custom"
    SortDirection="Descending|Ascending"
    SortByForMoreFilters="Frequency|NumericValue|Name|Custom" 
    SortDirectionForMoreFilters="Descending|Ascending"
    ShowMoreLink="True|False" 
    MoreLinkText="string" 
    LessLinkText="string" 
    ShowCounts="Count|Percentage">
    ... 
</Category>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
Title	A string specifying the filter category title, displayed in the Refinement Panel Web Part. For taxonomy filter categories, use the following titles: The column name for taxonomy filter categories based on columns. Managed Metadata Columns for taxonomy column filter categories that use owsmetadatafacetinfo to display the most appropriate columns. Tags for taxonomy tags filter categories by using owsmetadatafacetinfo to display the generated category.
Description	A string specifying the filter category description, displayed as a tooltip in the Refinement Panel Web Part.
Type	The type of data that the refinement is based on. Valid values are: Microsoft.Office.Server.Search.WebControls.TaxonomyFilterGenerator  The refinement is based on taxonomy data. Microsoft.Office.Server.Search.WebControls.ManagedPropertyFilterGenerator  The refinement is based on a managed property. Microsoft.Office.Server.Search.WebControls.RankingModelFilterGenerator  The refinement is based on a ranking model. CustomFilterGenerator  The refinement is based on a custom filter generator.
MappedProperty	A string specifying the name of the managed property for refinement. For taxonomy columns or tags, specify ows_MetadataFacetInfo. For popular social tags, use ows_MetadataFacetInfo,popularsocialtags.
MetadataThreshhold	An integer greater than or equal to 1 that specifies the number of results that must contain a value to display the filter generator under the filter category.
NumberOfFiltersToDisplay	An integer from 1 to 50 that specifies the number of filters to display in the filter category.
MaxNumberOfFilters	An integer that specifies the maximum number of filters to display when the show more link in the Refinement Panel Web Part is clicked. To display all the filters, specify 0 for this attribute.
SortBy	Specifies the sort criteria for displaying the filter values in the Refinement Panel Web Part. Valid values are: Frequency NumericValue Name Custom  Displays filters in the order specified in the XML for the Refinement Panel Web Part.
SortDirection	Specifies the sort direction for the filter values. Valid values are Ascending or Descending.
SortByForMoreFilters	Applies to: Microsoft SharePoint Server 2010 search Specifies the sort criteria for the filter values when show more link is clicked. This attribute is optional, and if it is not included, the value specified in the SortBy attribute is used as the sort criteria. Valid values are: Frequency Numeric  Requires a range mapping. Name Custom  Displays filters in the order specified in the XML for the Refinement Panel Web Part XML.
SortDirectionForMoreFilters	Applies to: Microsoft SharePoint Server 2010 search Specifies the sort direction for the filter values when the show more link is clicked. Valid values are Ascending or Descending. This attribute is optional, and if it is not included, the value specified in the SortDirection attribute is used instead.
ShowMoreLink	Specifies whether to display the show more link in the Refinement Panel Web Part. true to display the link; otherwise, false.
MoreLinkText	A string specifying the link text for the show more link.
LessLinkText	A string specifying the link text for the show less link.
ShowCounts	Specifies whether the count or percentage is displayed with the filter. Valid values are: Count Percentage You can specify a custom value for this attribute if the XSLT of the Refinement Web Part is customized to handle the custom value.

Child Elements

Element	Description
CustomFilters [Refinement]	Contains the custom refinement filters for the category.

Parent Elements

Element	Description
FilterCategories [Refinement]	Specifies the top-level node of the refinement filter category definition.

See Also

Concepts

Refinement Panel Overview