Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Version published after converting to the new editor

In this section:

...

  1. Option dynamic filters are used for fields that can take predefined values, such as check-boxes, select lists (single or multi select), status, priority, labels, user pickers, etc. Controller gadgets display these as buttons with drop-down menus, which allow selecting among the options available for each field. 
    When activated, dynamic filters limit the results to only those issues that match the selected options. If more than one option is selected, the filters will pass issues that have any of the selected values. (In JQL syntax, the selected options are ORed together, then the result is ANDed with the other JQL parts)

    Tip

    The options available are chosen only based on issues returned by the base Jira filter – it doesn’t show options that are defined by the field configurations but do not occur among your issues, increasing the relevance of the filter. For example, this is very useful if you add a dynamic filter for the Assignee field. The drop-down menu displays only users who have at least one issue assigned.

    Also, for each option dynamic filter, the controller displays a search-box so that the user can easily find the options he is looking for. The user can easily select/deselect the options one by one or a range of options using SHIFT + click. These mechanisms combined are particularly useful for fields with a large number of options.


  2. Text dynamic filters are used for string and text fields, such as the issue summary and description. Text filters don’t use a menu: instead, they just display a text box. The required JQL is automatically generated to filter only issues that contain the entered text.

    Jira has two different text searchers, one for exact string search and one for full-text search. Dynamic filters will use one or the other, depending on how your field is configured. Advanced search features such as prefix and wildcard queries are supported. See Jira’s documentation for the syntax.

    Tip

    Besides issue fields, there are two extra text dynamic filters that you can add in your rich filters: one is labeled Contains Text, and allows searching at the same time the summary, environment, description, the comments of an issue, as well as all custom text fields; the other is labeled Comments, and searches exactly what the name suggests.


  3. Number dynamic filters are used for number fields, such as Story Points or Business Value fields but also for searches based on the number of votes or watchers. These filters too display a text box where the user can type multiple values or ranges to use for the search. Several searching options are supported:

    1. Search by value: the user can insert one or several space-separated values to search for – e.g. “1 2 3” for issues having the values 1, 2, and 3;

    2. Search values greater or lower than a given value: the operators '<', '>', '<=', and '>=' are accepted – e.g. “>=1” for issues having the values greater or equal to 1;
    3. Search for intervals: the form “a:b” can be used to search values between a and b included – e.g. “1:10” for values between 1 and 10;
    4. Search for issues with the value empty or not empty: the user can type 'empty' to see the issues having the field empty or '!empty' for the issues with the field not empty.
    Several options can be used at the same time, they just need to be space-separated and the options are OR-ed – e.g. “1 2 <0 4:8” returns the values 1 or 2 or the values inferior to 0 or in the range 4–8. 
  4. Date dynamic filters are used for date/time fields, such as created, updated, resolution date and custom date fields. Date filters allow the user to filter only issues with date field values on, before, after or between two dates.
    Each dynamic filter has two date inputs – Since and Until:

    1. If Since is filled, then only issues having values on or after the inserted value are displayed;
    2. If Until is filled, then only issues having values on or before the inserted value are displayed;
    3. If both Since and Until are filled, then only issues having values between Since and Until (inclusive) are displayed.

    The inputs Since/Until can be picked from a calendar or entered manually as an absolute date (“yyyy/MM/dd” or “yyyy-MM-dd”) or time relative to the present (e.g. “5d”, “4w 2d”).
    Image Modified
    If you need to search for issues on a single date, enter that date in both Since and Until at the same time. In order to insert 'now' in Since/Until, one option is to use the value '0d'.

Tip
titleRich Filter Extensions

Rich filter extensions are separate Jira apps that can be installed on top of the Rich Filters for Jira Dashboards app to extend the rich filters and rich filter gadgets with new specific functionality.

New dynamic filter options are available if you add any of the these extensions:

Anchor
section3
section3
3. Adding & Editing Dynamic Filters

...