Generated Files

For each search form generated in Form Builder, a set of HTML files is created. Assuming the form is named dtsearch.html, the files created are:

File	Purpose
dtsearch_minihelp.html dtsearch_help.html	Help on search requests. This will appear in the right panel when the user initially opens the search form.
dtsearch_options.html	The dtsearch_options.html file contains settings that dtSearch Web uses to generate search results and to format retrieved documents for display.
dtSearch_WebSearchForm.css dtSearch_SearchResults.css	Style sheets that control the appearance of the search form and search results.
dtSearch_WebSearchForm.js dtSearch_SearchResults.js dtSearch_Utilities.js	JavaScript that implements features of the search form and search results, such as hit navigation.

If the search form uses frames, the frameset will be named dtsearch.html and the search form will be named dtsearch_form.html. Otherwise, the search form itself will be named dtsearch.html.

After the search form is generated, you can edit it in an HTML editor to customize the appearance. You can also replace the text in dtsearch_help.html with other explanatory text, such as a detailed description of what is in each index. When editing the search form, be sure not to remove the META tag at the top of the form that looks like this:

This tag ensures that non-English characters in your search form will be handled correctly. If you move the search form to another web page, copy the META tag into the <HEAD> area of the new page.

Moving the files

When dtSearch Web receives a search request, it uses the name of the search form to find the options file, which it uses to format search results. For example, if the search form is dtsearch_form.html, it will look for the options file in dtsearch_options.html. Therefore, if you move or rename the search form, it is important to move or rename the options file so that dtSearch Web can find it. If the search form name ends with "_form.html", the options file should end with "_options.html". If the search form name does not end in "_form.html", the options file should be the same as the search form name, but with "_options" added before the filename extension.

Examples:

Search Form Name	Options File Name
example_form.html	example_options.html
example.html	example_options.html

Another way to ensure that the options file remains linked to the search form is to add a hidden form variable with the full path and filename of the search form, like this:

dtSearch Web will check this form variable only if the filename matching method described above does not work.