Using Search Parameters

Using Search Parameters

You can manually enter recognized search parameters in your Web browser's address field to modify a search or to create a search from scratch without using the NetWare Web Search form. You can do this using the recognized NetWare Web Search parameters listed below.

Search parameters must be used exactly as they are shown in the table below, including case, spacing, and the use of the equal sign (=).

Refer to the following table for a list of search parameters:

Parameter Name

Value

Explanation

queryitems

Integer

Syntax: queryitems=number
Example: queryitems=0

Identifies the number of queries that are part of the current search. By assigning a number greater than one (1), you can pass multiple queries at once.

The default queryitems number is zero (0).

querynumber

String

Syntax: querynumber=searchcriteria
Example: query0=novell+AND+groupwise

The actual search criteria that is passed to the Web Search Server.

The next three parameters below belong to this parameter and are identified by adding the unique number to them.

operatornumber

Integer

Syntax: operatornumber=number
Example: operator0=1

Indicates which operator to use between two or more words in a search. Zero (0) equals AND, one (1) equals OR, and two (2) equals PHRASE.

weightnumber

Integer

Syntax: weightnumber=number
Example: weight0=75

Allows you to assign a level of importance to one or more search criteria. Web Search Server uses this number along with the relevance number to determine a search criteria's final relevance and then orders the results accordingly. You can choose a number from zero (0) to one-hundred (100).

collections

String

Syntax: collections=collection name
Example: collections=Statistics

Allows you to restrict a search to one or more specified collections. The collection name you specify using the COLLECTIONS parameter must exactly match the name of the collection. Your Web Search Server administrator can tell you the names of all available collections.

date

Integer

Syntax: date=number
Example: date=-7905600000

Allows you to specify a date range to be searched in milliseconds. The example above shows the number of milliseconds spanning a three-month time frame. The minus sign (-) before the number indicates three months back in time.

If you pass a positive number such as 940457147873, then Web Search will create a date and time based on the number of milliseconds elapsed since January 1, 1970; 12:00 a.m. The example number 940457147873 produces the search start date of October 20, 1999, at 4:05:47 p.m.

numhits

Integer

Syntax: numhits=number
Example: numhits=25

Indicates the number of hits you want returned at one time in the search results page.

starthit

Integer

Syntax: starthit=number
Example: starthit=35

Indicates the hit number you want Web Search to begin searching from. If you entered 35 as the STARTHIT parameter value, Web Search would return your hits beginning with hit number 35.

lang

String

Syntax: lang=language code
Example: lang=ja

Allows you to specify your preferred language using the two-character, lower-case language value derived from ISO639¹. Ask your Web Search Server administrator which languages are supported. The refer to the URL listed below for the ISO639 listing of language codes.

country

String

Syntax: country=country code
Example: country=TW

Allows you to specify your country using the two-character, upper-case country value derived from ISO3166. Ask your Web Search Server administrator which languages are supported. The refer to the URL listed below for the ISO639¹ listing of language codes.

template

String

Syntax: template=filename
Example: template=ResultList.html

Allows you to specify a specific results template you want your search or print results returned in. The following list of templates are the default templates included with the Web Search Server. However, your Web Search Server administrator may have created custom templates using different names. Check with your administrator if these templates do not work for you. You must type the names of these templates exactly as they appear in the list:

1. ResultListTemplate.html
2. ResultListTerseTemplate.html
3. ResultListVerbose.html
4. PrintResultTemplate.html

For localized versions of these templates, check with your Web Search Server administrator.

retfield

String

Syntax: retfield=fieldname
Example: retfield=title

Allows you to determine the level of detail given about each result item. The fewer the details, the faster your search will be returned to you.

Fields include title, author, url, changedate, language, summary, relevance, and filelength.

NOTE: Type these fields exactly as they appear here.

gettotalhits

Boolean

Syntax: gettotalhits=value
Example: gettotalhits=true

Allows you to enable or disable the total number of hits parameter. For example, if you set the GETTOTALHITS parameter to FALSE, the Total Number of Hits label on the results page will display zero (0). Setting this parameter to TRUE will show the total number of hits found during the search.

retencoding

String

Syntax: retencoding=content-type
Example: retencoding=iso-8859-1

Allows you to specify the character set encoding to be returned by all results pages.

sortkeys

Integer

Syntax: sortkeys=number
Example: sortkeys=1

Allows you to specify the number of sort fields that should be used to sort the search results.

sortfieldnumber

String

Syntax: sortfieldnumber=number
Example: sortfield1=title

Allows you to specify the sort order of results returned in a results page.

Refer to the RETFIELD parameter for a list of available fields.

sortordernumber

Integer

Syntax: sortordernumber=number
Example: sortorder1=0

Allows you to specify the alphanumeric ordering of search result items, or hits. Options include:

1. Zero (0) = Ascending
2. One (1) = Descending
3. Two (2) = Default for each field, specified by your Web Search Server administrator.

Related Topics

Search Operators
Search Proximity

On the Web

¹http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt

*Novell Trademark. ** Third-party trademark. For more information, see Trademarks.

Parameter Name	Value	Explanation
queryitems	Integer	Syntax: queryitems=number Example: queryitems=0 Identifies the number of queries that are part of the current search. By assigning a number greater than one (1), you can pass multiple queries at once. The default queryitems number is zero (0).
querynumber	String	Syntax: querynumber=searchcriteria Example: query0=novell+AND+groupwise The actual search criteria that is passed to the Web Search Server. The next three parameters below belong to this parameter and are identified by adding the unique number to them.
operatornumber	Integer	Syntax: operatornumber=number Example: operator0=1 Indicates which operator to use between two or more words in a search. Zero (0) equals AND, one (1) equals OR, and two (2) equals PHRASE.
weightnumber	Integer	Syntax: weightnumber=number Example: weight0=75 Allows you to assign a level of importance to one or more search criteria. Web Search Server uses this number along with the relevance number to determine a search criteria's final relevance and then orders the results accordingly. You can choose a number from zero (0) to one-hundred (100).
collections	String	Syntax: collections=collection name Example: collections=Statistics Allows you to restrict a search to one or more specified collections. The collection name you specify using the COLLECTIONS parameter must exactly match the name of the collection. Your Web Search Server administrator can tell you the names of all available collections.
date	Integer	Syntax: date=number Example: date=-7905600000 Allows you to specify a date range to be searched in milliseconds. The example above shows the number of milliseconds spanning a three-month time frame. The minus sign (-) before the number indicates three months back in time. If you pass a positive number such as 940457147873, then Web Search will create a date and time based on the number of milliseconds elapsed since January 1, 1970; 12:00 a.m. The example number 940457147873 produces the search start date of October 20, 1999, at 4:05:47 p.m.
numhits	Integer	Syntax: numhits=number Example: numhits=25 Indicates the number of hits you want returned at one time in the search results page.
starthit	Integer	Syntax: starthit=number Example: starthit=35 Indicates the hit number you want Web Search to begin searching from. If you entered 35 as the STARTHIT parameter value, Web Search would return your hits beginning with hit number 35.
lang	String	Syntax: lang=language code Example: lang=ja Allows you to specify your preferred language using the two-character, lower-case language value derived from ISO639¹. Ask your Web Search Server administrator which languages are supported. The refer to the URL listed below for the ISO639 listing of language codes.
country	String	Syntax: country=country code Example: country=TW Allows you to specify your country using the two-character, upper-case country value derived from ISO3166. Ask your Web Search Server administrator which languages are supported. The refer to the URL listed below for the ISO639¹ listing of language codes.
template	String	Syntax: template=filename Example: template=ResultList.html Allows you to specify a specific results template you want your search or print results returned in. The following list of templates are the default templates included with the Web Search Server. However, your Web Search Server administrator may have created custom templates using different names. Check with your administrator if these templates do not work for you. You must type the names of these templates exactly as they appear in the list: 1. ResultListTemplate.html 2. ResultListTerseTemplate.html 3. ResultListVerbose.html 4. PrintResultTemplate.html For localized versions of these templates, check with your Web Search Server administrator.
retfield	String	Syntax: retfield=fieldname Example: retfield=title Allows you to determine the level of detail given about each result item. The fewer the details, the faster your search will be returned to you. Fields include title, author, url, changedate, language, summary, relevance, and filelength. NOTE: Type these fields exactly as they appear here.
gettotalhits	Boolean	Syntax: gettotalhits=value Example: gettotalhits=true Allows you to enable or disable the total number of hits parameter. For example, if you set the GETTOTALHITS parameter to FALSE, the Total Number of Hits label on the results page will display zero (0). Setting this parameter to TRUE will show the total number of hits found during the search.
retencoding	String	Syntax: retencoding=content-type Example: retencoding=iso-8859-1 Allows you to specify the character set encoding to be returned by all results pages.
sortkeys	Integer	Syntax: sortkeys=number Example: sortkeys=1 Allows you to specify the number of sort fields that should be used to sort the search results.
sortfieldnumber	String	Syntax: sortfieldnumber=number Example: sortfield1=title Allows you to specify the sort order of results returned in a results page. Refer to the RETFIELD parameter for a list of available fields.
sortordernumber	Integer	Syntax: sortordernumber=number Example: sortorder1=0 Allows you to specify the alphanumeric ordering of search result items, or hits. Options include: 1. Zero (0) = Ascending 2. One (1) = Descending 3. Two (2) = Default for each field, specified by your Web Search Server administrator.