<p>The <b>Find Terms view</b> is designed to allow users to search for concepts. Users can search by the name or by a particular code. Once the appropriate concept is found it can be used in many of the i2b2 views and plug-ins, such as the <i>Query Tool view</i>.
<p>This section describes the layout and contents of this view.</p>
<p> </p>
<h3><aname="ftLayout"id="ftLayout"></a>Layout of the Find Terms View</h3>
<p>The <b>Find Terms view</b> allows users to search for a concept, group of concepts, and their associated modifiers. There are basically two methods of searching available;(1) by name and (2) by code.
<pclass=NoteParagraph>Regardless of how you search for the concept the layout of both tabs is the same.</p>
</td>
</tr>
</table>
<p> </p>
<p> </p>
<p> </p>
<h4><aname="ftSearchOptions"id="ftSearchOptions"></a>Search by Options</h4>
<p>This section has two tabs; one is to <b>Search by Name</b> and the other <b>Search by Code</b>. Depending on which tab is active will determine which search method is used to find the concept.
<p>The qualifier is used to tell the system whether or not you are looking for an exact match or just a partial match. There are four different options to choose from.
<p>The clinical vocabulary that resides in the Ontology Management Cell was partially built using terminology from several standard coding systems. These codes can be used to search for a particular term (see section on <i>Search by Code</i>). The following are some examples of standard coding systems.
</p>
<p> </p>
<h4><aname="ftIcd9"id="ftIcd9"></a>ICD-9</h4>
<ul>
<li>International Classification of Diseases, 9th Revision</li>
<li>Primarily used for disease surveillance, immunization rates and environmental monitoring.</li>
<li>Maintained by the National Center for Health Statistics (NCHS) and Centers for Medicare and Medicaid Services (CMS).
<li>Logical Observation Identifiers Names and Codes</li>
<li>Primarily used for Clinical Health Information (CHI) such as laboratory and clinical test results, history and physicals, discharge summaries, operative notes, tumor registry and nursing observations.
</li>
<li>Licensed and maintained by Regenstrief Institute.</li>
<h3><aname="ftModLayout"id="ftModLayout"></a>Layout of the Find Modifiers Section of Find Terms View</h3>
<p>An additional section called <b>Find Modifiers </b> is located at the bottom of the <i>Find Terms view</i>. This section is only visible once you find a term and select to find the modifiers from the pop-up menu (see section on Finding Modifiers).
<p>The functionality of finding modifiers is very similar to finding terms in that you can search by name or by code and you can define the search criteria to be used when performing the search.
<p>The qualifier is used to tell the system whether or not you are looking for an exact match or just a partial match. There are four different options to choose from.
<h3><aname="ftExpCollFolder"id="ftExpCollFolder"></a>Expand / Collapse a Folder</h3>
<p>Depending on the search criteria, the results section may display groups of concepts which are contained in folders as well as individual concepts. The folders can be expanded to see the listing of concepts in that grouping by clicking on the plus sign <spanstyle="color:#CCCCCC">(<imgsrc="images/plusSign.png"alt="plusSign"/>)</span> or negative sign <spanstyle="color:#CCCCCC">(<imgsrc="images/minusSign.png"alt="minusSign"/>)</span> next to the folder icon.
</p>
<p> </p>
<tableid=note>
<tr>
<td>
<pclass=NoteHeading>NOTE: </p>
<pclass=NoteParagraph>The ability to expand and collapse folders also extends to the modifier result section which can contain modifiers.
</p>
</td>
</tr>
</table>
<p> </p>
<h4><aname="ftExpFolder"id="ftExpFolder"></a>Expand (Open) a Folder</h4>
<ol>
<li>Click on the <b>plus sign</b><spanstyle="color:#CCCCCC">(<imgsrc="images/plusSign.png"alt="plusSign"/>)</span> next to the folder in the results section of <i>Find Terms view</i> or the Modifier folder in the <i>Find Modifiers section</i>.
</li>
<li>The folder will open and all the items in the folder will display.</li>
</ol>
<p> </p>
<h4><aname="ftCollFolder"id="ftCollFolder"></a>Collapse (Close) a Folder</h4>
<ol>
<li>Click on the <b>negative sign</b><spanstyle="color:#CCCCCC">(<imgsrc="images/minusSign.png"alt="minusSign"/>)</span> next to the folder in the results section of <i>Find Terms view</i> or the Modifier folder in the <i>Find Modifiers section</i>.
</li>
<li>The folder will close and all the items in the folder will no longer display.</li>
<p>Users can define how many concepts to display and whether or not to show hidden terms and/or synonyms. The display options are set in the Find Terms Options dialog window, which can be accessed by clicking on the <b>Show Options button</b><spanstyle="color:#CCCCCC">(<imgsrc="images/options.png"alt="options"/>)</span>.
<h4><aname="ftDisplayMax"id="ftDisplayMax"></a>Maximum to Display</h4>
<p>The <b>Maximum number of children to display</b> is used when retrieving the search results to be displayed in the results section of the <b>Find Terms view</b>. Once the maximum number is reached a message will appear informing you that the query has reached the maximum number of terms and suggests you try searching again with a more specific query. Running a search with a more specific query will narrow your results as the selection criteria will not be as broadly defined.
<p>In the metadata table, an attribute is set to determine whether or not a term is active, inactive or hidden. If an item is marked as hidden it will not appear in the list of terms. Selecting <b>Show Hidden Terms</b> will display those items marked to be hidden. For easy identification, hidden terms will be <spanstyle="color:#FF0000">red</span> when displayed in the results list.
<p>Some terms may be flagged in the metadata table as a synonym of another term. Selecting <b>Show Synonymous Terms</b> will display both the original term and the synonym in the <i>Find Terms view</i>. For easy identification, synonymous terms will be <spanstyle="color:#000099">blue</span> when displayed in the results list.
<p>The <b>Enable patient counts</b> option will display the total number of patients that have an observation fact entered for that item.
</p>
<p> </p>
<p> </p>
<h4><aname="ftUseShortTooltips"id="ftUseShortTooltips"></a>Use Short Tooltips</h4>
<p>By default, the tooltip that displays when you hover over an item will contain the entire path name and the tooltip that is specific to that item. Enabling the <b>Use short tooltips</b> option will only display the tooltip information; the path will not be included.
</p>
<p> </p>
<p> </p>
<h4><aname="ftShowConceptCd"id="ftShowConceptCd"></a>Show Concept Codes in Tooltips</h4>
<p>In addition to showing the tooltip, this option will also display the concept_cd associated to the item.
<p>This section describes how to search for a term using one of
the two available methods; (1) Search by Name and (2) Search by Code.
</p>
<p> </p>
<p>Regardless of whether you are searching by name or by code, the first step in entering the search criteria is defining a qualifier. The first field is the “qualifier” and it is a drop-down list with four options:
</p>
<p> </p>
<p></p>
<ol>
<li>Starting with</li>
<p>The results returned will contain only those terms whose name or code begins with the text entered in the search box.
</p>
<p> </p>
<li>Ending with</li>
<p>The results returned will contain only those terms whose name or code ends with the text entered in the search box.
</p>
<p> </p>
<li>Containing</li>
<p>The results returned will be those terms whose name or code ends with the text entered in the search box.
</p>
<p> </p>
<tableid=note>
<tr>
<td>
<pclass=NoteHeading>NOTE: </p>
<pclass=NoteParagraph>This search will return the broadest range of results.
</p>
</td>
</tr>
</table>
<p> </p>
<p> </p>
<li>Exact</li>
<p>The results returned will be those terms whose name or code matches exactly to the text entered in the search box.
</p>
<p> </p>
<tableid=note>
<tr>
<td>
<pclass=NoteHeading>NOTE: </p>
<pclass=NoteParagraph>This search will return the narrowest range of results.
</p>
</td>
</tr>
</table>
<p> </p>
<p> </p>
</ol>
<h3><aname="ftSearchName"id="ftSearchName"></a>Search by Name</h3>
<p>The method of searching by the name is exactly what it sounds like; you can search for a concept by its name.
</p>
<p> </p>
<h4><aname="ftSearchNameStart"id="ftSearchNameStart"></a>Search Using "Starting with"</h4>
<p> </p>
<ol>
<li>Click on the <b>drop-down arrow</b> located in the qualifier field.</li>
<li>To narrow your search to a particular category, click on the <b>drop-down arrow</b> in the <i>category selection box</i>. Otherwise, accept the default of Any Category.
<li>To narrow your search to a particular category, click on the <b>drop-down arrow</b> in the <i>category selection box</i>. Otherwise, accept the default of Any Category.
<li>To narrow your search to a particular category, click on the <b>drop-down arrow</b> in the <i>category selection box</i>. Otherwise, accept the default of Any Category.
<li>To narrow your search to a particular category, click on the <b>drop-down arrow</b> in the <i>category selection box</i>. Otherwise, accept the default of Any Category.
<h3><aname="ftSearchCode"id="ftSearchCode"></a>Search by Code</h3>
<p>Some of the concepts have a standard code associated with them. This code can be used to search for a specific concept or a grouping of concepts.
</p>
<p> </p>
<p> </p>
<tableid=note>
<tr>
<td>
<pclass=NoteHeading>NOTE: </p>
<pclass=NoteParagraph>The steps listed in this section walk you through a code search using LOINC codes. These same steps can be used when doing a search of any type of code. In step 4, replace LOINC with the coding system you want to search.
</p>
</td>
</tr>
</table>
<p> </p>
<p> </p>
<h4><aname="ftSearchLoinc"id="ftSearchLoinc"></a>Search Using LOINC Code</h4>
<p> </p>
<ol>
<li>In the text box enter the code for the term you are searching on.</li>
<p>A modifier is associated with a single term or a group of terms. Therefore in order to search for a modifier you must first search for the term. Once the term is found you can begin the process of finding the modifier. Overall the process of finding modifiers is very similar to searching for a term; you can search by name or by code.
</p>
<p> </p>
<p>Regardless of whether you are searching by name or by code, the first step in entering the search criteria is defining a qualifier. The first field is the “qualifier” and it is a drop-down list with four options:
</p>
<p> </p>
<p> </p>
<ol>
<li>Starting with</li>
<p>The results returned will contain only those modifiers whose name or code begins with the text entered in the search box.
</p>
<p> </p>
<li>Ending with</li>
<p>The results returned will contain only those modifiers whose name or code ends with the text entered in the search box.
</p>
<p> </p>
<li>Containing</li>
<p>The results returned will be those modifiers whose name or code ends with the text entered in the search box.
</p>
<p> </p>
<tableid=note>
<tr>
<td>
<pclass=NoteHeading>NOTE: </p>
<pclass=NoteParagraph>This search will return the broadest range of results.
</p>
</td>
</tr>
</table>
<p> </p>
<p> </p>
<li>Exact</li>
<p>The results returned will contain only those modifiers whose name or code matches exactly to the text entered in the search box.
</p>
<p> </p>
<tableid=note>
<tr>
<td>
<pclass=NoteHeading>NOTE: </p>
<pclass=NoteParagraph>This search will return the narrowest range of results.
</p>
</td>
</tr>
</table>
<p> </p>
<p> </p>
<p> </p>
</ol>
<h3><aname="ftModSearchName"id="ftModSearchName"></a>Find Modifiers by Name</h3>
<p>The method of searching by the name is exactly what it sounds like; you can search for a modifier by its name.
</p>
<p> </p>
<tableid=note>
<tr>
<td>
<pclass=NoteHeading>NOTE: </p>
<pclass=NoteParagraph>As stated above you must first search for the term before you can find the associated modifiers.
</p>
</td>
</tr>
</table>
<p> </p>
<p> </p>
<p> </p>
<h4><aname="ftModSearchNameStart"id="ftModSearchNameStart"></a>Search Modifiers Using "Starting with"</h4>
<p> </p>
<ol>
<li>Search for your term by either name or code.</li>
<li>Using the <i>right mouse button</i>, click on the name of the <b>concept</b><spanstyle="color:#CCCCCC">(<imgsrc="images/leaf.png"alt="leaf"/>)</span> or <b>folder</b><spanstyle="color:#CCCCCC">(<imgsrc="images/folder.png"alt="folder"/>)</span>.
</li>
<li>A pop-up menu will open.</li>
<p> </p>
<p><imgsrc="images/ftMenu.png"alt="ftMenu"/></p>
<p> </p>
<p> </p>
<li>Select <b>Find Modifiers</b> from the list.</li>
<h4><aname="ftModSearchNameEnd"id="ftModSearchNameEnd"></a>Search Modifiers Using "Ending with"</h4>
<p> </p>
<ol>
<li>Search for your term by either name or code.</li>
<li>Using the <i>right mouse button</i>, click on the name of the <b>concept</b><spanstyle="color:#CCCCCC">(<imgsrc="images/leaf.png"alt="leaf"/>)</span> or <b>folder</b><spanstyle="color:#CCCCCC">(<imgsrc="images/folder.png"alt="folder"/>)</span>.
</li>
<li>A pop-up menu will open.</li>
<p> </p>
<p><imgsrc="images/ftMenu.png"alt="ftMenu"/></p>
<p> </p>
<p> </p>
<li>Select <b>Find Modifiers</b> from the list.</li>
<h4><aname="ftModSearchNameContain"id="ftModSearchNameContain"></a>Search Modifiers Using "Containing"</h4>
<p> </p>
<ol>
<li>Search for your term by either name or code.</li>
<li>Using the <i>right mouse button</i>, click on the name of the <b>concept</b><spanstyle="color:#CCCCCC">(<imgsrc="images/leaf.png"alt="leaf"/>)</span> or <b>folder</b><spanstyle="color:#CCCCCC">(<imgsrc="images/folder.png"alt="folder"/>)</span>.
</li>
<li>A pop-up menu will open.</li>
<p> </p>
<p><imgsrc="images/ftMenu.png"alt="ftMenu"/></p>
<p> </p>
<p> </p>
<li>Select <b>Find Modifiers</b> from the list.</li>
<h4><aname="ftModSearchNameExact"id="ftModSearchNameExact"></a>Search Modifiers Using "Exact"</h4>
<p> </p>
<ol>
<li>Search for your term by either name or code.</li>
<li>Using the <i>right mouse button</i>, click on the name of the <b>concept</b><spanstyle="color:#CCCCCC">(<imgsrc="images/leaf.png"alt="leaf"/>)</span> or <b>folder</b><spanstyle="color:#CCCCCC">(<imgsrc="images/folder.png"alt="folder"/>)</span>.
</li>
<li>A pop-up menu will open.</li>
<p> </p>
<p><imgsrc="images/ftMenu.png"alt="ftMenu"/></p>
<p> </p>
<p> </p>
<li>Select <b>Find Modifiers</b> from the list.</li>
<h3><aname="ftModSearchCode"id="ftModSearchCode2"></a>Find Modifiers by Code</h3>
<p>Some of the modifiers have a standard code associated with them. This code can be used to search for a specific modifier or a grouping of modifiers.
</p>
<p> </p>
<tableid=note>
<tr>
<td>
<pclass=NoteHeading>NOTE: </p>
<pclass=NoteParagraph>As stated above you must first search for the term before you can find the associated modifiers.
</p>
</td>
</tr>
</table>
<p> </p>
<p> </p>
<p> </p>
<h4><aname="ftModSearchCode"id="ftModSearchCode2"></a>Search by Modifier Code</h4>
<p> </p>
<ol>
<li>Search for your term by either name or code.</li>
<li>Using the <i>right mouse button</i>, click on the name of the <b>concept</b><spanstyle="color:#CCCCCC">(<imgsrc="images/leaf.png"alt="leaf"/>)</span> or <b>folder</b><spanstyle="color:#CCCCCC">(<imgsrc="images/folder.png"alt="folder"/>)</span>.
</li>
<li>A pop-up menu will open.</li>
<p> </p>
<p><imgsrc="images/ftMenu.png"alt="ftMenu"/></p>
<p> </p>
<p> </p>
<li>Select <b>Find Modifiers</b> from the list.</li>
<h3><aname="ftModSearchGetAll"id="ftModSearchGetAll"></a>Find All Modifiers</h3>
<p>In the Find Modifiers section of the Find Terms view there is a Get All button. This button will return all the modifiers associated to a term.
</p>
<p> </p>
<tableid=note>
<tr>
<td>
<pclass=NoteHeading>NOTE: </p>
<pclass=NoteParagraph>As stated above you must first search for the term before you can find the associated modifiers.
</p>
</td>
</tr>
</table>
<p> </p>
<p> </p>
<p> </p>
<h4><aname="ftModSearchCode"id="ftModSearchCode3"></a>Get All Modifiers</h4>
<p> </p>
<ol>
<li>Search for your term by either name or code.</li>
<li>Using the <i>right mouse button</i>, click on the name of the <b>concept</b><spanstyle="color:#CCCCCC">(<imgsrc="images/leaf.png"alt="leaf"/>)</span> or <b>folder</b><spanstyle="color:#CCCCCC">(<imgsrc="images/folder.png"alt="folder"/>)</span>.
</li>
<li>A pop-up menu will open.</li>
<p> </p>
<p><imgsrc="images/ftMenu.png"alt="ftMenu"/></p>
<p> </p>
<p> </p>
<li>Select <b>Find Modifiers</b> from the list.</li>
<p>Individual as well as groups of concepts and modifiers can be dragged and dropped (copied) from the Find Terms View to other views in the i2b2 Web Client.
</p>
<p> </p>
<ol>
<li>Folder</li>
<p>A <b>folder</b><spanstyle="color:#CCCCCC">(<imgsrc="images/folder.png"width="16"height="18"alt="folder"/>)</span> and all its concepts (children) can be added to other views by dragging the folder name from <b>Find Terms</b> to one of the following views.
</p>
<p> </p>
<ul>
<li><b>Query Tool View;</b> drop in the <i>panel</i></li>
<li><b>Workplace View;</b> drop in a <i>user</i> or <i>shared folder</i></li>
</ul>
<p> </p>
<p> </p>
<li>Modifier Folder</li>
<p>A <b>modifier folder</b><spanstyle="color:#CCCCCC">(<imgsrc="images/modifierfolder.png"width="16"height="18"alt="folder"/>)</span> and all its concepts (children) can be added to other views by dragging the folder name from <b>Find Terms</b> to one of the following views.
</p>
<p> </p>
<ul>
<li><b>Query Tool View;</b> drop in the <i>panel</i></li>
<li><b>Workplace View;</b> drop in a <i>user</i> or <i>shared folder</i></li>
</ul>
<p> </p>
<p> </p>
<li>Concept</li>
<p>A <b>concept</b><spanstyle="color:#CCCCCC">(<imgsrc="images/leaf.png"alt="leaf"/>)</span> can be added to other views by dragging the name of the concept from <b>Find Terms</b> to one of the following views.
</p>
<p> </p>
<ul>
<li><b>Query Tool View;</b> drop in the <i>panel</i></li>
<li><b>Workplace View;</b> drop in a <i>user</i> or <i>shared folder</i></li>
</ul>
<p> </p>
<p> </p>
<li>Modifier</li>
<p>A <b>modifier</b><spanstyle="color:#CCCCCC">(<imgsrc="images/modifier.png"alt="modifier"/>)</span> can be added to other views by dragging the name of the modifier from <b>Find Terms</b> to one of the following views.
</p>
<p> </p>
<ul>
<li><b>Query Tool View;</b> drop in the <i>panel</i></li>
<li><b>Workplace View;</b> drop in a <i>user</i> or <i>shared folder</i></li>
</ul>
</ol>
<p> </p>
<p> </p>
<p> </p>
<h3><aname="ftAddToQt"id="ftAddToQt"></a>Add to Query Tool View</h3>
<p>A folder, individual concept, or modifier can be added to the query tool view by simply dragging the item from <b>Find Terms view</b> and dropping it into one of the panels in the <b>Query Tool view</b>.
</p>
<p> </p>
<p> </p>
<h4><aname="ftAddFolderToQt"id="ftAddFolderToQt"></a>Add Folder to Query Tool View</h4>
<ol>
<li>Highlight the <b>folder</b><spanstyle="color:#CCCCCC">(<imgsrc="images/folder.png"width="16"height="18"alt="folder"/>)</span> by clicking on the name of the folder.
</li>
<li>While holding the <i>left mouse button</i> down, drag the item over to the <b>Query Tool view</b>.</li>
<li>Drop the item into the <b>panel</b> labeled <b>Group 1</b>.</li>
<h4><aname="ftAddConceptToQt"id="ftAddConceptToQt"></a>Add Concept to Query Tool View</h4>
<ol>
<li>Highlight the <b>concept</b><spanstyle="color:#CCCCCC">(<imgsrc="images/leaf.png"alt="leaf"width="16"height="17"/>)</span> by clicking on the name of the concept.
</li>
<li>While holding the <i>left mouse button</i> down, drag the item over to the <b>Query Tool view</b>.</li>
<li>Drop the item into the <b>panel</b> labeled <b>Group 1</b>.</li>
<h4><aname="ftAddModToQt"id="ftAddModToQt"></a>Add Modifier to Query Tool View</h4>
<ol>
<li>Highlight the <b>modifier</b><spanstyle="color:#CCCCCC">(<imgsrc="images/modifier.png"alt="modifier"width="16"height="17"/>)</span> by clicking on the name of the modifier.
</li>
<li>While holding the <i>left mouse button</i> down, drag the item over to the <b>Query Tool view</b>.</li>
<li>Drop the item into the <b>panel</b> labeled <b>Group 1</b>.</li>
<h3><aname="ftAddToWp"id="ftAddToWp"></a>Add to Workplace View</h3>
<p>Information in the workplace is related to the most common concepts and queries that an individual uses and in essence becomes their personal workplace.
</p>
<p> </p>
<p><imgsrc="images/wpView.png"alt="wpView"/></p>
<p> </p>
<p> </p>
<h4><aname="ftAddFolderToWp"id="ftAddFolderToWp"></a>Add Folder to Workplace View</h4>
<p> </p>
<ol>
<li>Highlight the <b>folder</b><spanstyle="color:#CCCCCC">(<imgsrc="images/folder.png"width="16"height="18"alt="folder"/>)</span> by clicking on the name of the folder.
</li>
<li>While holding the <i>left mouse button</i> down, drag the item over to the <b>Workplace view</b>.</li>
<li>Drop the item into either your workplace folder or the shared folder.</li>
<h4><aname="ftAddModToWp"id="ftAddModToWp"></a>Add Modifier to Workplace View</h4>
<p> </p>
<ol>
<li>Highlight the <b>modifier</b><spanstyle="color:#CCCCCC">(<imgsrc="images/modifier.png"alt="leaf"/>)</span> by clicking on the name of the modifier.
</li>
<li>While holding the <i>left mouse button</i> down, drag the item over to the <b>Workplace view</b>.</li>
<li>Drop the item into either your workplace folder or the shared folder.</li>