Dashboards

Overview

In Cisco Unified Intelligence Center, Dashboard is an interface that allows you to add reports, web pages (URLs), web widgets, and notes in a consolidated view.

All actions on the Dashboards interface are based on your role and on the user permissions for Dashboards and for Folders.

Access Dashboards

From the left navigation pane, click Dashboards to access the list of all the available Dashboards. This list includes the dashboards that you have created and the dashboards created by other users on which you have EXECUTE permissions.


Note

  • You must be assigned with the Dashboard Designer role to create Dashboards.

  • To view Dashboards created by other users, you must have EXECUTE permissions for the dashboard and its parent folder.

  • Cisco Unified Intelligence Center does not provide a default Dashboard.

Run Dashboards

To run a Dashboard, click the Dashboard name. When the Dashboard is in the run mode, use the toolbar to:

  • Edit the Dashboard.

  • Refresh the Dashboard data.

  • Maximize the Dashboard view.

    Press Esc to restore the original view.

Before You Upgrade

Cisco Unified Intelligence Center 11.6 supports a maximum of ten widgets per Dashboard. Hence, for Dashboards with more than ten widgets in versions before 11.6, ensure to split those Dashboards with a maximum of ten widgets each before upgrade.

Consider a Dashboard with 15 widgets in Unified Intelligence Center versions before 11.6. Before upgrading to version 11.6, use the Save As feature to clone the Dashboard and manage the widgets up to ten per Dashboard.

Unsupported Widgets

The Cisco Unified Intelligence Center 11.6 interface for Dashboards does not support the following widgets:

  • Schedule Report widgets

  • URL widgets containing Dashboard permalinks (Nested Dashboards)

Migration Limitations

The following widgets if added to the Dashboard before Cisco Unified Intelligence Center 11.6 are not migrated.

  • Schedule Report widgets.

  • URL widgets containing Dashboard permalinks (Nested Dashboards).

  • Widgets that were placed beyond the new Dashboard canvas size.


    Note

    Post upgrade to Cisco Unified Intelligence Center 11.6, the positions of the widgets placed in the legacy dashboard interface are retained. However, in few cases the position and size of the widgets are modified to fit inside the new dashboard interface.

  • Inaccurate widgets (inaccurate database records)

    Example: Report widgets with missing Report Views.


Note

For the Schedule Report widgets and Nested Dashboard widgets that are not migrated, the Cisco Unified Intelligence Center server logs do not capture the logs.

For all other widgets, Cisco Unified Intelligence Center server logs captures the log information with the corresponding Dashboard and widget name.

Dashboard Actions

The following table lists various actions that you can perform from the Dashboard.

Table 1. Dashboard Actions

Action

Description

Dashboard-level actions
New
Dashboard Creates a new Dashboard.

The New Dashboard wizard allows you to:

  • Provide Dashboard properties; Name and Description.

  • Add widgets to the Dashboard.

For more information, see Add Widgets to Dashboard.

Folder Creates a new Folder. Use this feature to categorize Dashboards.
Note 

When you move or save the folders to a different location, the drop-down lists all the folders. You can only navigate into the folders on which you have the WRITE permission.

Toolbar actions

Refresh

Refreshes the Dashboards page.
Favorites

To easily access your Dashboards, you can tag Dashboards as Favorites.

Click the star icon beside the Dashboard name to add to Favorites.
Search

Searches for a particular Dashboard.

Ellipsis (…) actions
Edit Edits the Dashboard details. In the edit mode, you can:

  • Add, remove, and modify widgets.

  • Click the icon next to the Dashboard name to edit the Dashboard properties; name and description.

After editing the Dashboard, click Save.

Save As

Saves a copy of the Dashboard.

Rename

Renames a Dashboard or a Folder.

Move

Moves Dashboard or Folder from one folder to another.

Delete

Deletes a Dashboard or a Folder.

Share

Share—Grants View and Edit permissions for the Dashboard within your group.

Permalinks

Displays the Dashboard permalink.

Note 

You can access permanent hyperlink only from a web browser. You cannot access it from an application such as Microsoft Excel to pull data or display a Dashboard.

For more information, see Permalink for a Dashboard.

Add Widgets to Dashboard

You can add Reports, Web pages, Notes, and Custom Widgets to a Dashboard. In addition, you can resize and reposition the widgets to suit your needs. The default widget size depends on the available space on the Dashboard canvas.


Note

You can add a maximum of ten widgets per Dashboard.

To add widgets to the Dashboard, perform the following steps:

Procedure

Step 1

From the left navigation pane, click Dashboards.

Step 2

In the Dashboards tab,

  • To add widgets to a new Dashboard, click New > Dashboard.

  • To add widgets to an existing Dashboard, click the ellipsis icon beside the required Dashboard and click Edit.

Step 3

On the Dashboard canvas, click on the plus icon.
Step 4

In the Add Widgets dialog box, add the required widgets:

Widget Type

Steps

Report View

 Displays an existing report on the Dashboard.

  1. Click the Report View icon.

  2. In the Add Report View dialog box, select the Report and the Views from the corresponding drop-down list.

  3. Click Done.

Note 

  • For a Report widget, you can click the icons on the widget header to view the existing filter information, manage filters, and play or pause the report execution.

  • The Manage filters and the View filter information icons appear only when you hover on the report widget.

  • For Grid view reports, you can increase or decrease the font size of the report data.

    The default font size is set to 10. Post upgrade to Cisco Unified Intelligence Center 11.6, this setting overrides the font size set during the grid view creation.

  • In the edit mode, from the Report widget header, use the ellipsis icon to access Filter and modify the filter criteria.

Note

 Adds notes to the Dashboard.

  1. Click the Note icon.

  2. In the Add a Note dialog box, enter Note Title and Note Body.

  3. Click Done.

Web page

 Displays a web page on the Dashboard.

  1. Click the Web page icon.

  2. In the Add a Web page dialog box, enter Web URL, the address of the web page that you want to display on the Dashboard.

  3. Click Done.

    Limitations for web page widget:

    • The websites enabled with "X-Frame-Options", will not be displayed on the Dashboard.

    • The web URLs provided without prefixing a protocol (HTTP or HTTPS) will by default use the protocol of the Cisco Unified Intelligence Center application.

    • When Cisco Unified Intelligence Center is in HTTPS mode, you cannot configure HTTP based widget URLs in Dashboard.

    • You cannot add Dashboard permalink as web page widget.

For information on viewing report permalinks in Dashboards as web page widgets, see View Report Permalinks in Dashboards.

Custom Widget

 Adds custom widgets to the Dashboard.

  1. Click the Custom Widget icon.

  2. In the Add Custom Widget dialog box, enter Widget Title and Code Snippet.

    Note 

    In the Code Snippet box, you can enter any markup/code snippet of the widget that you want to show on the Dashboard. For example, HTML, XML RSS feed, JavaScript, and so on.

    Maximum Limit: 1000 characters.

  3. Click Done. The embedded code appears on the Dashboard.

Step 5

Click Save.

Run a Report from the Dashboard

Running a report from the Dashboard depends on the Don't show filter while executing a report check box selection in Reports > Manage Filters:

  • If this check box is checked for a report, the system bypasses the filter and runs that report using the default filter.

  • If this check box is unchecked for a report, for the first access, the system prompts you to choose a Filter to run that report.


    Note

    • The Filter prompt displays the corresponding icon to denote the type of report view, such as, Grid, Chart, Pie, and so on.

    • In both these scenarios, from the ellipsis icon on the Report widget header you can access Filter to edit the filter criteria.

    Click the Filter button to display the filter criteria in the Filter Data dialog box based on the following validations:

    • Displays the filter criteria screens based on the selected report query type.

    • Populates with the default filter criteria if the default filter is set for that report.

Edit Filter Data

You can edit the report filter data from the Dashboard in the following two ways:

  • Run mode—Click the filter icon on the report widget header.

  • Edit mode—Click the ellipsis icon and select Filter from the available menu options.

Modify the required filter criteria and click Run. The report refreshes reflecting the modified filter criteria.


Note

When you edit the report filter for a Dashboard during Create, Edit, or Run mode, the filter settings are stored in the browser cache and is specific to the individual user. Hence, the next time you sign in and run the Dashboard, the report widget uses the filter information stored in the browser cache and generates the report (without prompting you to update the filter criteria). The browser cache is retained up to 30 days.

Every time you run the report, the filter data in the browser cache is validated for permissions. If there is a permission mismatch, an error message appears that the filter you selected before is no longer valid and select the filters again.

Also, if any other user sign-in to the same browser, that user cannot view your filter settings.

The filter settings stored in your browser cache are cleared only:

  • If you have not used the Dashboard for the last 30 days.

  • If you manually clear the cache.

For more information on Report Filters, see Report Filters.