Orange Tracker
Page tree

Table of Contents

 

What are Gadgets

Gadgets can be added to dashboard pages to display information about projects and issues in Orange Tracker.  For more information about setting up dashboards, see Dashboards in Orange Tracker,

Gadgets can display information that has been filtered and sorted in many different ways. For example, there are gadgets to view:

  • recently changed issues in a project
  • open issues broken out by component or assignee
  • issues reported by you or assigned to you
  • the average number of days issues have been unresolved
  • the number of created vs. resolved issues in a project
  • results from a favorite filter

Gadgets can also display the information retrieved in different formats - they can display lists, graphs, or summaries of information.

Add a Gadget

  1. Open a dashboard page
  2. At the top right of the dashboard, click the Add Gadget link.
  3. A list of gadgets will be displayed.  You use the categories on the left (ex:  Charts) to narrow down the list of displayed gadgets, or you can retrieve a specific gadget by entering the gadget name in the search box.
    Gadget Directory screen showing available gadgets
  4. Click the "Add it Now" button on your chosen gadget to add it to your dashboard.
  5. Click the "X" button to return to your Dashboard.
  6. If the gadget you have selected requires configuration, you will be presented with the gadget's configuration page. Configure the gadget and click Save.

 

Popular Gadgets

The most popular gadgets that users add to their dashboards are:

Filter results

Shows the issues retrieved by a saved filter.  Do not use filters that retrieve large numbers of issues.  Broad searches place a load on the system, and you can only display a maximum of 50 of the issues retrieved in this gadget.

List from filter results gadget showing rows of issues with key, summary, and status

When you add the "Filter Results" gadget to the dashboard, you see the configuration screen. 

  • Saved Filter:  enter the name of the saved filter to use in the gadget.  The drop-down list will show filters in alphabetic order that you can view.  To retrieve a specific filter, enter the name of the filter into the search box.  The "Advanced Search" link lets you pick from your favorite filters or popular filters.  You can also search for a filter by owner, who it is shared with, or words in the filter name or description.
  • Number of Results:  enter the number of issues to display (maximum of 50)
  • Columns to display:  you can select what fields from the issue you wish to display. Each field is a column in the filter results.  To remove a column, select the trash can icon to the right of the field name.  To add a column, use the drop-down list to select from the list of available fields.  To re-order an column, hold your cursor down on the block of dots before the field name and drag the column field up or down in the list.
  • Auto Refresh Every 15 minutes:  Any time you open a dashboard page, the gadgets are automatically refreshed.  You can also refresh a gadget manually using the refresh button in the gadget's menu.  Generally, you do not need to refresh the gadget every 15 minutes (selecting auto refresh can impact system performance, so only select it if you keep a dashboard open all the time and need to have the gadget refreshed frequently.)

Select "Save" when you are finished configuring the gadget.

Activity Stream

Lists recent activity in one or more projects.

Activty Stream Gadget showing most recent changes.

 

You can change what recent activity is displayed by configuring the gadget.  The configuration screen will display automatically when you add the gadget, or you can select "Edit" from the gadget menu to bring up the configuration screen.

Activity Stream Configuration showing fields to modify its behavior

  • Name:  Enter the name for your gadget in the top box that has "Activity+Stream" by default
  • Filter: Select the "Add a global filter" link to filter the results of the activity stream.  You can select one or more projects, specific issue keys, an issue update range, and/or one or more user names.  Use the plus button to add more conditions to the filter (retrieved items must meet all the conditions) or the minus button to remove conditions.
    global filter showing plus and minus buttons to change the filter conditions
  • JIRA/Tempo:  You can normally ignore these.   Only select projects use JIRA and Tempo.
  • Limit:  you can enter the number of issues to display in the gadget display.
  • Automatically Refresh this activity stream:  Anytime you open a dashboard page, the gadgets are refreshed.  You can also select "Refresh" from the gadget menu to manually refresh the display.  Normally, you do not need to continually update the activity of the gadget unless you keep that dashboard page open all the time.

Select the "Save" button when done.

Assigned to me

Displays all unresolved issues assigned to you in all your projects.   If you want to list only issues assigned to you in one project, use the "Filter Results" gadget to define the issues to be retrieved.  Note that you cannot change the name of this gadget.

assigned to me display of issues

  • Number of Results:  enter the number of issues to display (maximum of 50)
  • Columns to display:  you can select what fields from the issue you wish to display. Each field is a column in the filter results.  To remove a column, select the trash can icon to the right of the field name.  To add a column, use the drop-down list to select from the list of available fields.  To re-order an column, hold your cursor down on the block of dots before the field name and drag the column field up or down in the list.
  • Auto Refresh Every 15 minutes:  Any time you open a dashboard page, it is automatically refreshed.  You can also refresh a gadget manually using the refresh button in the gadget's menu.  Generally, you do not need to refresh the gadget every 15 minutes (selecting auto refresh can impact system performance, so only select it if you keep a dashboard open all the time and need to have the gadget refreshed frequently.)

Pie chart

Displays the retrieved issues as a pie chart.

pie chart broken out by assignee

You can retrieve only issues in a specific project, or you can use a filter to determine what issues will be displayed in the pie chart.

Pie Chart screen

 

  • Project or Saved filter:  enter words from the project or filter name to bring up a specific project/filter.  You can also select "Advanced search" for a list of favorite filters, popular filters, or projects.  Advanced search also includes a search screen that lets you search for filters by name/description, owner, and/or who the filter was shared with.
  • Statistic Type:  determines how the issues are broken out.  Use the drop-down list to see a list of available fields in the project.  You can only group the issues by a single field.
  • Auto Refresh Every 15 minutes:  Any time you open a dashboard page, it is automatically refreshed.  You can also refresh a gadget manually using the refresh button in the gadget's menu.  Generally, you do not need to refresh the gadget every 15 minutes (selecting auto refresh can impact system performance, so only select it if you keep a dashboard open all the time and need to have the gadget refreshed frequently.)