Differences

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

--- searching [2022/08/04 22:36]
ali [User interface]
+++ searching [2025/05/10 21:57] (current)
ali [User interface]
@@ Line 1: / Line 1: @@
 ===== Searching =====
+{{ :PIMSLS_searching.mp4?direct |}}
 ==== User interface ====
-PMA.core provides multiple ways to search slides. On clicking the "Toggle Search Panel" button search panel opens up that allows you to search different slides for selected PMA.core server using PMA.core meta data API. Search UI allows you to select PMA.core server and perform search based on forms and fields against a slide.
+PIMS LS provides multiple ways to search slides which have been indexed by a PMA.core. Clicking the "Toggle Search Panel" button opens up the search panel.\\
+Here you can search for slides within the selected PMA.core server.
-{{:pma-search-ui.png?direct&600|}}
+The Search panel can be activated from the home tab:
-==== Conducting searches ====
+{{:search_3.0.png?direct |}}
-To conduct a search; user needs to select the PMA.core server from the dropdown list, by default the logged in PMA.core server is selected. Then by default "AND" logical operator is selected and user can change it to "OR" as per the logical condition to be applied on the selected parameters. Then we have the list of forms and respective form fields user can choose from. By default a hardcoded form value "Slide" is selected with two fields "path" and "barcode" which allows you to search slides through path and barcodes. User can select the form and respective fields as per their search criteria. You can add multiple conditions using the "Add Condition" button.
+==== Searching Filenames ====
-{{:conduct_search.png?direct&600|}}
+To conduct a search you need to select a PMA.core server from the dropdown list.\\
+By default the currently logged in PMA.core server is selected. \\
+{{ :searchslide.png?direct |}}
+The default search term is 'Slide' and 'Path' which will search the paths / filenames for something matching the value you type in to the text box.
+====Searching Form Results====
+By clicking on the first dropdown menu (default:Slide) you will open a dropdown menu which will allow you to select a Form to search instead of a Slidename.
+When you select a form, in the second dropdown menu you will see the different questions in the form for you to select for your search
+{{ :searchform.png?direct |}}
+Now you can type the value you are looking for into the search value box, and running the search will find slides that have that result.
+====Multiple Search Conditions====
+By clicking 'Add condition' you can define a second term to your search:
+  * For example, lets say you wanted to search for a file in "Study X" with a HER2 score of 2+
+  * You could define search term 1 as Slide Path "Study X", and search term 2 as HER2 form -> HER2 score "2+"
+  * The search would bring back only slides with "Study X" in the name and a result of 2+ in the HER2 form, HER2 status question
+{{ :conduct_search.png?direct |}}
+====AND vs OR: Logical Operators====
+By default the AND logical operator is selected.
+When AND is selected, the search will only bring up results that match ALL search conditions.
+However, you can change the logical operator to "OR". This will fetch results that meet ANY of the search terms you have put in.
 ==== Interpreting results ====
-Once you have selected search conditions and then press "Search" button list of results would show up if any. The results consists of "Folder", "Slide name" and action button "Load to grid" that loads the selected search record slide to the viewport.
+Once you have selected search conditions and press "Search" a list of results will appear if found. \\
+The results consists of "Folder", "Slide name" and the "Load to grid" button which loads the selected slide to the viewport
 {{:search-results.png?direct&600|}}
-{{:load_to_grid.png?direct&600|}}
-==== Refining search commands and troubleshooting ====
-User can refine search according to the liking. UI allows you to select multiple forms with respective fields and apply conditions on them to get the desired results. You can add or remove conditions at will using the "remove" button.
+==== Refining Search Commands and Troubleshooting ====
-{{:refine_search.png?direct&600|}}
+The search panel lets you select multiple forms or slide paths and apply conditions to get the desired results. \\
+You can add or remove conditions at will using the "remove" button.
-If search do not match any records then no record message appears.
+{{:refine_search.png?direct&600|}}
-{{:no_record_found.png?direct&600|}}
-==== Integration with PMA.search ====
+**Please note: search only works on information that is indexed by PMA.core. If you cannot search something that you believe you should be able to, please contact your administrator.**

PIMS LS 3.0.1

User Tools

Site Tools

Differences

Page Tools