[Search Criteria]Found Items[/Search]

Searches a database and displays the found records.

Typhoon Note: Typhoon will only allow a single database to be opened.

SQL/ODBC Note: To search through an ODBC-compliant database, use the [SQL] context.

To display search results from a database, put a [Search] context into a WebCatalog template. You may specify any database and any search criteria. You may put as many [Search] contexts into a template as you want, and you may 'nest' them inside of each other to create relational searches between multiple databases. Alternately you may use the Search command from a form, and specify a template that contains a [FoundItems] context.

Example (normally you would put the following text into a .tpl file on your server and use a web browser to link to it):

[Search db=xx.db&eqNAMEdata=Grant]
Found [NumFound] items<br>
[FoundItems]
<img src="[Picture].gif"><br>
[Name], [Address], [City]<br>
[/FoundItems]
[/Search]

Try It!

Whenever WebCatalog encounters a [Search] context, it immediately opens the database and searches through it based on the search criteria you put into the search parameters. You almost always put a [FoundItems]...[/FoundItems] context inside the [Search] context so you can display the information from the matching records.

Notice you can substitute any [xxx] tags in the search parameters, as in [Search db=[userDB]&eqNAMEdata=[username]].
Parameter Description

db

Name of the database you wish to search

max

A number indicating how many records should be displayed at once before showing a list of "Show Items xx-yy" hyperlinks.

The following tags are available inside a [Search] context:
Tag Description

 [NumFound]

A number indicating how many records matched the search request.

[FoundItems]...[/FoundItems]

Normally you put a [FoundItems] loop inside a [Search], so that you can display all the matching records. You can put any database field names inside the [FoundItems] loop to display them in the HTML.

[ShowNext]...[/ShowNext]

Creates a list of links that let visitors see 'chunks' of search results