Search

From Gcube Wiki
Jump to: navigation, search

Search is one of the most important functionalities in the gCube system. Depending on the collections you want search through you can perform different kinds of searches. The default option is to search for a term anywhere in the selected collections, or you can search for more specific criteria. There is also the option to browse the contents of a collection and their distinct values based on a specific criterion.
After performing a search you can refine its results by searching for more specific terms in the current results. In order to perform a search or a browse, you first have to select collections. For this purpose you have to use the Select Collections portlet. Independently of the search type all results are displayed by the Results portlet.

Select Collections

By using this portlet, you can select the desired collections in order to browse or search them.
The collections are presented in a tree hierarchy. The first level of nodes represents a collection group and each group contains several collections. In the following image, f.i. Aquamaps is a collection group. On the left of each checkbox, there is either a close folder icon or an opened folder icon. If there is a closed folder icon, it means that there are other collections inside this group of collections. By click on it, you can see the underlying collections. On the other hand, if there is an opened folder icon, it means that the node is expaned and you already see the inner collections (like AquaMaps: Class Biodiversity Maps). So, if you click on it, you can hide them.
In order to select/deselect a collection, you have to click on its name or checkbox. Additionally, you can select a group of collections simply by selecting the group of collections they belong to. As you can see below, if you select the Aquamaps collection group, then all the collections that belong to this group are selected.
Collections.png

A full description for each collection is available, if you click on (more) link. A pop up window appears containing a description of the corresponding collection as you can see in the image above. For each collection you can see its name, description (if it exists), number of records and the creation date.

For your flexibility you can search through the available collections for a keyword that may be included in collections name and/or description. The following image displays this functionality. SearchColls.png

The collections that you have already selected, are also selected at the pop-up window with the search results. You can deselect the already selected collections or select new collections. By clicking on the results at the pop-up window this change will also be applied at the collections tree.

Search

The search portlet is divided into 3 different tabs. The 'Search', the 'Browse' and the 'Refine Search' tab. Each tab provides different functionality and will be described below.

Search panel

After selecting the collections you want to search in, the search functionalities are enabled based on the current selections. The Search panel is displayed and there you have two different options. You can type the search terms you want to search for and click on the 'Search' button or you can click on the 'Advanced search options' link which will display the advanced interface. If you use the first option this will search for the given terms everywhere inside the selected collections.

Search.png

If you use the second option, this will enable the advanced search. In the advanced search you can:

  • Choose the language to be used
  • Add as many criteria as you like.
  • Define the field to be used in each criterion. If 'Any' is selected this will search everywhere inside the selected collections.
  • Decide if all or any of your criteria should be matched. The default option is to match any of the given criteria.
  • Click on the 'Search' button to submit the search.
  • Click on the 'Reset' button to reset the current criteria.


AdvancedSearch.png

You can add a new condition by clicking the Add Condition (+) button or you can delete a condition by clicking the Remove Condition (-) button. Notice here that at least one condition is needed. If you try to delete it a warning message is displayed and nothing is happened.

Search2condsandsort.png

Browse panel

If browse panel is enabled you can browse the selected collections by one of the available criteria.
You have two options either to browse the contents of the collections, or to get the distinct values of the selected criterion.

BrowsePanel.png
You can select the order of the results and specify how many results you would like to be displayed per page.
The number of results per page cannot be more than 50. If you try to request for a bigger number a warning message is displayed and the default value is again added

Refine Search panel

The refine search panel is not enabled based on the selected collections. It provides two different functionalities:

  • Refine the results of the searches submitted in the current working session
  • Submit queries you have saved in your workspace
Refine the results of submitted queries

First you should select which of the last results you want to refine. The already submitted queries are added to a drop down list and the latest is preselected.
Then you can add as many criteria as you like and click on the 'Refine' button.

RefineSearchQueryDesc.png

For each selected query you can see the initial query that was submitted and the initial results at the results portlet.
RefineExplainLinks.png

Submit queries from user's workspace

When you submit a search you can save the submitted query to your workspace (This functionality is provided by the results portlet). Then whenever you like you can resubmit any of these queries and see its results.
In the refine search panel choose the Submit Query from basket. The basket with all the saved queries is displayed. Choose one of the queries and click on the 'Search' button to submit the search.
SearchBasket.png