Generation of the refinement configuration XML files is managed by the /atg/commerce/search/refinement/CatalogRefineConfigAdapter component, which is a post-index customization adapter associated with the indexing project in Search Administration. This adapter is automatically invoked after each indexing operation. (You can also invoke it without reindexing; this is useful if you have changed your facets in Oracle ATG Web Commerce Merchandising without making any changes to your catalog.) CatalogRefineConfigAdapter invokes RefinementConfigurationGenerator, which generates the XML files.

For information about setting up the CatalogRefineConfigAdapter, see the ATG Search Installation and Configuration Guide. For information about invoking post-index customizations, see the ATG Search Administration Guide.

Determining the XML Files to Generate

As mentioned above, a separate commerceRefineConfig item is created for each catalog, category, and category-info item. Each commerceRefineConfig item points to one or more refineElement items that each represent one of the facets for the catalog or category.

Depending on your facet definitions, some of the commerceRefineConfig items may be identical, because the same facet set is used by multiple categories. If two or more commerceRefineConfig items are identical, a single XML file is generated to represent them. The XML file contains tags that map the file to all of the catalogs and categories that use the file’s facet set.