9 Creating Dashboards

This chapter describes how to create dashboards in Oracle Business Activity Monitoring (Oracle BAM).

This chapter includes the following sections:

9.1 Understanding Dashboards

A business view or view is a visual representation of data fetched by a business query or one or more key performance indicators (KPIs). A dashboard is a collection of related business views.

A dashboard can also have external content using a URL or can contain an image in a dashboard cell. To display data to users, a view must be included in a dashboard. Dashboards can display point-in-time or real-time information (active data).

Users can view dashboards, and alerts can send users links to dashboards based on conditions changing in the queries and KPIs on which the business views within them are based.

When designing dashboards, you can choose from a variety of style templates based on how many views you need and how much horizontal and vertical space each view requires. Each view occupies a rectangular space, called a cell, in the dashboard. You can add, resize, clear the contents of, and delete cells.

A tabbed dashboard contains other complete dashboards, which you view by clicking the tabs.

A spingboard is a dashboard that uses images from various dashboard cells to launch other dashboards. See Creating a Springboard for more information.

9.2 Dashboard Prerequisites and Uses

Dashboard prerequisites are a set of tasks you must complete before you create a dashboard, to ensure its smooth functioning.

Before you can create a dashboard, you must do the following:

  • Add to your project the data objects containing the data the dashboard will display. For more information about projects, see Planning and Creating Projects. For more information about data objects, see Working with Data Objects.

  • If the dashboard will include a KPI Watchlist type view, create one or more KPIs on which to base the view. For more information about KPIs, see Creating KPIs.

  • If the dashboard will include prompts for users to choose values, create parameters for query filters. For more information about parameters, see Creating Parameters.

You can use a bottom-up approach and create business queries and views before creating a dashboard. Or you can use a top-down approach and create a dashboard before creating the views and queries within it. See Choosing Bottom-Up or Top-Down Project Building Steps, Creating Business Queries, and Creating and Using Business Views for more information.

Note:

You cannot create KPI Watchlist, Tree Map, or Geo Map views from within a dashboard. First create these views using the navigator pane, then you can add them to dashboards.

After you create dashboards, you can use them in the following ways:

In a view action

One type of view action opens a dashboard. See Using Actions in Business Views for more information.

As a view drill-across target

One type of view drill-across target is a dashboard. See Configuring Drill-Across Targets for more information.

In an alert action

Some alert actions send users links to dashboards. See Creating Alerts for more information.

In another dashboard

You can link to one dashboard from another. See Adding Other Content to Cells for more information. A tabbed dashboard contains other complete dashboards. See Creating a Tabbed Dashboard for more information.

In an email, browser, or web page

You can copy the dashboard link and use it as you would any other URL to provide single-click access to the dashboard. See Displaying a Dashboard URL for more information.

9.3 Creating a Dashboard and Adding Views

This section outlines the procedure to create a dashboard and add views in it.

To create a dashboard and add views:

  1. Go to the Designer page.

  2. Click Dashboards in the left panel navigator, or right-click Dashboards and select the Create menu item.

    The Dashboards dialog opens.

  3. Type a Name, optionally edit the Display Name, and optionally add a Description.

    The Name is case sensitive, must begin with a letter, and may consist only of letters, numbers, and the underscore character. It may have up to 128 characters. It cannot be changed after the dashboard is created.

    The Display Name is case sensitive and may contain any characters except the forward slash (/), which indicates a folder path. It may have up to 128 characters. It can be changed at any time.

  4. Select Dashboard as the dashboard type.

    To create a Tabbed Dashboard, see Creating a Tabbed Dashboard.

  5. Select a thumbnail representing the desired style template.

    You can add, resize, clear the contents of, or delete cells later if needed. See Formatting Dashboard Cells for more information.

  6. Click Create.

    A tab opens for the new dashboard, with a default arrangement of cells corresponding to the selected style template.

  7. To create and add a new view:

    Note:

    You cannot create KPI Watchlist, Treemap, or Geo Map views from within a dashboard. First create these views using the navigator pane, then you can add them to dashboards.

    1. Drag and drop a view category icon from the Views palette to one of the cells.

      The Create View dialog opens.

      For an alternative to dragging and dropping, see Adding Other Content to Cells.

      See Creating and Using Business Views for more information about view icons, categories, and types.

    2. Type a Name and a Display Name.

      The Name is case sensitive, must begin with a letter, and may consist only of letters, numbers, and the underscore character. It may have up to 128 characters. It cannot be changed after the view is created.

      The Display Name is case sensitive and may contain any characters except the forward slash (/), which indicates a folder path. It may have up to 128 characters. It can be changed at any time.

    3. Select a thumbnail representing the desired view type.

    4. Click Create.

      The new view opens in the cell, with a visual preview using generic data.

    5. Click the Open Query Editor icon in the top right corner of the cell that contains the view.

      The Business Query Editor opens.

    6. Select a query from the Query drop-down list or create a query by clicking the Create New Query icon.

      See Creating Business Queries for more information about creating and editing queries.

      Note:

      BAM supports date-only data filter using existing date-time parameters. During query filter configuration do not configure the same parameter for date-only and date-time for a Dashboard.
      As a designer, you should regard the following configurations in query filter area:
      • Do not select an existing date-time parameter for data-only compare mode parameter in query filter popup.

      • Always create two sets of BAM parameters, such as one for date-time, another one for date-only comparison.

      • Do not select the following comparison operators, when the parameter default value is NULL:

        • less than

        • greater than

        • less than equal to

        • greater than equal to

      • In the above cases, the Dashboard may display wrong data during runtime.
    7. Click Apply, then click Close.

      The preview changes to reflect the data fields fetched by the query.

    8. To edit view properties or runtime interactions, click the Business View Actions icon in the top right corner of the cell that contains the view.

      See Creating and Using Business Views for more information about view properties and runtime interactions.

  8. To add an existing view from the current project, drag and drop a view from the Project Views palette or the left navigation pane to one of the cells.

    The view opens in the cell, with a visual preview using data fields fetched by the query on which the view is based.

    Click the Refresh Views List icon to update the Project Views palette.

    For an alternative to dragging and dropping, see Adding Other Content to Cells.

  9. If the queries on which the views are based reference parameters, you can coordinate the parameters in the dashboard. Click the Parameter Mapping Editor icon in the top right corner of the dashboard.

    See Driving Parameters from Other Views for more information.

  10. To add items other than views to dashboard cells, see Adding Other Content to Cells.

  11. To format the cells, see Formatting Dashboard Cells.

  12. To format the title and background of the dashboard, see Formatting the Dashboard.

  13. Click Save.

    Note:

    If you do not save the dashboard, any views and queries you create from the dashboard are not saved and do not appear in the left navigation pane.

9.4 Creating a Springboard

This section describes how you can create a springboard.

To create a springboard:
  1. Create a Dashboard. See Creating a Dashboard and Adding Views for the detailed procedure.
  2. Click the + icon.
  3. In the dialog box that appears, click Create Springboard View.
  4. Upload an image from a file. Click the Stretched radio button to stretch the image to fit within the borders. Click the Fixed radio button to retain the original size of the image.
  5. Choose an Image Caption. Click the Top or Bottom radio buttons to select the placement of the caption.
  6. Click the Link with Dashboard drop-down list to select a Dashboard with which you might want to link this Springboard with.
  7. Optionally, click the Replace the same view check box to replace the springboard view with the dashboard selected.

    Note:

    Oracle Business Activity Monitoring ships with a collection of pre-assembled dashboards that aid with the monitoring of some common business processes. See Process Analytics Springboard for more information.

9.4.1 Process Analytics Springboard

The Process Analytics Springboard is a collection of dashboards within the process analytics project.

The Process Analytics Springboard is a collection of pre-assembled dashboards that aid the monitoring of some common business processes. This springboard consists of the following dashboards:
  • Process Health Dashboard

  • Open Process Summary Dashboard

  • Workload Analysis Dashboard

  • Cycle Time Dashboard

  • Closed Process Analytics Dashboard

Process Health Dashboard

The Process Health Dashboard helps you identify processes that need attention and fixing. Each Application or Process shows the number of active processes in relation to process instances that have recoverable errors or are suspended.

  • In Progress process instances include the total number of processes that are "open", "due soon" and "overdue" but otherwise functioning normally

  • Recoverable process instances are instances that may have experienced errors but can be recovered by taking suitable action.

  • Suspended process instances are instances that have been paused for some reason other than an explicit error or fault.

9.4.1.1 Configuring a Process Health Dashboard

This task describes how you can configure a Process Health Dashboard

To configure a Process Health Dashboard:
  1. Click the split pane on the right side of the panel, if it is not already expanded.
  2. By default, the process is ordered by the total number of instances from right to left, so as you progress down the page, each process would have fewer instances.
  3. Under the Parameters panel, there are all processes listed with check boxes next to them. By default, all processes are selected.
  4. You can uncheck the processes you don’t want to view by clicking the check box
  5. You can search for a process by clicking in the Search String field.
  6. Once you make the necessary selections, click Apply.
  7. The bar chart displays the number of instances on the X axis and the process names on the Y axis. Each bar is a color-coded split among Active, Recoverable, and Suspended instances.

    Note:

    There is no drill down from this dashboard.

9.4.1.2 Open Process Summary Dashboard

The Open Process Summary dashboard is a single top-level table view of the total instances that are currently open for all processes that you have access to.

This dashboard provides counts of instances requiring admin action in tabs above the table view. The tabs from left to right are: Total Open, On Track, DUE this week, OVERDUE, OPENED today, and CLOSED today.

9.4.1.3 Configuring the Open Process Summary Dashboard

This topic describes how you can configure an Open Process Summary Dashboard

To configure the Open Process Summary Dashboard:
  1. Click the split pane on the right side of the panel, if it is not already expanded
  2. By default, the table is sorted alphabetically using the first column – Application. You can change the sorting by clicking the Up or Down Sort buttons next to each column name, namely: Application, Process, On Track, Due this Week, Overdue, Recoverable, Suspended, Opened Today, and Closed Today.
  3. Under the Parameters panel, there are all processes listed with check boxes next to them. By default, all processes are selected.
  4. You can uncheck the processes you don’t want to view by clicking the check box.
  5. You can search for a process by clicking in the Search String field.
  6. Once you make the necessary selections, click Apply.
9.4.1.4 Workload Analysis Dashboard

The Workload Analysis Dashboard combines the Process Activity Dashboard and the Open Process Bottleneck dashboard.

Using this dashboard, you can:
  • Determine the underlying resource creating a bottleneck.

  • Determine if there is an external system not responding in time.

Using the Workload Analysis Dashboard

You can toggle Top 10 and Bottleneck views using the tabs available at the top left of the dashboard view. The Top 10 view lists processes By Task and By Assignee. The Bottleneck view is a Treemap view that you can sort By Process, By Task, and By Assignee.

Top 10 View — View by Task

Each chart shows the top ten tasks ordered as follows:

  • ON TRACK is ordered from the most to the least Open/On Track task items (green section) for an activity.

  • DUE THIS WEEK is ordered by the most to the least Due This Week task items (yellow section) for an activity.

  • OVERDUE is ordered by the most to the least Overdue task items (red section) for an activity.

Top 10 View — View by Assignee

Each chart shows the top ten tasks ordered as follows:

  • ON TRACK is ordered from the most to the least Open/On Track task items (green section) for a particular user.

  • DUE THIS WEEK is ordered by the most to the least Due This Week task items (yellow section) for a particular user.

  • OVERDUE is ordered by the most to the least Overdue task items (red section) for a particular user.

Bottleneck View

This dashboard contains treemap views that show all processes and allows zooming in to a particular process to see user loads.

9.4.1.5 Cycle Time Dashboard

This dashboard shows the cycle time for processes and long running activities or tasks for processes that you have access to.

The cycle time shows the trend in number of days to complete a process, instance, or task.

You can either ‘View by Process’ or ‘View by Task’. The ‘By Process’ tab contains the Process Cycle Time and Process Workload line charts. The By Task tab shows the Task Cycle Time and Task Workload line charts.

View By Process

Both the Process Cycle Time and Process Workload charts show the number of days on the Y-axis and the months from January to December on the X-axis.

All processes are color-coded and you can zoom in to a particular process to see the Inflow and Outflow with the number of opened vs. closed instances alongside the process averages for opened and closed.

View by Task

The Task Cycle Time line chart shows the amount of time taken per task.

The Task Workload line chart shows the number of tasks opened and closed, with the number of tasks on the Y-axis and the time on the X-axis.

9.4.1.6 Configuring the Cycle Time Dashboard

This topic describes how you can configure the Cycle Time dashboard.

To configure the Cycle Task dashboard:
  1. Click the split pane on the right side of the panel, if it is not already expanded.
  2. In the Date Range (days before today) box, enter a date range. The default value is 30.
  3. Under the Parameters panel, there are all processes listed with check boxes next to them. By default, all processes are selected. Uncheck the processes you don’t want to view by clicking the check box.
  4. In the Show Top N box, enter a value for the maximum number of results you want to view for the top processes. The default value is 10.
9.4.1.7 Closed Process Analytics Dashboard

The Closed Process Analytics Dashboard is a table view of closed processes that you have access to.

It enables you to view metrics within a historical context and compare data within two intervals (this month vs. the same month last year, or this month vs. the average over the last 12 months).

There are three tabs: Today, This Week, and This Month. By default, the Today tab is open.

The dashboard has Count Boxes on top, within all three tabs. These are, from left to right: Total Closed This Month, Completed This Month, Aborted This Month, and Errored This Month.

9.4.1.8 Configuring the Closed Process Analytics Dashboard

This topic describes how you can configure a Closed Process Analytics dashboard.

To configure a Closed Process Analytics dashboard:
  1. Click the split pane on the right side of the panel, if it is not already expanded.
  2. Under the Parameters panel, there are all processes listed with check boxes next to them. By default, all processes are selected. Uncheck the processes you don’t want to view by clicking the check box.
  3. Click Apply.
9.4.1.9 Configuring the Workload Analysis Dashboard

This topic describes how you can configure the Workload Analysis Dashboard.

To configure the Workload Analysis Dashboard:
  1. Click the split pane on the right side of the panel, if it is not already expanded.
  2. Under the Parameters panel, there are all processes listed with check boxes next to them. By default, all processes are selected. Uncheck the processes you don’t want to view by clicking the check box.
  3. You can search for a process by clicking in the Search String field.
  4. Under the Parameters panel, all Assignees are listed with check boxes next to them. By default, there are two Assignee groups: Roles and Groups, and Users. Both options are selected by default. You can uncheck the assignees you don’t want to view by clicking the check box.

9.5 Adding Other Content to Dashboard Cells

In the center of each cell is an Add icon which helps you add content to dashboard cells.

Clicking this icon displays a menu of items you can add to a cell:

  • Create a View creates a new view and adds it to the cell.

    The steps are the same as if you had dragged and dropped an icon from the Views palette, except that you must select a view category as well as a view type. See Creating a Dashboard and Adding Views for more information.

  • Browse opens the Resource Catalog, from which you can add a view in the project to the cell.

  • Open URL references the content at the specified URL and displays it in the cell. Be sure to include the full URL, including the protocol, such as http://, or an error will result.

  • Insert Image uploads the specified graphics file and displays it in the cell. You can also specify another dashboard to link to, so that when the user clicks on the image, the other dashboard opens in another browser window. Supported image file types are .png, .gif, and .jpg.

Click Save after making any of these changes.

Note:

If you do not save the dashboard, any views and queries you create from the dashboard are not saved and do not appear in the left navigation pane.

9.6 Formatting Dashboard Cells

In the top right corner of each cell is a Dashboard Actions icon which helps you format dashboard cells.

Clicking this icon displays a menu of cell formatting options:

  • Add New Cell Left adds a new cell to the left of the current cell and either splits the cell or adjusts cells in the same row.

  • Add New Cell Right adds a new cell to the right of the current cell and either splits the cell or adjusts cells in the same row.

  • Add New Cell Below adds a new cell below the current cell and either splits the cell or adjusts cells in the same column.

  • Add New Cell Up adds a new cell above the current cell and either splits the cell or adjusts cells in the same column.

  • Change Width displays a slider you can use to adjust the current cell width.

  • Change Height displays a slider you can use to adjust the current cell height.

  • Clear deletes the contents of the current cell from the dashboard but leaves the empty cell in place.

  • Delete the Cell deletes the current cell from the dashboard and adjusts any cells in the same row or column.

You can also add a cell at the bottom of the dashboard by clicking the Add New Cell icon. This icon is to the left of the Save button in the top right corner of the dashboard.

Click Save after making any of these changes.

9.7 Formatting the Dashboard

In the top left corner of the dashboard is a Change Dashboard Properties icon which helps you format dashboards.

Clicking this icon displays the Dashboard Properties window. Changing dashboard properties is optional.

Clicking Title displays the following properties:

  • Font — Select a font from the drop-down list. The default is Tahoma.

  • Font Size — Specifies the point size of the font. The default is 11.

  • Foreground Color — Specifies the text color. Click the down arrow to display a palette. The default is white.

  • Background Color — Specifies the background color of the dashboard banner. Click the down arrow to display a palette. The default is blue.

  • B I U — Specifies whether text is bold, italic, underlined, or a combination. The default is plain text.

  • Subscript, Superscript, Strikethrough — Specifies whether text is subscripted, superscripted, struck through, or a combination. The default is plain text.

  • Outdent, Indent — Outdents or indents title text.

  • Text — Specifies the title text to be displayed.

Clicking Background displays the following properties:

  • Default — Specifies the default background, which is plain white.

  • Color — Specifies the background color of the dashboard. Specify a hexadecimal or RGB color code or click the down arrow to display a palette. The default is white.

  • Image — Specifies an image file for the background. Supported image file types are .png, .gif, and .jpg.

  • Centered, Tiled — Specifies whether the background image is centered and used once, or whether it repeats with a tiled appearance.

To save the properties you have edited, click OK, then click Save.

9.8 Creating a Tabbed Dashboard

A tabbed dashboard contains other complete dashboards, which you view by clicking the tabs.

Before you can build a tabbed dashboard, you must create the other dashboards it will contain.

To create a tabbed dashboard:

  1. Go to the Designer page.
  2. Click Dashboards in the left panel navigator, or right-click Dashboards and select the Create menu item.

    The Dashboards dialog opens.

  3. Type a Name, optionally edit the Display Name, and optionally add a Description.

    The Name is case sensitive, must begin with a letter, and may consist only of letters, numbers, and the underscore character. It may have up to 128 characters. It cannot be changed after the dashboard is created.

    The Display Name is case sensitive and may contain any characters except the forward slash (/), which indicates a folder path. It may have up to 128 characters. It can be changed at any time.

  4. Select Tabbed Dashboard as the dashboard type.

    To create a regular dashboard, see Creating a Dashboard and Adding Views.

  5. Click Create.

    A blank new tabbed dashboard opens.

  6. Click the Select Dashboards to Add icon in the top right corner of the dashboard.

    The Select Dashboards to Add dialog opens.

  7. Check the boxes to the left of the dashboards to be included.
  8. Click OK.

    The selected dashboards are added in the order of their internal names, and the tabbed dashboard is saved.

  9. To remove an included dashboard from the tabbed dashboard, click the X on its tab.

    The dashboard is removed, and the tabbed dashboard is saved.

9.9 Editing a Dashboard

This section outlines the procedure to edit a dashboard.

Use the following procedure to open a dashboard for editing, edit it, and save it.

To edit a dashboard:

  1. In the left navigation pane, click the arrow to the left of Dashboards.

    All saved dashboards in the current project are displayed in a list.

  2. Click the dashboard name, or right-click the dashboard and select the Edit menu item.
  3. Make the desired changes.
  4. Click Save.

You can edit the properties or runtime interactions of a view from the dashboard using the Business View Actions icon. However, to switch the view type, you must edit the view by opening it from the left navigation pane. See Creating and Using Business Views for more information.

You can edit the configuration of the query on which a view is based from the dashboard using the Open Query Editor icon. See Creating Business Queries for more information about query configuration.

9.10 Renaming a Dashboard

This section outlines the procedure to rename a dashboard.

Use the following procedure to change the Display Name of a dashboard.

The Display Name is case sensitive and may contain any characters except the forward slash (/), which indicates a folder path. It may have up to 128 characters. It can be changed at any time.

To rename a dashboard:

  1. In the left navigation pane, click the arrow to the left of Dashboards.

    All saved dashboards in the current project are displayed in a list.

  2. To rename the dashboard, right-click the dashboard name and select the Rename menu item.

    The name becomes text in an editable field.

  3. Type the new name and press Enter.

    The new name appears in the list.

When you edit the dashboard, the new Display Name is displayed on the tab. This name is also displayed when you view the dashboard.

However, the internal Name remains unchanged. When you edit the dashboard, this name is displayed on the left in the header. The dashboard URL uses the internal name, so view actions, view drill-across targets, alert actions, and links from other dashboards that reference the renamed dashboard are unaffected.

9.11 Deleting a Dashboard

This section outlines the procedure to delete a dashboard.

Use the following procedure to delete a dashboard. Any view actions, view drill-across targets, alert actions, or links from other dashboards that reference the deleted dashboard must be edited.

To delete a dashboard:

  1. In the left navigation pane, click the arrow to the left of Dashboards.

    All saved dashboards in the current project are displayed in a list.

  2. Click the dashboard icon and click the Delete icon, or right-click the dashboard name and select the Delete menu item.

    A dialog asks you to confirm the dashboard deletion.

  3. Click OK.

    The dashboard disappears from the list.

To delete a view or other content from a dashboard cell, click the Dashboard Actions icon in the cell and select Clear from the menu.

9.12 Securing a Dashboard

A dashboard inherits security settings from the project in which it is created.

For more information about projects, see Planning and Creating Projects.

To change security settings for a dashboard:

  1. In the left navigation pane, click the arrow to the left of Dashboards.

    All saved dashboards in the current project are displayed in a list.

  2. Right-click the dashboard and select Security Settings from the pop-up menu.

    The security tab for the dashboard opens.

  3. To add a role or group to whom you can explicitly grant or deny permissions, follow these steps:

    1. Click the Add icon in the Grant Permissions or Deny Permissions table.

      The Add Application Roles, Groups, and Users dialog opens.

      See Managing Oracle BAM Users for information about how to add users to roles and groups.

    2. Type a Name for the role or group you are adding.

    3. Select from the drop-down List: Application Role or Group.

    4. Click Search to populate the Available Members list.

    5. To add a member to the Selected Members list, select the member and click the single right arrow.

    6. To add all members to the Selected Members list, select the member and click the double right arrow.

    7. To remove members from the Selected Members list, use the single and double left arrows.

    8. When the Selected Members list is final, click OK.

      The Add Application Roles, Groups, and Users dialog closes, and the Name you specified appears in the table.

  4. To remove a role or group, select the table row and click the Remove icon.

  5. To grant permissions, select Read, Write, Remove, or Security for the users, roles, and groups listed in the Grant Permissions table.

  6. To deny permissions, select Read, Write, Remove, or Security for the users, roles, and groups listed in the Deny Permissions table.

  7. Click Save.

Make sure all the views in the dashboard grant the same or greater permissions to users. See Securing a Business View for more information.

9.13 Displaying a Dashboard URL

This section helps you find the dashboard URL for any dashboard you view in the BAM composer.

Use the following procedure to display the URL of a dashboard.

To display the URL of a dashboard:

  1. In the left navigation pane, click the arrow to the left of Dashboards.

    All saved dashboards in the current project are displayed in a list.

  2. To display the URL of the dashboard, right-click the dashboard name and select the Show Dashboard URL menu item.

    The ADF and JET-based URLs appear in a small window. The syntax for an ADF dashboard is as follows:

    http://host:port/bam/composer/faces/proxypage?project=project&dashboard=dashboard
    &DashboardParameters=(Parameter1=value;Parameter2=value)

    For example:

    http://www.example.com:8001/bam/composer/faces/proxypage?project=MyProject&dashboard=MyDashboard
    

    The syntax for the JET dashboard is as follows:

    http://host:port/bam/composer/jet/dashboard?project=project&dashboard=dashboard
    &DashboardParameters=(Parameter1=value;Parameter2=value)

    For example:

    http://www.example.com:8001/bam/composer/jet/dashboard?project=MyProject&dashboard=MyDashboard
    
    You can also hide the parameter panel on the right by adding the hideParameterPanel parameter to the URL. For example:
    http://www.example.com:8001/bam/composer/faces/proxypage?project=MyProject&dashboard=MyDashboard&hideParameterPanel=true
    This is not applicable for JET-based dashboards.
  3. Click the X in the top right corner to close the window.

The URL uses the internal Name of the dashboard. Therefore, renaming the dashboard, which changes the Display Name, does not affect view actions, view drill-across targets, alert actions, and links from other dashboards that reference the renamed dashboard.

You can use the URL to add a BAM dashboard link to a web page. For example:

<html>
<body>
<iframe src="http://www.example.com:8001/bam/composer/faces/proxypage?project=MyProject&dashboard=MyDashboard width="100%" height="100%">
</iframe>
</body>
</html>

You can set the height and width attributes of the iframe.

9.14 Viewing a Dashboard

This section outlines the procedure to view a dashboard from the Designer page.

To open a dashboard for viewing:

  1. In the left navigation pane, click the arrow to the left of Dashboards.

    All saved dashboards in the current project are displayed in a list.

  2. Click the dashboard icon and click the Open icon, or right-click the dashboard name and select the Open menu item.

    The dashboard opens in a new browser window.

  3. To display parameters for which you can change values, click the arrow in the center of the right edge of the dashboard.

    The Parameters list is displayed.

  4. Change parameter values as desired.

    The views in the dashboard change in response to the parameter values. For more information about parameters, see Creating Parameters.

The main part of BAM from which you open dashboards for viewing is the BAM Viewer (the Home page). From the Designer page, you can configure how a dashboard is handled in the BAM Viewer:

  • To add the dashboard to the Favorites list in the BAM Viewer, right-click it and select the Favorites menu item.

  • To automatically launch the dashboard whenever you log in to BAM, right-click it and select the Start on Launch menu item.

See Using Oracle Business Activity Monitoring as a Viewer for more information about using the BAM Viewer.