Dashboard Utility Overview


In BBj 15.0 and higher, access to full functionality of this feature requires an active Software Asset Management (SAM) subscription. See Benefits of ‘Software Asset Management” Feature Line.


In BBj 14.0 and higher, the Dashboard Utility facilitates the visualization of data via dashboard widgets that may contain all kinds of information based on

  • Bar, stacked bar, and stacked percentage bar charts
  • Pie and ring charts
  • Line, XY, and area charts
  • Grids
  • JasperReports
  • HTML text and websites
  • Images

In BBj 15.00 and higher, the Dashboard Utility offers the following enhancements:

  • Adds a new Widget Wizard that generates BBj object-oriented code to create widgets, widget sets, or widget dashboard
  • Adds tips that display detailed information when left clicking on data in a chart widget
  • Adds user-selectable widget sizing, color themes, fonts, and font size on a per-category basis for dashboard charts
  • Adds the ability to view the data that comprises a Dashboard Widget, or export it to a delimited file
  • Adds the ability to override either the left click, right click, or all click events on a dashboard widget
  • Adds the ability to populate dashboard widgets with a BBjRecordSet

In BBj 16.00 and higher, the Dashboard Utility offers the following enhancements:

  • Adds support for the BASIS_UTILITY_DEVICE_PIXEL_RATIO global string entry to force a particular DevicePixelRatio in utilities such as the Dashboard Utility and the BBJasperViewer
  • Adds the ability for Dashboard Utility widgets to be resizable when popped out
  • Adds the ability to optionally include a JDBC connection mode string when creating and filling SQL-based widgets, making it easier to manage authentication and other connection-specific properties
  • Adds user-editable filters to Dashboard Widgets. In addition to the previous list-based filter, widgets can now have filters based off of BBjListEdit and BBjEditBox controls

In BBj 17.00 and higher, the Dashboard Utility offers the following enhancements:

  • Adds the ability to get the underlying BBjControl from the DashboardWidgetFilterSelectEvent.  Now if a user enters invalid data into a filter control, the custom filter selection routine can not only warn the user but can also reset the filter back to a reasonable value.
  • Adds the ability to show the BBjBusyIndicator with a configurable message when the DashboardCategory initially creates widgets
  • Adds the ability to set the alignment for DashboardWidget titles
  • Adds the ability to set the alignment for the GridWidget's column headers
  • Adds a new setAutoResizeGrid() method that causes the GridWidget to size its columns based on the header and cell text, preventing data from being truncated
  • Adds the ability to set whether the GridWidget is horizontally and/or vertically scrollable
  • Adds the ability to distinguish between different types of refresh in the DashboardWidgetRefreshEvent
  • Adds the ability to modify a DashboardWidget's filters, links, and title in custom code in response to an event
  • Adds several methods to the Dashboard's HtmlViewWidget to aid in injecting and executing JavaScript, as well as the ability to specify different HTML and JavaScript for the popped-out version of the widget
  • Adds the ability to register callbacks for BBjHtmlEvents that occur inside a BBjHtmlViewWidget, so that custom code can be executed when the page is loaded, a hyperlink is activated, etc.
  • Adds the ability to specify custom icons for the Dashboard and DashboardWidget via the ImageList and ImageListHiRes field variables

The Dashboard Utility also offers a way to analyze widget performance by adding debug timing mode that outputs Dashboard Widget query timing to the BBjServices debug log.  See this Bugzilla entry for details regarding how to enable logging and to download a sample program that analyzes the results and presents the data in a sortable grid.


To see the Dashboard Utility in action

  • From a browser, click on one of the Dashboard Demos from the BBx BUI Showcase page (no installation of BBj required)
  • After downloading and installing a packaged version of BBj that includes the Demos, run the <bbjhome>/utils/dashboard/demoDashboardBUISetup.bbj program and choose the (R)un option to launch a BUI program that demonstrates many of the Dashboard's capabilities

Furthermore, the Dashboard Utility facilitates the ability to embed dashboard widgets in an existing BBj, Visual PRO/5, or PRO/5 application.



 For complete Dashboard Utility documentation, including dashboard widgets, click here.  


Example Dashboard

See Also

Dashboard Types

Dashboard Charts and Datasets

Dashboard Chart Customization



Copyright BASIS International Ltd. BBj®, Visual PRO/5®, PRO/5®, and BBx® are registered trademarks.