Search For Items Within Jama

By Jama posted 01-29-2015 16:20


Jama offers a robust search feature that allows both regular and power users to find items across projects.

Search Basics:

When you log into Jama, the search field is located in the top-right section of Jama.

Some out-of-the-box fields, such as name and description, are indexed for easy searching. By default, the Project scope is selected. This means when you perform the search, Jama will return results for items within your current project only. You may expand the scope of the search to all projects within the organization by selecting “All” from the drop-down.

Note: Jama will return only items you have permission to see. Even if you select “all” you will not get all the results in each project if your permissions are limited to a few projects or sets within a project. 

Sometimes when you search, you get too many results and will want to narrow the scope of those results. To do this, select Filter Results to add additional search criteria. Depending on your version of Jama, you will see different criteria available to filter by, including the author, last modified date, and keywords. Each option in a given criteria will show a count in parenthesis of how many items have that value.



Advanced Searching:

All search within Jama is powered by the Apache Lucene engine*. The Lucene engine allows users to utilize Boolean operators, such as AND and OR when searching for items. 

The main areas where users will interact with search are filters, the search bar, legacy integration connector filters, and the SOAP API call, getItemsFromTextSearch().

Advanced Filters are a powerful, user-friendly tool that can be saved and accessed later on. In most cases, you will want to use a filter as opposed to the search bar, especially if the same data will be accessed frequently. Filters offer a UI with drop-down components that frees users from manually entering search logic. Certain rules, such as Keywords, within a filter do allow for search syntax.

Advanced searching within the Search Bar, legacy integration connectors, and SOAP will require a more in-depth understanding of how the search engine works. More information on how to utilize the Lucene query syntax can be found in the Jama Help Guide

*Note: While Jama search is powered by Lucene, not all syntax in Lucene is supported. Refer to the help guide for all supported logic.