This chapter describes how to create dashboards that display business metrics. It contains the following topics:
For information on defining business metrics, see Developing Productions.
Introduction to Dashboards
A dashboard displays business metrics or other data (such as Analytics pivot tables). InterSystems dashboards are web-based. You can display them with the Dashboard Viewer (which is a web page).
The left area of a user dashboard displays items such as the following:
Alerts (messages from other users of the User Portal). These are unrelated to InterSystems IRIS® Interoperability alerts.
List of recently accessed dashboards.
List of dashboards marked as favorites.
Using Dashboards and the User Portal explains how to use this user interface and how to work with dashboards.
If you click the link for a dashboard in the User Portal, the Dashboard Viewer then displays the dashboard. The following shows a simple example:
You create dashboards in the User Portal. If you want users to have access to the User Portal but not have the ability to create their own dashboards, see the chapter “Setting Up Security” in Implementing InterSystems Business Intelligence.
You can instead embed individual dashboards in web pages. In this case, the users would not need the User Portal. For information, see “Accessing Dashboards from Your Application” in Implementing InterSystems Business Intelligence.
The following is an example procedure of how to create a simple dashboard. Note that not all options you see are described in these steps. (See Creating Dashboards for full details.)
In a namespace that is enabled for analytics (select Analytics on the namespace's web application), select Analytics > User Portal, and then select Go.
From the User Portal, click New Dashboard on the Menu.
The system displays a dialog box that prompts you for basic information about the new dashboard.
For Dashboard Name, type the name of the dashboard.
Optionally provide values for the following options:
Folder — Specifies the folder, if any, to which the dashboard belongs. You can either type a folder name or select an existing folder. Use the slash character (/) to specify a subfolder. For example, you can enter the following for Folder:
My Folder/My SubfolderCopy code to clipboard
Folders organize the dashboards as seen in the User Portal.
Dashboard Title — Specifies the title of the dashboard.
If you specify a title, the main area of the User Portal displays the title of the dashboard. Otherwise, it displays the name of the dashboard.
Public — Specifies whether this dashboard is displayed in the User Portal main area.
(Even if the dashboard is not marked as public, you can access it via Main > Open. Also, you can find it in the User Portal by using the Find option. See Using Dashboards and the User Portal.)
Locked — Enables you to temporarily prevent changes to this dashboard. If you select this option, you cannot edit the dashboard again unless you first clear the Locked option again.
Dashboard Owner — Optionally specifies the InterSystems IRIS user who owns this dashboard. If a dashboard has an owner, then only the owner can specify the Access Resource value for the dashboard; see the next item.
Access Resource — Optionally specifies the InterSystems IRIS resource that is used to control access to this dashboard. See the Implementing InterSystems Business Intelligence.
Keywords — Lists any keywords or phrases to help you find this dashboard later. Enter one keyword or phrase per line; that is, each line you enter here is treated as a single keyword.
These keywords are displayed in the User Portal.
The system creates, saves, and displays the dashboard, which is initially empty.
Click Add New Widget on the Menu and then click Bar Chart on the left from the list of Pivots and Charts.
Click the magnifying glass to the right of the Data source.
Click Business Metrics on the left of the Finder Dialog.
Click Demo.Dashboard.Production and then SalesMetrics to choose this metric as the data source. Click OK to add this widget to the dashboard. You now see this widget in the dashboard work space. Resize the widget graphic out so you can see what it contains.
Click Save on the Menu to save the dashboard.
Click Home to see the list of dashboards and then click the dashboard name you just added to view it.
Click the clipboard icon at top left of the bar chart, to edit the appearance of the widget you added using the Widget Designer.
Click the Data Properties tab.
Click the plus sign icon at right, click Sales in the Data Value list, and click OK.
Click the plus sign icon again, click Units in the Data Value list, and click OK.
Click Save on the Menu.
Refresh the browser to see the display change as the production runs.
Location of Dashboard Definitions
When you create a dashboard, its definition is visible in the Studio Workspace window, within the Other folder. You can export and import this definition as you do with other items in Studio.
A dashboard definition is not a class definition but can be copied and pasted into a special container class if needed; this container class can contain multiple dashboards and other items. For details, see “Packaging Analytics Elements into Classes” in Implementing InterSystems Business Intelligence.
For More Information
InterSystems dashboards are documented more fully within the Analytics documentation. See the following books: