wiki:Help/Search

ESTEST Searching

This document is designed to help end-users search the xquery database through the web interface.

Searchable elements

ESTEST does not implement general text search. Very plainly, only certain identifying elements of the UR XML are indexed to be searched based on lucene query syntax. Currently, these elements are

  • Keywords, defined in annotations
  • Identifier or "name", a short string naming the UR XML document
  • Publication Identifier, usually the DOI number
  • Publication title
  • Program executable name, i.e. qbox, pwscf
  • Document owner (creator)

Reading the search results

Before discussing how to query the database let's examine in detail the display of returned search results. This particular query searched for all documents belong to the user "admin".

/estrac/imgs/Help/Screenshot-ESTEST-Web-Search.png

From top-to-bottom, left-to-right, the elements on this page are:

(1) ESTEST logo, links to index page

(2) Search bar, performs a new search and clears the cookie of currently saved records.

(3) Checkbox, specifies that the next search should only match keyword annotations.

(4) Advanced Search, a link to more search options.

(5) List of currently saved records, stores the UUIDs of documents you would like to use later. They are (de)elected by a checkbox.

(6) Paginated links, navigate between pages of 20 search results each.

(7) The search legend

(8) Compare button, click on this button to compare all the documents in the list of saved records.

(9) Check All button, to check all the result boxes seen on the current page.

(10) A table of search results. Each row of the table consists of: grayed out text indicating the ESTEST server that originated the search result (none for the local server), the short document identifier (links to the UR document summary), the document owner name (links to his/her profile), a checkbox to (de)select the UR document to the list of saved records' UUIDs.

Querying the database

By default all searches are general text queries on the full scope of searchable elements in ESTEST described above. One can specify additional search options through the advanced search index.

Entering multiple search terms means that each and every search term must be matched--corresponding to AND logic between the terms. The use of double quotes '"' in general searches means to search on that phrase (a correct ordering of each term). Using double quotes in a keyword search, however, means to match the quoted text exactly including whitespace in the context of one keyword. This subtle difference is sometimes necessary to keep in mind.

Using search filters

Several search filters are available to be set through the advanced search index.

/estrac/imgs/Help/advanced_search_ui.png

The search type filter defines to search to act on the entire scope, only the keywords, or only on publications.

The date range filter defines an interval of time to match the creation date of a document between.

The user filter specifies that the search results should be uploaded by a specific user by name.

Server selection

For ESTEST servers connected to a network of other ESTEST servers on remote hosts, one can choose which servers to query in the search by (un)checking their checkbox under "Use?". Your choices will be stored in a cookie valid for the current session.

Last modified 6 years ago Last modified on 08/25/11 12:34:04