A dashboard is a part of the user interface that contains one or more widgets grouped into slots arranged within a template. A template is an arrangement of slots. Each slot can have multiple (or no) widgets assigned to it. Widgets contain controls that the user can configure.

Use this tutorial to create a personalized dashboard template in Designer Studio for displaying case data in an application. An example configuration is also included.

Requirements

Before getting started, you must enable dashboard personalization for your portal. The Customize dashboard icon is displayed at the top of the screen for users who have the privilege for pxDashboard. You should also add the section pxUserDashboard if the Customize dashboard icon is not displayed.

Choosing a default template

The Pega 7 Platform includes several default templates that require no setup.

To select an existing template at run time:

1. Click the Customize dashboardicon to display the Edit dashboard panel.
2. Click Switch template.
3. Select the template that you want to use.
   ​

   Default templates available in the Pega 7 Platform

Creating a customized template

To create your own dashboard template, complete the following steps:

1. Create a section
2. Add dynamic layouts
3. Set section type

Create a section

1. Create a section for your template by clicking +Create > User Interface > Section.
2. In the Apply to field, reference the class that you want in your application.

3. Click Create and open.

Add dynamic layouts

In this set of instructions, you want each dynamic layout that you add to represent a slot for assigning widgets.

1. Add dynamic layouts to the section to match the layout that you want.
2. Drag the section pxUserDashboardSlot into each dynamic layout (slot) so that you can place widgets.

3. Change Page context to Use clipboard page.
4. Use .pxUserDashboard.pySlots(x) for the Clipboard page, where x represents the slot number.

5. Add the name of your section.
6. Optional: You can customize the direction of your widgets by including a section parameter, or you can leave this field blank to stack your slots by default.

Slot orientation options are case-sensitive and include:

• stacked (default)
• inline
• Inline-grid-double
• inline-grid-triple

7. Click OK, and then save your changes.

Set the section type

Identify the type of section that you are creating and configure its settings.

1. From the Settings tab, select Dashboard template.
2. Enter a title and, optionally, an icon for your template.
3. Click Save.

You have successfully created a dashboard template. From the Case Manager portal, select the Settings icon to view your new template at run time.

For a guided walkthrough of adding widgets to your template, see Quick start: Creating a dashboard widget.

Next steps

Now that you know the basics of setting up a template, get the most out of your customized dashboards by viewing Section form - Completing the Settings tab. From here, you can obtain additional information about:

• Setting up a dashboard in a portal
• Personalizing your dashboard    
• Creating a dashboard widget
• Creating a dashboard template