Dashboard Extender Business Rule Examples

Using Page State

A page state is used in a Business Rule to store information about a specific Dashboard page instance.  If a user has multiple tabs open with two different Dashboards, different state information can be stored for each page.  For example, when a Dashboard is first opened, a Dashboard Extender Rule can run in the Dashboard’s Load Dashboard event and then store the results of some database queries.  Once the Parameter’s selection changed, another extender could read the page state.

To use page state in a Dashboard Extender Rule, get the Page Instance ID using

args.PageInstanceInfo.PageOrDlgInstanceID

Then pass that using one of the following BRApi functions:

• BRApi.State.DeletePageOrDlgState

• BRApi.State.DeleteAllStateForPageOrDlg

• BRApi.State.SetPageOrDlgState

• BRApi.State.GetPageorDlgState