User Help > Viewing Project Data in Dashboards > Running a Dashboard
  
Running a Dashboard
CLI EQUIVALENT 
im rundashboard
Dashboards can be run in the GUI or Web interface.
Key Considerations
• If the dashboard includes a component for an underlying object that is invisible to you, the component displays in the dashboard. If the underlying object for a dashboard component is removed from the system, the dashboard displays an error in place of the component.
• Charts using the table graph style are not sized according to the height and width properties specified in the dashboard definition.
• Displayed date fields do not change based on the time zone a user operates in; however, displayed date/time fields and time entries vary based on the time zone a user operates in.
The following table describes how to run a dashboard:
Interface
Procedure
GUI
Do one of the following:
• Select File > Run > Dashboard, and then specify a selection.
• From Manage Dashboards view, select a dashboard, and then Dashboard > Run or File > Run > Selected.
Web interface
From DashboardsView, select a dashboard, and then Run Dashboard.
While a dashboard is running, you can perform the following activities in the dashboard:
Dashboard Activity
Description
Apply a Project Filter to the Dashboard
The projects that display when you run the dashboard are based on the project filters defined for the dashboard.
Depending on how you design your dashboard, the dashboard project filter may or may not be applied to the dashboard components. If the dashboard project filter is not applied to the dashboard components, Project Filter is disabled in the Dashboard view.
You can change the project selection (except when the dashboard is defined with a fixed project filter or no project filter). If you want to filter further within the projects in the Project Filter, select one or more of the displayed projects.
If the dashboard project filter is applied to a report, report link, or query link component, the dashboard project filter is applied in addition to any filter defined for the component. If the dashboard project filter is applied to a chart component, the dashboard project filter overrides any project filter defined for the chart.
To use the project filter, you must be familiar with using the data filter.
* 
When running a dashboard in the GUI, you can toggle the display of the project filter panel by clicking the arrows beside Project Filter.
Refresh the Dashboard
When you refresh a dashboard, the contents of any embedded charts or reports are updated. To refresh the contents of a dashboard in the GUI, click View > Refresh. To refresh the contents of the chart in the Web interface, click Refresh View.
Click a Query Link
Clicking a query link in a dashboard opens the Items view and displays items based on the query filter. Depending on how you designed your dashboard, any current dashboard project filter may also be applied to the query results. In the GUI, the view displays in a separate window; in the Web, the view replaces the dashboard.
You cannot change the project filter while viewing items for a query link. If you have set up a project filter preference for the Items view, it is disregarded until you run another query.
Click Chart Values
Clicking a value in a distribution chart in a dashboard opens the Items view and displays items that make up the chart value. In the GUI, the view displays in a separate window; in the Web, the view replaces the dashboard.
For item fields charts and item fields trend charts, if you want to view a single item that makes up a particular chart value, click the chart value (either an area of a bar, pie, or trend style chart, or a cell in a table style chart). In the GUI, the ItemDetail view displays detailed information about the item that makes up that portion of the chart’s data set. In the Web, the view replaces the dashboard.
You cannot change the project filter while viewing items for a chart segment. If you have set up a project filter preference for the Items view, it is disregarded until you run another query.
Click Report Link
Clicking a report link in a dashboard opens a separate browser window containing the results of the report. Depending on how you designed your dashboard layout, any current dashboard project filter may also be applied to the report results.
Click URL Link
Clicking a URL link in a dashboard opens a separate browser window targeted at the URL as specified in the dashboard definition.
Resize Charts
In the GUI, you can resize a bar or pie chart in the dashboard by right-clicking and selecting Zoom In or Zoom Out. For bar charts, you also need to select the axis to resize. The axes you can select depend on the graph style of the chart. Select Auto Range to restore the chart to its original size.
In the Web interface, you can zoom out on a bar chart’s axes by clicking Zoom Out and zoom in by clicking Zoom In. For pie charts, these options are disabled.
To increase the size of the chart in the Web interface, click Increase Size, and to decrease the size of the chart, click Decrease Size.
Sort Tables
You can sort a table chart in the dashboard by column or row. Click a column to sort the rows in ascending or descending order for the values in that column; click a row to sort the columns in ascending or descending order for the values in that row.