Thursday, May 21, 2015

Sitecore 8 Lucene search index and implementation

Creating the index

In the "Website\App_Config\Include" folder in your Sitecore web site you will find some example files containing search index XML. 
  • Sitecore.ContentSearch.Lucene.Indexes.Sharded.Core.config.example
  • Sitecore.ContentSearch.Lucene.Indexes.Sharded.Master.config.example
  • Sitecore.ContentSearch.Lucene.Indexes.Sharded.Web.config.example
  • Sitecore.ContentSearch.Solr.DefaultIndexConfiguration.config.example
  • Sitecore.ContentSearch.Solr.Index.Analytics.config.example
  • Sitecore.ContentSearch.Solr.Index.Core.config.example
  • Sitecore.ContentSearch.Solr.Index.Master.config.example
  • Sitecore.ContentSearch.Solr.Index.Web.config.example
There are examples present for both Lucene and Solr and a seperate file for each Sitecore database (web, core master and analytics). In this example, I will be using Lucene for search and wish to index the web database so will begin with "Sitecore.ContentSearch.Lucene.Indexes.Sharded.Web.config.example". 

The first step is to give the index a name, this is set on the id attribute of index. This name is what you use to refer to the index in code and in Sitecore, so make it descriptive. Under the configuration section I will also add XML to specify which template(s) should be indexed and which fields.
<include hint="list:IncludeTemplate">
In  this case I am indexing two templates (referred to by GUID) and the fact that I want all fields indexed. The index is also left to the default of "onPublishEndAsync" which means it will execute automatically at the end of a publish.

An XML file can contain multiple indexes, and can be given any name. It should be saved in the same location as the example files ("Website\App_Config\Include"), and Sitecore will automatically pick it up (if the XML is formed correctly).

Running the index

To give the index an initial run, navigate to the Sitecore desktop. Click on the main menu icon and select "Control Panel", here you will find a section on indexing.

Click on the "Indexing manager" option and you should see the index created earlier and when it was last run. You can also select the index, click "Rebuild", to manually run the index.

Accessing the index in code

Now that the index has been defined, and run it can be queried in code to return relevant items (aka a custom search on a Sitecore 8 web site). In this example I have a custom template for content pages, which contains a number of custom fields related to navigation, metadata and content. For the purposes of search the two fields that will be queried are: Title (which is the title of the page) and Content (which is the main block of HTML content for the page).

In the above code sample I am accessing the CustomSearch index and getting the items where the page title is like the search query and where the page content contains the search query. These results are then cast to the list of MyResultItem object which can then be enumerated to build a list of custom object SearchResult which is then bound to the front end.

Further reading


  1. so followed your directions and I can rebuild in the index in the sitecore cms. I am in Sitecore 8.0. However when I try and add it to the code behind for the page. I get an error on this line.

    var index = ContentSearchManager.GetIndex("CustomSearch");

    Server Error in '/' Application.

    Could not find configuration node: search/configuration

    Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code.

    Exception Details: System.InvalidOperationException: Could not find configuration node: search/configuration

    Anything I need to do in web.config to set it up?

    1. In your search index XML, was the index labeled: ?