Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
rdms:webapp:search [2024/04/19 11:58]
burcu [Sub-Searches]
rdms:webapp:search [2024/05/10 12:06] (current)
burcu [Filtering Your Search Results]
Line 62: Line 62:
 ===== Using RDMS Search ===== ===== Using RDMS Search =====
 ==== General Search ==== ==== General Search ====
-To execute a basic search for data, you can specify the search term in the top-right box in the search engine and then execute the search by hitting the magnifying glass symbol:+To perform a basic search for data, you can specify the search term in the top-right box in the search engine and then execute the search by clicking on the magnifying glass symbol:
  
 {{ :rdms:webapp:rdms_search_simple_1.jpg?direct&900 |}} {{ :rdms:webapp:rdms_search_simple_1.jpg?direct&900 |}}
Line 68: Line 68:
 This will search for the specified search term using the standard search parameters.  This will search for the specified search term using the standard search parameters. 
  
-To make the search results more precise, you can adjust the search criteria. For example, you can specify that just data created in a certain time frame should be shown, that you want to see files only, that just a certain RDMS path should be search, and much more.+To make the search results more precise, you can adjust the search criteria. For example, you can specify if you want only data created within a certain time frame to be shown, to see files only, to search only certain RDMS paths, and much more.
  
 {{ :rdms:webapp:rdms_search_simple_2.png?direct&900 |}} {{ :rdms:webapp:rdms_search_simple_2.png?direct&900 |}}
Line 79: Line 79:
  
 **Note:** **Note:**
-  * This simple search will display results where the search term is found at various places. For example, it will find results where the search term is in the file name, but also where it is found in the metadata. +  * This simple search will display results where the search term is found at various locations. For example, it will find results where the search term appears in the file name, as well as where it is found in the metadata. 
  
-==== Search using Metadata ====+==== Search Using Metadata ====
  
 While the general search view can be also used to search based on metadata, the separate key/value/extra search was specifically designed to facilitate searches/queries that use multiple, combined metadata values as the search criteria.  While the general search view can be also used to search based on metadata, the separate key/value/extra search was specifically designed to facilitate searches/queries that use multiple, combined metadata values as the search criteria. 
Line 126: Line 126:
 ==== More Advanced Search Syntax ==== ==== More Advanced Search Syntax ====
  
-While it was shown above how files and folders can be found based on different parameters (name, metadata, etc.), and it was also shown that search criteria can be adjusted via the available menu to fine-tune search results, we will elaborate here which additional tricks you can use in the search syntax. +While it was shown above how files and folders can be found based on different parameters (name, metadata, etc.), and it was also shown that search criteria can be adjusted via the available menu to fine-tune search results, we will elaborate here advanced search syntax for further customization.
  
-When you specify a search term in the field, it is important to know that you can also used additional wildcard cards in your query. These wildcard characters are+When you specify a search term in the field, it is important to know that you can also use additional wildcard characters in your query. These wildcard characters are:
  
-  * ''_'': The underscore is the wildcard for **one sign**. So searching for "Device_-Data" will find results for "DeviceA-Data", "DeviceB-Data", and so on, but no result for "DeviceXXX-Data"+  * ''_'': The underscore is the wildcard for **one character**. So searching for "Device_-Data" will find results for "DeviceA-Data", "DeviceB-Data", and so on, but not for "DeviceXXX-Data"
-  * ''%'': The percentage sign is the wildcard for an **undefined** amount of signs. So searching for "Device%-Data" will find the same results as described for "Device_-Data", but additionally also "DeviceXXX-Data".+  * ''%'': The percentage sign is the wildcard for an **undefined** number of characters. So searching for "Device%-Data" will find the same results as described for "Device_-Data", but additionally also "DeviceXXX-Data".
  
-It is important to note that this wildcard characters can be of course also used for the search based on metadata. +It is important to note that these wildcard characters can also be used for the search based on metadata. 
  
-To see how we can use this wildcards for further filtering of our query, take a look at this example where we first searched for "Device" which gave us in this case six similarly, but still slightly differently named folders:+To see how you can use these wildcards for further filtering of your query, take a look at this example where we first searched for "Device". This search yielded six similarly named folders, each with slight variations:
  
 {{ :rdms:webapp:rdms_search_syntax_1.jpg?direct&900 |}} {{ :rdms:webapp:rdms_search_syntax_1.jpg?direct&900 |}}
  
-Assuming that we now just want to find the configuration data for all the devices 1-3, we could use a search term like "Device%_Configuration_Data" which will yield:+Assuming that we now just want to find the configuration data for all devices 1-3, we could use a search term like "Device%_Configuration_Data" which will yield:
  
 {{ :rdms:webapp:rdms_search_syntax_2.png?direct&900 |}} {{ :rdms:webapp:rdms_search_syntax_2.png?direct&900 |}}
Line 145: Line 145:
 As we used the ''%'' wildcard character in this example, this would also find results like "Device312_Configuration_Data" or "DeviceBuilding4_Configuration_Data". As we used the ''%'' wildcard character in this example, this would also find results like "Device312_Configuration_Data" or "DeviceBuilding4_Configuration_Data".
  
-In another example, we want to find boththe analytical and configuration data folder for our "Device1", but we do not want to get the results for the other devices. This could be achieved with a query of the form "Device1_%_Data" as seen here:+In another example, suppose we want to find both the analytical and configuration data folders for "Device1", but we do not want results for the other devices. This could be achieved with a query of the form "Device1_%_Data" as seen here:
  
 {{ :rdms:webapp:rdms_search_syntax_3.png?direct&900 |}} {{ :rdms:webapp:rdms_search_syntax_3.png?direct&900 |}}
  
-Next to the wildcard characters, it is also possible to use ''&'' and ''|'' in the search will will act as "and" and "or" operators, respectively.  +In ddition to the wildcard characters, it is also possible to use ''&'' and ''|'' in the search, which act as "and" and "or" operators, respectively.  
-Let's assume that you want to find the results that contain either "Device1" or "Device2" in their name. A search query for this could use the "or" statement to connect both terms like "Device1 | Device2" which will yield:+Let's assume that you want to find results that contain either "Device1" or "Device2" in their name. A search query for this can use the "or" statement to connect both terms like "Device1 | Device2" which will yield:
  
 {{ :rdms:webapp:rdms_search_syntax_4.png?direct&900 |}} {{ :rdms:webapp:rdms_search_syntax_4.png?direct&900 |}}
  
 **Note:**\\ **Note:**\\
-As seen above, we can use wildcards to further fine-tune our search results. With the other settings that are available in the search interface as well as with the possibility to use metadata, this offers a lot of capability to modify searches to yield our desired results. +As seen above, you can use wildcards to further fine-tune your search results. With other settings that are available in the search interface together with the possibility to use metadata, these advanced search techniques offer a lot of capability to obtain precise results tailored to your specific requirements. 
 + 
 +==== Filtering Your Search Results ==== 
 + 
 +In some cases, your search parameters might return a pool of results that is too large to find what you are looking for. As shown in the figure below, the RDMS Web interface also warns you when the number of results exceeds 10.000: 
 + 
 +{{ :rdms:search:sfilter_1.png?direct&800 |}} 
 + 
 +To fix this, you might want to redefine your search parameters, as the Web interface suggests. However, this can sometimes result in having to wait a long time for a search to run again. Alternatively, you might want to filter the results you have already obtained. To do so, type an additional keyword in the bar highlighted by the red box in the figure below. 
 + 
 +{{ :rdms:search:sfilter_2.png?direct&800 |}} 
 + 
 +With the new keyword added, the RDMS Web interface will show you only the results which contain the keyword. Thus you can reduce the amount of displayed results without running a new search. The figure below shows what the filtering looks like. 
 + 
 +{{ :rdms:search:sfilter_3.png?direct&800 |}} 
 + 
 +**Note:** You are filtering the results rather than redefining the search parameters. This means that should you save the search and run it again, you will again encounter too many results. Each time you run that specific search, you will need to manually filter the results. We recommend that for frequently performed searches, you redefine the parameters once you have identified the optimal keyword combination through filtering.