Dashboard Widgets

About Dashboard Widgets

The content of a dashboard is displayed in various widgets on the Dashboard page. The number of widgets displayed on the page and their content depends on information defined by the user who last saved the dashboard.

Each dashboard widget has:

  • A read-only view, which is displayed to all users that are members of the appropriate module-level Security Groups.
  • The Edit Widget window, which can be accessed only by users that have Edit permissions to the Catalog folders that store a dashboard. In order for these users to make changes to the dashboard widget via the Edit Widget window, they must be members of the appropriate module-level Security Groups.

Throughout this documentation, we use the term dashboard widget or widget to refer to the read-only view of a widget.

Note: The RBI Risk Matrix widget, is specific to the baseline Mechanical Integrity dashboard, and dashboards that are used by Mechanical Integrity users when the Risk Based Inspection license is active. Because modifying this widget is not recommended, documentation for working with the Edit Widget window for this widget is not provided.

The following widget types are available:

About Query Widgets

A Query dashboard widget displays query results based on the values entered in the Enter Filter Parameters window. The following image shows an example of a Query widget.



Edit Widget Window

The Edit Widget window for a Query widget provides options that are used to configure the content displayed on a Query widget. The Edit Widget window contains the following items:

  • Name : Specifies the label for the widget. You can select to specify localized values for the widget label.
  • Path: Specifies the Catalog location of the query whose results are displayed on the widget. You can select to open the selected query in the Design workspace.
  • Wrap Text: Specifies how text is displayed in the query result grid. The Wrap Text option is selected by default. You can clear the selection to show text on a single line.

About Graph Widgets

A Graph dashboard widget displays a graphical representation of query results based on the values entered in the Enter Filter Parameters window. The following image shows an example of a Graph widget that has been configured for a dashboard.

Edit Widget Window

The Edit Widget window for a Graph widget provides options that are used to configure the content that is displayed on a Graph widget. The Edit Widget window contains the following fields:

  • Name: Specifies the label for the widget. You can select to specify localized values for the widget label.
  • Path: Specifies the Catalog location of the path for which the results are displayed on the widget. You can select and select a query from the Catalog. You can also select  to open the graph in the Graph Editor.

About KPI Widgets

A KPI dashboard widget displays Key Performance Indicators, as specified by the user. You can choose to display Key Performance Indicators either as a dial or as a bullet chart. The following image shows an example of a KPI dial widget that has been configured for a dashboard.

The following image shows an example of a KPI bullet chart widget configured for a dashboard.

Edit Widget Window

The Edit Widget window for a KPI widget provides options that are used to configure the content that is displayed on a KPI widget. The Edit Widget window contains the following fields:

  • Name: Specifies the label for the widget. You can select to specify localized values for the widget label.
  • All KPIs section: Displays the potential KPIs that could be displayed on the widget. You can select to search for a specific KPI.
  • Display KPIs section: Displays the KPIs selected to be displayed on the widget.
  • and : Moves selected KPIs between the All KPIs and Display KPIs section.

About Image Widgets

An Image dashboard widget displays a custom image, as specified by the user. The following image shows an example of an Image widget that has been configured for a dashboard.

Edit Widget Window

The Edit Widget window for an Image widget provides options that are used to configure the content that is displayed on an Image widget. The Edit Widget window contains the following fields:

  • Name: Specifies the label for the widget. You can select to specify localized values for the widget label.

  • URL: Displays the URL where the custom image is located. The types of image file supported depend on the type of web browser used with your particular instance of APM.

About Calendar Widgets

A Calendar dashboard widget displays a list of events based on a query for a specific time period. The following image shows an example of a Calendar widget that has been configured for a dashboard. At any point in time, the events displayed on the calendar widget are for a particular day.

Tip: To expand the widget into a larger view, select . To modify the display, you can select the Month, Week, or Day button.

Edit Widget Window

The Edit Widget window for a Calendar widget provides options that are used to configure the content that is displayed on a Calendar widget. The Edit Widget window contains the following fields:

  • Name: Specifies the label for the widget. You can select to specify localized values for the widget label.
  • Path: Specifies the Catalog location of the query whose results are displayed on the widget. You can select (open in new window) icon to open the selected query in the Design workspace.
  • Event Mappings section: Specifies how the columns in the specified query correspond to the values required by the Calendar widget. This section contains the following fields, each of which contain a list of the fields that are defined in the query: 
    • Title Column: The query column whose value will be displayed as the title of the calendar event. If the query column is defined as a hyperlink, then, in the Calendar widget, you can select the event to navigate to the defined location.
    • Start Date Column: The query column whose value will be displayed as the start date of the calendar event.
    • End Date Column: The query column whose value will be displayed as the end date and time of the calendar event. If there is no value for end date, then the event end time will be set to 15 minutes.
    • Category Column: The query column whose value will be displayed as the event category for the calendar event. You can use the values in this column to filter the calendar events on the Calendar page.
    • Category Color Column: The query column whose value will be displayed as the color for the calendar event. Each category has a predefined color. If no color is specified in the query, then the default colors will be displayed.

Refresh a Widget

Procedure

  1. Access the dashboard that contains the widget you want to refresh.
  2. In the upper-right corner of the widget, select .
    The widget is updated to reflect the most recent data.

Access the Widget Source

About This Task

The source of a widget depends on the widget type. For example, if you access the source of a graph widget, the graph will open in the Graph Result workspace. The source of a widget can be accessed for Query widgets, Graph widgets, and KPI widgets.

Procedure

  • To access the source of a KPI widget:
    1. Access the dashboard that contains the widget whose source you want to view.
    2. In the upper-right corner of the widget, select .

OR

  • To access the source of a Query or Graph widget:
    1. Access the dashboard configuration options.
    2. In the widget you want to modify, select , and then select Edit.
      The Edit Widget window appears.
    3. Select .
      The contents of the widget open in a new tab displaying the corresponding workspace.

Modify a Widget

Procedure

  1. Access the dashboard configuration options.
  2. In the widget you want to modify, select, and then select Edit.

    The Edit Widget window appears.

  3. As needed, modify the properties of the widget, and then select Save.

    The modified widget is saved.

Hide a Widget

Procedure

  1. Access the dashboard configuration options.
  2. In the widget that you want to hide, select , and then select Hide.
    A message appears, asking you to confirm your selection to hide the widget.
  3. Select OK.
    The widget is hidden from the dashboard.

Access a Widget in a New Tab

Procedure

  1. Access the Dashboard containing the widget that you would like to access in a new tab.
  2. On the dashboard widget, select .
    Note: The selected filter parameter values are applied when you access a query or graph in a new tab.

    The selected widget appears in a new tab.

Remove a Widget

Procedure

  1. Access the dashboard configuration options.
  2. In the widget that you want to remove, select , and then select Remove.
    A message appears, asking you to confirm your selection to remove the widget.
  3. Select OK.
    The widget is removed from the dashboard.