1.  Edit the database configuration file to configure it for vocabulary-assisted searching:

1. Add a new section to the file as follows:

[TermFinder]
TermListSearchIndex = indexname
SampleSize = n
TermFinderSearchIndex = indexname
UseAdjacencyInTFSearch = true OR false

where:

• TermListSearchIndex is the name of the index to search the database using term(s) from the term list display. This must be an index defined in the database configuration file.
• SampleSize is the number of records to retrieve from the database to create a term list when the term list is generated from a term finder search of the database rather than its thesaurus database. The default is 15.
• TermFinderSearchIndex is the name of the index to use to conduct a term finder search of the database from the term finder screen. This must be an index defined in the database configuration file.
• UseAdjacencyInTFSearch is a flag that indicates that the term finder search should be an adjacency search of the TermFinderSearch index. Set this flag to true if the TermFinderSearchIndex is a "words-type" search and the remote server does not support "with" syntax in searches.

2. Add a line in the [formats] section for the formatting configuration file that contains a display specification for formatting the term list. The example below references FSMarcRTLFormat.ini, which can probably be used with minor modifications for most FirstSearch databases:

   termlist = format/obiv1/FSMarcRTLFormat.ini
   

   Another formatting configuration file that works well for many other citation and catalog-type databases is <WebZ_root>/format/obiv1/MarcRTLFormat.ini. See Term List Formatting Configuration Files for more information.

2.  Check your interface style files to make sure that the search screen (<WebZ_root>/htdocs/obiv1/html/search.html in the WebZ Out-of-the-Box Interface (OBI), version 1) allows patrons to access the Term Finder screen.

For example, if you use the SearchTabbar gadget (ORG.oclc.gadgets.SearchTabbar) to add tabs to the search screen, add the following line to the [TabBar] section of the interface style file:

termfinder = database

4.  Ensure that your interface display gadgets configuration file(s) (<WebZ_root>/ini/interface/obiv1/frameDisplayGadgets.ini and noframeDisplayGadgets.ini in the OBI, version 1) contain references to the display gadgets used for the term list.

In the OBI, version 1, this gadget is ORG.oclc.gadgets.TermListDisplay and its section in the interface display gadgets configuration files is as follows:

[TermListDisplay]
gadget = ORG.oclc.gadgets.TermListDisplay
fmt = termlist
dataWrapper = termlistHtml
tempdb = true

The dataWrapper specification for the [termlistHtml] section referenced in [TermListDisplay] is:

[termListHtml]

sectionheader <tr><td colspan="3" valign="middle" align="left">\n
sectiontrailer = </td></tr>\n

rowstart = <tr>\n<td valign="middle"align="left"> \                
&StyleTable.fonts.smallRecordText;
betweenrows = </font></td>\n</tr>\n<tr>\n \
<td colspan="2" align="left"> &nbsp;</td>\n<td>
betweencolumns = </td>\n<td align="left"> \
&StyleTable.fonts.defaultRecordText;
rowend = </td>\n</tr>\n
lineBreak = \n<br>
ThesaurusUsedForBeforeLabel = <table>\n<tr>\n<td valign="top"> \ 
 \n&StyleTable.fonts.smallRecordText;<i>
ThesaurusUsedForAfterLabel = : </i></td>\n<td> \
&StyleTable.fonts.smallRecordText;
ThesaurusUsedForSeparator = ;&nbsp;
ThesaurusUsedForTrailer = </font></td>\n</tr>\n</table>/n

For more information about the role of interface display gadget files in formatting, see Display Formatting Configuration Files.