Skip to main content

Jama Connect User Guide

Create or edit an advanced filter

Filters allow you to customize the scope of a search so it’s more granular and efficient. You can create a filter or edit an existing saved filter.

Important considerations
  • For best search results and quality performance, make your filters as specific as possible to return only the results you need. If you run a filter against all your Jama Connect projects, the results you get might be too broad to be helpful and performance can be affected by such a large data set.

Note

Only organization admins can edit filters that they didn't create. Depending on your permissions, you might not be able to edit filters that were created by other users. To view a filter's details, right-click on the filter name under the Filters tab and select View criteria.

To create an advanced filter:

  1. Select the Filters tab in the Explorer Tree.

    filters_tab.png
  2. Click Add filter to open the New filter window.

    new_filter_window.png
  3. Enter a name for the filter and define the project scope:

    • This project only — Queries data from the project you are viewing at the time. The filter appears only when using this project.

    • Current project — Queries data from the project you are viewing at the time but the filter is also available for other projects.

    • All projects — Pulls data from every project in the organization where you have permissions to view. Results include items from other projects that match the filter criteria.

  4. (Optional) Select Make public to share the filter with anyone who has access to the project.

  5. Define the Match option for a specific item type or All Item Types.

    When you select a specific item type, you can filter by its fields. Searching for All Item Types limits your criteria to Jama Connect core fields.

  6. Define your filter with available conditions, which depend on the selected item type.

    • Add rule creates a new rule. A filter can contain any number of rules. 

    • + adds a condition.

    • removes a condition.

    • Add condition group (blue button) creates a condition group, which depends on the selected item type.

      blue_button.png
    • When you filter by relationships, Add embedded filter opens the Add embedded filter window, where you can add a sub-filter and configure an embedded filter to limit the related items to a specific item type.

      embedded_filter.png

      For example, you can create a filter to identify change requests with downstream relationships and a configure an embedded filter to limit the related items to a specific item type.

      add_embedded_filter_window.png
      1. Enter a name for the embedded filter.

      2. From the Select a project drop-down menu, select All Projects or Current Project.

      3. In the Create rules section, add the conditions for the new embedded filter.

      4. Click Add embedded filter.

  7. In the New filter window that opens, define the following.

    • Limit to items updated within — Define a time frame when items were updated.

    • Sort order for results by — Define how results are sorted on output.

  8. Select Preview <number> Results... in the bottom left corner of the New filter window. Results appear in the same window.

    preview_filter_results.png

    Results example:

    results_example.png
  9. (Optional) To see the filter items in List View, click View in List.

  10. Click Save.

The new filter is now available in the list of bookmarked filters.

new_filter_abc.png