Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Search

Terms

Options

The Search In many cases you will want to search for one or more concepts for the purposes of editing or reference. The search tab allows you to search SNOMED by typing text in the search field. After pressed Enter key, it will lists all concepts that match your query.  The search tab contains a number of features:

  • View search results by matching terms or grouped by concept
  • Distinguish between primitive and fully defined concepts in a set of search results
  • Distinguish between active and inactive concepts in a set of search results
  • View more details about a concept in a set of search results
  • Add concepts from a set of search results to a saved list for future use

  • You can use wildcards in the search term to find partial matches.

    CT for concept matches to Fully Specified Name (FSN) text patterns, concept and relationship SCTIDs, or SNOMED CT ECL expressions. On first opening the tab, a search query text box is presented with a prompt to enter at least three characters. This triggers a text search of SNOMED CT for matches by name or by SCTID. Two large buttons are presented below the search query box - the first is a toggle button for filtering results as Active Only | Inactive Only | Active and Inactive - see the Search Results section below for further details of its use; the second button toggles the search mode from Text Mode (the default setting on opening the Search tab) to ECL Mode. In ECL Mode, the query box adapts to receive an ECL expression, and an additional term filter box is presented which supports lexical filtering of the ECL expression match results. For both modes, the Active Only | Inactive Only | Active and Inactive toggle button remains available to act on the full results set. Note that ECL searches which traverse multiple hierarchies and ranges can take a few seconds to complete and present the results.

    Search by name

    This a standard text pattern match against concept Fully Specified Names (FSNs).

    StepsReference
    If previously switched to ECL Mode, press Switch to Text Mode.

    Image Added

    Enter at least three characters into the search query box. Type-ahead searching starts to present results as soon as 3 or more characters are entered (automatic type-ahead search is not triggered until a slight pause in normal typing).

    Wildcard characters can be used to elaborate the search query.

    Asterisk ( * ) matches all subsequent characters regardless of word length.

    Question mark ( ? ) matches a single character

    ; if more than character wildcard is used the search pattern finds all words stemmed by the search pattern (including those longer than the pattern length); it also matches words with fewer letters than all the additional character wildcards, but matching up their length). For example:

    punc* would find all words stemmed with "punc" eg punch, punched, punctum, puncture etc
    punc? would find punch
    punc??? would find punctate, puncture, punch, punched, punctum and puncture
    punc?u? would find punctum and puncture, but not punched

    .

    Image Added


    Image Added

    Image Added

    Entering more characters automatically updates the results set to match the entered text pattern.

    Image Added

    A clear query X button will appear in the right upper corner of the query box once text is entered. Press this to clear the current query. Standard operating system keyboard select/cut/paste/delete key combinations can also be used to manipulate the query once entered.

    Image Added


    Image Added


    Image Added


    Search by SCTID

    This is a numeric exact match to a SNOMED CT concept SCTID; it can be useful for locating newly created concepts. Purely numeric search queries will try to match against

    SNOMED CT identifiers

    SCTIDs, and return an error message if none are found. For example searching for 300 returns "Error performing search: [object Object]: Not Found: Concept with identifier '300' could not be found." To search for a numeric value in an FSN, SYN etc, put quotes around the number or add a wildcard * to the end of the query (eg "300" or 300*). The search will then find matches in text content (including partial matches, so "300" will match "300", "200-300", "300,000" etc.


     

    Search by Concept Id concept

    StepsReference

    If

    desired a single concept id can be used to locate a specific concept. This is useful for newly created concepts.

    Image Removed

    View search results by matching terms or grouped by concept

    StepsReference

    From the search tab, you may type a query into the search field and the search widget will begin to locate results. You can toggle your results view between matching terms (left) or grouped by concept (right)   by selecting the checkbox next to the search field. 

    Image Removed

    View Matching Terms

    This search query returns all cases of a query. Eg. If i search for Diabetes mellitus excluded I would receive 3 search results for this concept since my word "diabetes" is used three times when defining this concept.

    Image Removed

    Grouped By Concept

    For this same search query, if I select Grouped By Concept, I will only receive one search result for each concept, narrowing my search result to one.

    Image Removed

    Distinguish and filter between active, inactive, primitive and fully defined concepts in a set of search results

    StepsReference
    • In a set of search results a primitive concept is identified by a Image Removed Primitive  icon  and a fully defined concept is identified by a Image Removed Fully Defined icon.
    • In a set of search results an inactive concept is identified by a  Image Removed  icon.

    Image Removed

    If desired search results can be filtered to active concepts only by selecting the Active Only button

    Image Removed

    View more details about a concept in a set of search results, and its position in the taxonomy

      
    From a set of search results you may want to view more details about a concept before adding it to your saved list or selecting it for editing. To do so click either the   Image Removed   or Image Removed icon within the concept that you wish to display the details of and a modal will appear. 
    Image Removed
    Selecting the taxonomy tab in the modal will allow a user to view the concepts position within the hierarchy.

    Image Removed

    previously switched to ECL Mode, press Switch to Text Mode.

    Image Added

    Enter a numeric value corresponding to an SCTID into the search query box (no leading or trailing spaces). Cut and paste from another resource is often the easiest way to do this, but the value can simply be typed via the keyboard as for text searches. As for searching by name, once a numeric query is entered the clear query X button appears in the upper right corner of the query box, with the behaviour described above for searching by name.

    Image Added

    For concept SCTIDs, the single concept matching the SCTID will be found if it exists. Note that unless the results filtering is not currently set to Active and Inactive, a valid search result may be hidden if set to the non-matching status filter. If no results are returned for a known good SCTID when showing Active Only or Inactive Only, then press the button to see the other status filters (eg 232971009 which is an inactive concept, needs the result filtering set to Inactive Only or Active and Inactive to see the search result).

    Image Added


    Image Added

    Image Added

    Image Added

    For description SCTIDs, the concept containing the description SCTID will be found if it exists.

    Image Added

    For relationship SCTIDs, both the source and target concepts for that relationship SCTID will be found if it exists.

    Image Added


    Search by ECL Expression

    For more complex searches, such as locating only concepts within particular ranges or located in particular hierarchies within SNOMED CT, the ECL Mode supports expressions (supporting ECL 1.1.1 from AP Version 2.1.0, ECL 1.3 from AP Version 2.9.0). Since ECL is a large topic the steps below illustrate only some basic examples - please see for further reading on more refined ECL expressions.

    StepsReference

    When in Text Mode (default on opening Search tab), press Switch to ECL Mode.

    Image Added

    Enter an ECL expression into the search query box.

    Image Added

    Press the Search button to the right of the query box, or press Enter on the keyboard.

    Image Added

    After obtaining ECL expression search results, the results set can be refined by entering an additional term filter in the query box below the expression. For example the ECL expression >!* returns all concepts that are leaf nodes. By adding an additional term filter a particular set of matching leaf nodes can be found, such as all leaf nodes containing the word "limb" in their FSN.

    Image Added


    Search Results

    After using one of the above methods, a list of search results will be presented with concepts matching the search query/expression. The total number of concepts found is shown at the top of the results list. Results can be processed as illustrated in the steps below:

    StepsReference

    Press Active Only to exclude inactive concepts from the results set.

    Image Added

    Press Inactive Only to exclude active concepts from the results list.

    Image Added

    Press Active and Inactive to show the full results set.

    Image Added

    Scroll the results list to see currently displayed results when many matches are returned (for large results sets, only the first 100 are initially loaded in the list).

    Image Added

    When more than 100 results are found, press Load Next 100 at the bottom of the list to add the next set of (up to) 100 results not currently listed. The loading is cumulative, in that the list expands each time to include the previous results shown. When all results are listed, the button changes to an End of Results label indicating that all matches are listed (and can be seen by scrolling up/down the list).

    Image Added

    View the definition status of a search result concept via the icon to the left of its name (FSN). Press the definition status button to open a pop-up box with detailed information about the concept, including Hierarchy (parent/child concepts), Descriptions and Relationships; an active concept also has an option to see its hierarchical location in a Taxonomy tab within the pop-up box.

    Image Added

    Image Added

    Press a search result name link to open the concept in the edit panel.

    Image Added

    When viewing inactive results, distinguish such concepts in the results list via their Inactive Concept status icon.

    Image Added

    Press an active concept search result View in Taxonomy button to open the Taxonomy tab with focus set to the search result concept.

    Image Added

    Press a search result Add to Saved List button to retain the concept for future retrieval via the Saved List tab.

    Image Added

    Press a search result Clone this Conceptbutton to create a new concept in the edit panel with the same terms and relationships.

    Image Added

    Add Concepts From Search Results to the Saved List

    StepsReference

    If you want to save a concept into the Saved List from the search results, you can click the 'add' button Image Removed  to add the concept into the Saved List. After the concept is added, the 'add' button is disabled  Image Removed , so you can't add the same concept into the Saved List twice.

     

    For more information on the saved list see, Task View - Saved List

    Image Removed