Sun Microsystems Netscape Enterprise Server, Руководство администратора

Страница: 444 / 532

Customizing the Search Interface
444 Netscape Enterprise Server Administrator’s Guide
Macros and Generated Pattern Variables
There are some search macros that you can use in your pattern files or
decorated URLs, and the search function itself generates some pattern variables
that you can use in subsequent search requests to define how the later output is
to be displayed. These macros and variables have a prefix of
$$NS-
to indicate
their use.
For example, after doing an initial search query that results in 24 documents on
the results page, you can reuse the search-generated
$$NS-docs-matched
and the
$$NS-doc-number
variables to help define a document page
displaying one of the documents in detail. In this way, you can tell the user that
this document is number 3 of 24 documents returned for the original search.
The search macros and the generated variables that you can use in a
subsequent pattern file or decorated URL are listed the following table:
Table 16.10 Macros and generated pattern variables
Variable Description
$$NS-collection-list
An HTML multiple select list of all the collections in
dblist.ini
where
NS-display-select
is set to YES.
$$NS-collection-list-
dropdown
An HTML drop-down list version of
NS-collection-list.
$$NS-collections-searched
The number of collections searched for this request.
$$NS-display-query
The HTML-displayable version of the query that is generated for a
results page.
$$NS-doc-href
The HTML HREF tag for the document. This provides a URL to the
original source document. For email, this is in the form
mailbox:/boxname?id-messageID
and for news, it is in the
form
news:messageID
.
$$NS-doc-name
The document’s name.
$$NS-doc-number
The sequence number of the document in the results page list.
$$NS-doc-path
The absolute path to the document.
$$NS-doc-score
The ranked score of the document (ranges 0 to 100).
$$NS-doc-score-div10
The ranked score of the document (ranges 0 to 10).
$$NS-doc-score-div5
The ranked score of the document (ranges 0 to 5).