To perform a simple search in InterSystems documentation, enter search terms in the Search:
field near the top right of the page and then press Enter
Enter search terms here. Previous search terms with the same spelling will appear in a drop-down list as you type, so you also may select one from the list if you would like to search for it again.
button Click to search.
button Click to empty the content field and return to default search rules. Selecting this button will also display the Recent searches
In addition to the above elements, there are two optional menus with which you can restrict your search further. They include:
Books and articles
Select the title of a book, or keep the default all books and articles
. If you know which book contains the information you are seeking, use this to restrict the search to results within that book only.
Select a tag from the list, or keep the default all tags
. Tags are a useful way to narrow your search if you are looking for a topic that spans multiple books but also might return an unwieldy number of hits. For example, if you search for just SQL
, the search will return hundreds of results. If you instead select the SQL
tag and enter a related search term in the content field, the search returns only topics that are relevant to SQL, rather than any reference to it.
The following are the default rules for searches:
A search can include one or more terms.
The search engine returns results that contain all terms.
The default search is not case-sensitive. For example, searches for SET
, and set
yield the same results.
If the search string exactly matches the title of a section or an entry in a definition list, this hit appears at the beginning of the results and is highlighted.
The order of search results is primarily determined by the topic (see previous bullet) in which they are found. Each topic has an overall ranking, such that topics of more general interest appear before those that have a narrower scope. To a lesser degree, the number of matches in a given topic also affects the ranking of search results.
Use the first menu to the right of the content field to choose between searching either for text that includes all or text that includes any of the specified search terms. The default setting is to find results that include all terms; if you do not know the exact term you are seeking, enter several synonyms and select Find topics with any word
to determine which term the documentation uses. For example, if you are not sure whether to search for the word transform
or the word translate
, enter both into the content field and select the option Find topics with any word
When using free-text search, the results may begin with one or more featured links that have been flagged as notable results for the search term. Exact search disables this feature. Also note that free-text search does not currently return results with the matches highlighted.
Do not put quotation marks (
) around the search term unless they are, themselves, part of the search item.
The various search rules, taken together, offer a powerful means of locating information in InterSystems documentation. They can also sometimes cause unexpected search results. If you search for a common word, such as and
, the search may return fewer results than you expected. This is because the search returns only the first 10,000 results, some of which are too short to be useful, so you will have only the topics that include those. If you are having difficulty finding a common word, try using other related terms that will return more specific results.
To repeat a previous search, select a link from the Recent searches
list. These links appear if you click the Search label at the top-right corner of a documentation page, or if you select the Reset
This list displays a link for each past search, follower by the number of results for that search, a specific description of the search (see URL Parameters
, later in this chapter).
To help you create searches programmatically, the search page DocBook.UI.SearchPageZen.cls supports the URL Parameters, which are as follows:
Specifies the search term or terms.
Corresponds to the product menu.
If you also select a book or article, the product becomes redundant, and therefore is no longer included in the URL parameters.
Corresponds to the books and articles menu. For this parameter, the allowed values are the internal identifiers of the books and articles. Note that the list includes these identifiers in parentheses for your convenience.
Corresponds to the tags menu.
For the Product
, and Tags
parameters, the allowed values depend upon what is present in the DOCBOOK
database. Currently each of these parameters accepts only a single value.
Content Date/Time: 2019-04-23 13:43:20