Dashboarding: Configuring a Drilldown

Body

A common need when building dashboards is to allow a user to click on an element in the dashboard and transition that user to another page that contains related or more detailed information about what is being clicked.  For example, clicking on a status gauge showing overall status and moving to another page that has some detailed information about that status.

This kind of drilldown is configured using "wires" in DASH.  Here, I'll walk you through the basic steps of setting up a wire that will launch your drilldown page.

Initially, you need to create both the page that will be the "top" page and your drilldown page.  Once these are both created, you're ready to start setting up wires, just follow this recipe:

Step One: Put your top level page in edit mode.

Step Two: Choose the widget that will initiate the drilldown and check out the events it publishes by clicking the "Events" context menu item on the widget:

 

 

 

 

 

 

 

 

 

 

 

 

Step Three: Make sure it is actually publishing an event.  Usually it is the NodeClickedOn event.  Ensure the check box is checked.

 

 

 

 

 

 

Another note, you should follow this same process on your target page to ensure that any widgets you want to react to the event are subscribed to that event.

Step Four: Create a new wire by clicking the wiring icon in the top right of the page.

 

 

Step Five: Select the widget and event that will be the source.  Widget names correspond to the widget titles.  You can expand the widget to see all the published events.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Press OK once you've selected the event.

Step Six: Select the target page for your event.  This dialog shows a mini view of the navigation nodes and pages under them.  You can choose the page you want to target by highlighting the page.  Some very important settings are located in the check boxes toward the bottom of the dialog.  They control whether the target page will be loaded and/or brought to the foreground.  For a typical drilldown, you will want to be sure both of these boxes are checked.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Click OK the rest of the way to save your wire, and you should be all set!  Save your page and try out your new wire.


Hope this helps!