Archive 1.x:Individual OSF-Drupal Search Tool

Search is generally available to all users. When you search, you search across all datasets to which you have access rights. Both phrase and operator-based search are supported.

The Results Set
The outcome of a search is to first present a results set, standard practice for search engines. Here are some notes and behaviors:


 * If the number of results exceeds 10, a pagination utility is added
 * Individual results listings show title, description and dataset source. In addition, the relation (property or predicate) in which the search was found and its category (kind, "type" or class) (such as Article, Person, etc.) is also noted
 * If you have the proper permissions, you may also see the Update [[Image:overlays.png|16px|Update Record icon]] or Delete [[Image:cancel.png|16px|Delete Record(s) icon]] icons, which allow you to perform those actions on that record.

Viewing an Individual Result (Record)
Clicking on an individual record brings up an instance record report for that instance type. See the View Record page for a description of this specific tool.

Filters
At the top of the results set are two Filter types, selectable by clicking on its tab.

Filter by Dataset
This tab presents all of the datasets that contributed a result for the search and the number of results within that dataset.


 * Clicking on a given dataset name causes the results display to be restricted to results only from that selected dataset.
 * If so selected, the Filter by Kinds tab (see next) is also restricted to the types of things within that dataset.
 * Once selected, the filter remains in place. To remove it, click on the Remove filter icon [[Image:cancel.png|16px|Delete Record(s) icon]] to restore the datasets back to the original listing for this search.



Filter by Kind
This tab presents all of the "kinds" (actually, classes that have similar members) that are contained within the structure of the individual results that comprise the search results. The number of records (results) returned for each class is also shown in parentheses.


 * Clicking on a given "kind" name causes the results display to be restricted to results only for that kind of class.
 * If so selected, the Filter by Dataset tab (see above) is also restricted to the datasets that contain results with that class.
 * Once selected, the filter remains in place. To remove it, click on the Remove filter icon [[Image:cancel.png|16px|Delete Record(s) icon]] to restore the "kinds" back to the original listing for this search.

Operators
The Search function supports these operators and conventions. All operators, by the way, must be entered as ALL CAPS:


 * AND, which is the default operator if more than one key word is entered
 * OR, which needs to be specifically entered
 * NOT
 * Phrases, which are denoted by double quotes as this "search phrase"; single quotes are not accepted
 * Wildcard searches on single characters (?) and multiple characters (*), which can be placed anywhere except the beginning of the query term
 * Field searches, whereby the field name is used in the query followed by a colon
 * Nesting, which allows complicated Boolean expressions to be formed (so long as parentheses are balanced), and many more exotic options.

See further the Lucene search engine syntax specification.