Widget Configuration

The Widget Configuration page allows you to configure default settings that users will see when they log into PPO for the first time.  Once they have logged in, they have the ability to configure their own default settings on the List pages.  They are also able to restore their lists back to the default settings as defined on the Widget Configuration page.

This article covers:

How to access Widget Configuration:

To access the functionality, navigate to the Administration Menu and select the Widget Configuration item.  On the left-hand side of the Widget Configuration page is a list of all the Entities and Administration functions. To set a default for an entity List page, first, select the Entity.

The below page will then open.

1. Setting Column defaults

Setting default columns allows you to specify which fields a user will see when they are on any list page in PPO.  Example below.


Looking at the screenshot above (1), you then have the ability to:

  • Add additional fields to the list page as columns by clicking in the "Click to select additional columns" field.
  • Use the drag and drop functionality to change the sort order of the fields you want to view in your list.  Simply click on the field you want to move and drag and drop it to the desired order.
  • Remove fields from the list page by clicking on the "remove" button (x).

2. Setting List Page Size default;

When provisioning an instance of PPO, the List page size across the board is 100 items by default.  This can however be changed.

  • Under "Appearance" you can set the list page size by either selecting 10, 20, 50, 100, or 200.  See the screenshot above (2). The maximum list page size is 200. 

3. Setting Chart defaults

Default Charts have been set for the Demand, Project, Risk, Issue, Cost, Governance and Benefit entities.

As a PPO Administrator, you have the ability to change the existing defaults and set new defaults for Charts that should show on list pages.  You can either add a Key Metric Widget, Donut Chart, Tree Map or a Bar Chart.  In the below example, we are adding a Key Metric Widget indicating the Average Variance % for the portfolio of Projects.  Under Colour options, you can either select a Fixed colour, apply a Condition, or apply a Range.

For the Variance % below, if the % is less than 0%, the Key Metric will show Red, If it is 0% or more it will show Green.

The below screenshot shows how it would display on the list page. 

Here is an example of a Bar Chart widget configuration and how it would display as a stacked graph on a list page:

The chart widget works interactively with the filter control. If you were to click on the green portion (Execution projects) of the graph below, the Project list would automatically filter by only showing those projects in Execution.  In the filter control, you can also remove the Phase filter pill and the Donut graph will adjust accordingly.

Clicking on the Name Execution in the Donut Chart Legend removes execution projects from the donut chart but not the list page.


You have the ability to hide your Chart Widgets by clicking on the "x" icon and also unhide it by clicking on the "<" icon as shown in the below screenshot.

4. Copying, editing & deleting charts

You have the ability to copy, edit or delete existing charts by using the below icons.

Setting Calendar Widget defaults

The Calendar Widget in PPO gives you the ability to add and display events from entity items, based on certain criteria. The Calendar shows the related data as a weekly or monthly view on your Home Page.

To update or add defaults for the Calendar Widget, scroll down on the left-hand side of the screen and select Calendar Widget as shown in the below screenshot. 

For the calendar widget, default settings are as shown above and are documented in the Calendar Widget article.  As an Administrator, you have the ability to either copy, edit or delete the existing defaults by using the icons below or add additional defaults for your users.  By clicking on the "Add an Event to Calendar" you can add a new default that will be applicable to all users.

Once you have selected the "Add an Event to Calendar" button, the below fields will be visible that you must complete:

Title - Provide a Title for your event (i.e. My Tasks, My Risks, My Issues).

Data Source - You can select any entity from the drop down list.

Filter - Based on the entity selected, you have the option to apply filtering the same way as you would on a list page in the Filter Control.

Start - Select the date that indicates the start of the calendar entry. All the date type fields for the specific entity will be listed.

End - This allows you to select a date that indicates the end of the calendar entry. This is optional and not mandatory. All the date type fields for the specific entity will be listed.  

Where I am - Optionally include events where I am the selected value.  The list will show all the Employee List type fields on the selected entity.

Colour - This allows you to choose the colour that will be displayed for the event on the calendar. You can either use the colour picker or insert a RGB code.

Additional Information:

  • Once a user has changed their own defaults on List pages, it will only restore back to default if the user selects Restore Defaults via the gear icon on their List Pages.
  • The same is applicable to the defaults of the Calendar Widget.  The user can restore back to default settings via the gear icon on the Home Page.

Setting board views defaults

The Board views in PPO are available on all list pages and allows you to visualise your data. The Board gives you the ability to apply a Group By, specify the fields that you want visible on the cards and it also allows you to configure workflows in columns.  

To add defaults for the Board View, under Widget Configuration, select an entity where you would want to apply a default.  The below example is for the Demand entity.

(1) Card Fields:  This will allow you to add or remove the fields that are displayed on your cards.  You can also drag and drop the fields to adjust the sort order.

(2) Group By:  You can select the field that you want to apply as a Group By.  

(3) Workflow field:  By selecting a workflow field, your columns will have headings based on the custom list values of the workflow field selected.

(4) Custom Workflow Columns - Allows you to group certain values together under a single workflow column heading.  This functionality also allows you to customise the column heading caption.  Follow this link for more information.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Article is closed for comments.
Start a 30 Day Free TrialClick ClickNo Credit Card and No Obligation
Powered by Zendesk