Virtual Index Definitions

Virtual index definitions can be configured in Evergreen to create customized search indexes that make use of data collected by other (real) index definitions. Real index definitions use an XPath expression to indicate the bibliographic data that should be included in the index. Virtual index definitions bring together data collected by other index definitions to create a new, virtual index. They can also use an XPath expression to collect data directly for an index, but they are not required to.

All index definitions can be modified by having other indexes map to them. For example, Genre could be added to the All Subjects field definition in the Subject index. This would allow users to search Genre as part of a Subject search.

Keyword Virtual Index Definition

Evergreen now uses a virtual index definition for the Keyword index. This allows libraries to customize the keyword search index by specifying which fields are included in the keyword index, as well as how each field should be weighted for relevance ranking in search results. By default, the keyword index contains all of the search fields other than the keyword definition itself. Each field is assigned a weight of 1, with the exception of Title Proper, which is assigned a weight of 8. A match on the Title Proper within a keyword search will be given the higher weight and therefore a higher relevance ranking within search results.

  1. To view the stock virtual index definition for keyword searches, go to Administration>Server Administration>MARC Search/Facet Fields and select the Keyword Search Class.

  2. Locate the field labeled "All searchable fields". This is the general keyword index.

  3. The weight of a field can be modified by selecting the field and going to Actions>Edit Record or right-clicking and selecting Edit Record.

    1. The Metabib Field Virtual Map modal will appear. Increase the weight of the field and click Save.

Configuring Virtual Index Definitions

  1. To configure a virtual index definition, go to Administration>Server Administration>MARC Search/Facet Fields.

    1. This interface now has a Search Class filter that allows users to easily select which search class they want to view.

  2. Next, locate the field for which you want to create a virtual index definition and click Manage under the column labeled Data Suppliers.

  1. A new tab will open that contains the interface for configuring a virtual index definition. This interface can be used to map real index definitions for inclusion in the virtual index.

  1. To create a mapping, click New Record. A modal called Metabib Field Virtual Map will appear.

  2. Select the Real index definition and the Virtual index definition to which it should be mapped.

  3. Assign a Weight to the mapping. This allows Evergreen to calculate the weight that should be applied to each field when searched using the virtual index.

    1. The weight assigned to a field within a virtual index can be different than the weight assigned when searching that field directly. For example, the Title Proper field can have a weight of 2 when a user performs a Title search, but a weight of 5 when a user performs a Keyword search (using the virtual index). This can help move title matches on keyword searches higher up in the search results list.

  4. Click Save.

  5. Repeat steps 4-7 until all desired fields are mapped to the virtual index definition.


Note: A service restart is required after definitions and mapping are changed. Changes to weight only do not require a restart as they are calculated in real time.

Search Term Highlighting in Search Results

Search terms are now highlighted on the main OPAC search results page, the bibliographic record detail page, and the metarecord grouped results page. This will help users discern why a certain record was included in the search result set, as well as its relevance to the search. Search terms will be highlighted in both real and virtual fields that were searched. Terms that were stemmed or normalized during searching will also be highlighted. Search term highlighting can be turned off within the OPAC by selecting the checkbox to "Disable Highlighting" in the search results interface.

A keyword search for "piano" returns a set of search results:


The search term is highlighted in the search results and indicates why the records were included in the search result set. In this example, the search results interface shows the first three records had matching terms in the title field.

Within the record detail page for "The five piano concertos", we can see the search term also matched on the General Note and Subject fields within the bibliographic record.