Create and maintain dashboard pages and modules

Managers (or other lead personnel) can create, maintain, and share configured dashboard pages and portlets to facilitate communication and coordination for their own projects. For example, your recruiting organization might share the list of current job openings.

This topic provides details on how to create and maintain dashboard pages and modules.

In this topic:

Overview of dashboard pages and modules

Modules are either provided by the product or created by administrators. Modules can be presented to end users as either Private Dashboard pages or Shared Dashboard pages. Modules must have a unique name and can contain one or more dashboard pages, each with one or more portlets.

Dashboard pages	Description
Private dashboard pages	Private dashboard pages are modules that end users add to their Private pages folder of the Personalize Dashboard page. Private dashboard pages can be edited and personalized by users to increase their usefulness.
Shared dashboard pages	Shared dashboard pages are modules that are created by administrators or private dashboard pages shared by end users. For details about shared private dashboard pages, see Personalize Dashboard . Shared dashboard pages (both shared dashboard paged created by administrators and end users) are listed in the Shared pages folder of the Personalize Dashboard page. Shared dashboard pages that are created by administrators can be configured to enable or disable end users to add them to the Private pages folder for editing. If allowed, end users can add shared modules to their private dashboard pages either by copy and paste or from the Add Preconfigured Pages window. Shared private dashboard pages (dashboard pages that are created and shared by end users) cannot be edited by the users that these private dashboard pages are shared with.
Preconfigured pages	Preconfigured pages are modules that are configured to allow end users to add to their Private Dashboard pages. Preconfigured pages are either provided by the product or created by administrators.
Landing page (Default dashboard page)	The Landing page is the default dashboard page that is displayed when a user logs on to the application. This page is configured by administrators. If the user does not have access to the module that contains the landing page, the user's first private page is used as the default dashboard page. If the user does not have any private pages configured, the first shared page is used as the default dashboard page. For information on how to configure this page, see Configure landing pages.

Back to top

Create and configure a module

This section provides details on how to create and configure a module.

To create and configure a module:

1. Click the Administration button in the masthead.

2. From the Administration menu, click Dashboard > Create Module.

3. In the Module Name field, give the module a unique name.

4. (Optional but highly recommended) In the Description field, type a brief description of the module.

5. (Optional) Select the Enabled option to enable the module.

6. Click Create. The Configure: <module_name> page opens.

   Note: The content of the page may differ depending on the module chosen.

7. (Optional) In the Header section, update the data in the appropriate fields.

8. (Optional, although highly recommended) In the Administrator Comments section, add comments as desired.

   Tip: Click Save before clicking View Comments to view the comments you just added.

9. In the Configure Access section, specify who can do what to the module. For details, see Configure access of a module.

10. Add Dashboard pages and portlets as desired.

    • To add a Dashboard page to the module:

      You can either add a new page or add a user's page to the module.

      Add a new Dashboard page to your module	Click New Page under your module's folder. Alternatively, you can select the your module's folder, hover over , and click New Page. (Optional) Rename the page. Click Add Portlets. For details, see Create and maintain dashboard pages and modules.
      Choose a user whose page will be added to your module	Select the your module's folder, hover over , and click Add user pages. In the User field, select a user whose pages you want to add to your module. In the Pages field, select which pages of the select user you want to add to your module. Click Add.

    • To add portlets to a dashboard page, see Add portlets to a dashboard page.

Note: If your PPM instance supports multiple languages, any module you create is defined in the language you selected at logon (your session language). After the module is created, it can be modified only in its definition language. For more information, see Multilingual User Interface Guide.

Back to top

Copy a module

You can create a module by copying an existing module as the basis for the new module.

To copy a module:

1. Click the Administration button in the masthead.

2. From the Administration menu, click Dashboard > Configure Modules.

3. Search for and select a module.

4. Select the name of the module from the Modules folder.

5. Click the Clone button, or right-click the module name and select Clone.

   An advisory dialog box appears.

6. Click OK. A copy of the module appears in the Modules folder.

7. Select the name of the copied module.

8. Change the settings of the copied module using the steps detailed in Create and configure a module.

   Remember to enable the module once the settings are updated.

9. Click Save.

Back to top

Configure access of a module

You can configure a module to determine who can view, edit the module, and add the module to their private Dashboard pages as preconfigured pages.

To configure access of your module:

1. From the Configure Modules page, search for and select a module.

2. Select the name of the module from the Modules folder.

   In the Configure Access area, configure the following:

   Option	Details
   Read-Only Access	Specify which users have read-only access to the module: Allow access to all users: select this option if you allow all the users to have the read-only access to the module. Add Users: use this field to select which users or security groups have the read-only access to the module. Enable users to copy this module pages to their private dashboard: select this option if you allow all users to copy the Dashboard pages of the module to their private Dashboard.
   Administrator Access	Specify which users can modify the module: Use the Give Access to field to select which users or security groups can modify the module.
   Self-Service Access	Specify which users can add the module to their private Dashboards as preconfigured pages: Select the Allow users to add this module to their own Dashboards as Preconfigured Pages. In the Give Access to field, select which users or security groups can add the module to their private Dashboards as preconfigured pages. The users that are not selected or in the selected group cannot see the module when they click Add preconfigured page in the Personalize Dashboard page. Example: Suppose you create a module and want to share the module with a group of target users, you can do the following: Enable the module Select the Allow access to all users option Select the Enable users to copy this module pages to their private dashboard option

Back to top

Delete a module

You can delete a module.

To delete a module:

1. From the Configure Modules page, search for the module, and click the Remove button in the front of the module name.
2. Click Delete in the confirmation dialog box.

You can also delete a module in the Configure: <module_name> page:

1. From the Configure Modules page, open the target module.
2. Select the module folder under the Modules folder, and click the Delete button.
3. Click OK in the confirmation dialog box.

Back to top

Enable the use of dashboard page filters

Dashboard page filters are filters added on dashboard pages. They enable you to change portlet preferences for multiple portlets in a dashboard page at a time.
You must enable the user of Dashboard page filters before using dashboard page filters.

To enable the use of dashboard page filters:

1. From the Feature Toggles page, locate the Dashboard Page Filters for Builder Portlets feature toggle, and turn it on. For details, see Use feature toggles to turn on/off features.
2. Click Yes in the confirmation dialog.

Back to top