Versions Compared

Key

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

...

  1. Add a Rich Filter Statistics gadget to your dashboard (Create a simple dashboard explains how to add gadgets), and position it underneath your controller.
  2. Set your new gadget's Rich filter field to the same rich filter that your controller is based on.
  3. In the Statistic type dropdown, choose Created. Since this is a date field, you are given the following options to configure.

    The date config fields displayed when you choose a datetime-based field for the breakdown type. These allow you to specify aggregation period type, number, direction, and sort order, and whether to display percentage bars and totals

  4. Let's explore each option in turn:
    1. Aggregation periods: This allows you to choose whether you want to show value totals per day, week, month, quarter, or year. There is also a special value, Auto, which leaves it up to the rich filters app to choose the most suitable Aggregation periods and Time range values to show a granular-but-complete statistic set for your data.
    2. Time range: This allows you to set the time range over which you want to show your aggregation periods. The options are as follows:
      1. Number of <aggregation-period>: Choose a set number of aggregation periods to display, for example the option will be Number of days if your chosen Aggregation period is Days. When this option is selected two additional fields appear, which also need to be configured:
        • Number: The number of aggregation periods you want to display. You can choose to display up to 100 periods at once.
        • Direction: Whether you want to show aggregation periods in the past (from the present date backward), future (from the present date forward), or past and future (backward and forward, with the present date in the middle).
      2. Between dates: Choose a specific start and end date for the time range you wish to display. When this option is selected two additional fields appear, which also need to be configured:
        • From: The start date.
        • To: The end date.
      3. All dates: Dynamically display aggregation periods of the chosen type that span a time range covering all the existing values in the date/datetime field used as the breakdown (i.e. the Statistic type; Created in this example). This is particularly powerful when combined with a dynamic filter based on the same date field in the controller; it allows you to change the displayed time range dynamically.
      4. This <aggregation-period> and Last <aggregation-period>: For convenience, you can also choose to display data over contextual predefined time ranges. For example, when Months is chosen as the Aggregation period, the options provided in the Time range dropdown are This quarter, This year, Last quarter, and Last year.
    3. Reverse sort order: This checkbox controls whether you want to display the data going forwards with the oldest date at the start (unchecked, the default), or going backwards with the newest date at the start (checked).
    4. Show percentage bars: This checkbox controls whether percentage bars are shown in the resulting statistics gadget, alongside the values for each aggregation period.
    5. Show totals: This checkbox controls whether a Total row is shown at the bottom of the statistics table.
  5. For now, choose an Aggregation periods value of Weeks and a Time range of Number of weeks. Choose a Number of 6 and a Direction of Past. This will cause the statistics gadget to display the last 6 weeks of data.
  6. Check the Reverse sort order checkbox — this results in the data being shown in reverse chronological order, with the most recent week in the top row.
  7. In the Values section, choose Issue Count and Story Points from the Pick a value... dropdown.
    The configuration of your gadget should look like this:
    Image Modified
  8. Click Submit. Your gadget should look like this:
    Rich filter statistics gadget showing created issue count and story points values for each week over a period of six weeks

...