Common Components

This section provides the details of all the common components you use in
Clarity PPM
Manage Your Data in Grid Layout
One of the common components in Clarity PPM is the dynamic new grid. You can find the grid throughout the application to manage projects, tasks, roadmaps, and ideas, and timesheets to name a few.
The following video captures all the important tasks you can perform from Clarity PPM Grids in the New User Experience:

Common Grids
The grids are consistent in most aspects; however, specific functionality varies by grid, page, user access rights, and individual user behavior in client browsers.
In addition to its familiar spreadsheet-inspired arrangement of rows, columns, and cells, the grids offer the following functionality:
View Options
  • Set decimal display for numbers and money (formats do not apply to your own custom user-defined integer attributes that you define in Studio)
  • Manage Picklists (instance-specific sets of values)
  • Select fiscal periods that should be displayed (Weeks, Months, Quarters, and Years) - In the Clarity PPM New User Experience, you can view all the periods that have been defined by your administrator in the fiscal calendar. Many administrators do not define fiscal weeks and hence this information is not available in the New User Experience.
Edit Data in Grids
  • Right-click in a grid to use the context menu to add or delete rows.
  • Add a row item.
  • Copy and paste cell values.
    Beginning with Release 15.5.1, fields or columns with lookup values support copy and paste, but only within the same column.
  • Observe subtle visual treatments for rows and cells. For example, new rows and cells appear in a different color from saved rows and cells.
  • Missing required fields with no default values get added automatically when you add a row. If values are missing from required fields, messages and subtle color shading appear to indicate.
  • Pin, resize, reorder, and reset columns to personalize each grid.
  • Grids support a preset maximum number of rows per page. For example, the roadmap grid shows 100 rows per page, the Staffing Resources-to-Investments page shows 200 resources, and the Project Staff page shows 500 rows per page. Use the FIRST, PREVIOUS, NEXT, and LAST controls to navigate between multiple pages.
  • Select dates from a scrolling calendar with year, month, and day controls.
  • Sort by a column in ascending order, and toggle the sort order with a single click in descending order.
    Fields with multi-value lookup values do not support sorting.
  • Shift+Click to sort on up to four columns. To remove sorting on one of the columns, hold down the Shift key and click the column header twice.
  • Open a conversation by clicking the comment bubble icon for a line item in the Conversation column. The icon is white or empty when no conversation exists and turns blue after at least one comment appears in a new conversation.
  • To show or hide columns on the grid click Column Panel and make your selections. You can also drag a column header cell up and off the grid to hide it from view.
  • Hover over a column header to display the
    ≡ Column Heading Options
     menu with choices for pinning, auto-sizing, and resetting columns.
Collapse Related Rows Together In Group By Mode
You can see the Group By bar, wherever the
Clarity PPM
Common Grids are used in the
New User Experience
. The Group By feature allows you to do the following tasks:
  1. Drag a column header and view the data in the grid as rows of logical groups.
  2. Expand multiple groups simultaneously to view associated data.
  3. Edit data directly in the grid while you are in the Group By mode.
  4. Select a row and open the Details panel to edit information. The information that you update in the details panel will automatically be updated in the grid.
When you edit aggregation column values under GroupBy child records, the aggregation sub-totals are not calculated automatically. Click the Refresh button to update the subtotals.
Group By.jpg
Sid, a Portfolio Manager, wants to group ideas by priority and quickly update the Planned Benefit associated with a few ideas. He then intends to examine the impact of those changes on the total Planned Benefit for High, Medium, and Low Priority ideas. Let’s examine how Sid uses the Group By functionality while analyzing ideas.
Follow these steps
  1. Open the
    Clarity PPM
    New User Experience
    and navigate to the Ideas grid.
  2. Drag the
    Idea Priority
    column to the Group By bar to group the ideas by priority.
  3. Expand the
    , and
    groups and locate the relevant ideas.
  4. Edit the
    Planned Benefit
    columns directly in the grid or by using the Details panel. You will see a notification informing you that subtotals have changed.
  5. Click the
    button to update subtotals and examine the impact of your changes.
The rows remain in the same sort order that is used before you entered Group By mode. The groups appear in ascending sorted order. You cannot change the sort order or can choose which columns to show or hide.
Group grid data by a selected field
Group grid data by a selected field
The aggregated subtotals for each group are not supported wherever a mathematical total cannot be calculated. Boolean, Date, Percentage, Calculated, Formula, Aggregation, TSV, and Lookup attributes cannot show an aggregate subtotal.
Edit Information by Using the Details Panel
Project Owners and Business users with access rights can configure and use the Details panel to quickly view and update fields in the
New User Experience
. The Details Panel is available as two-column layout enabling which can be resized to take up 75% of the screen.  The Details layout allows you to include two fields in per row.  You can horizontally drag any field to occupy one or both columns of the layout. You can vertically resize string and large string datatypes.
While the width of the Details panel is persisted for users across pages in the
New User Experience
, the fields in the panel are associated with your view.
The Details panel is available across the New User Experience where you can use the standard grid or board layouts. The panel is also available for the Timeline (beta) layout for Project tasks introduced in
Clarity PPM
: Nicole wants to ensure that every time her team reviews project tasks in the New User experience, they can:
  • Review if the task is critical or not so that they can prioritize a critical task
  • View what percentage of the task and been completed and the actual effort expended on the task
Let’s see how she configures the Detail’s column and saves a view that is then available to her entire team. 
Follow These Steps
  1. Open the New User Experience and open the relevant project.
  2. Navigate to the Tasks module and open the Grid layout. Remember that the Details panel is also available in the Timeline (beta) and the Board layout. The updates you make in one layout will persist across the other layouts.
  3. Click any row in the grid.
  4. The DETAILS tab appears along the right edge of the page.
  5. Click the
    tab. The DETAILS panel appears.
  6. On the DETAILS panel, click the
  7. Click
  8. Search for and locate the Critical field.
  9. Drag a field from the list of fields to the Details panel layout. Drop the field on the top of an existing field. Your new field is displayed on the layout above the existing field.
  10. You can drag and drop fields to reorder their sequencing. Remember that you can horizontally drag any field to occupy one or both columns of the layout. You can also vertically resize string and large string datatypes.
  11. Similarly, add and arrange the % complete and the Actuals fields to the details layout.
  12. To remove a field, select it on the layout and then click
    X Remove
  13. Click
  14. Click
    , and enter the name of a VIEW to save it.
Clarity PPM Charting Capability - Beta
Clarity PPM now provides you an out-of-the-box charting experience in the common grids in the New User Experience. The charting experience is very similar to the capabilities you find in spreadsheet applications like Microsoft Excel or Google Sheets but is directly embedded within the Clarity PPM New User Experience. Let’s consider the example of Sid – a portfolio manager – who wants to review the ideas submitted by his organization and compare the planned cost with planned benefits and planned ROI. Sid needs to navigate to the Ideas page, select the relevant ideas, and use the Chart Range (beta) option. Sid can then edit the chart and export it to share it with other stakeholders.
The following video demonstrates how you can quickly and easily convert important information in the grid to graphs:

Grid Charts
Some key points to remember while using charts in the Clarity PPM common grid are:
  • The string, number, percent, money, and TSV datatypes are supported. If you select cells that include other data types, Clarity PPM does not consider them while creating a chart.
  • The ability to aggregate and group only Individual cell values in the chart is not available in this beta release.
  • Every chart consists of categories and series. All the string datatypes included in your selection are considered as categories while the number, percent, money, and TSV datatypes are considered as series.
  • When you create a chart, the category will be highlighted in green, while the columns included as series will be highlighted in blue. Columns that are not considered in the chart will not be highlighted.
  • You can only select cells that are on your current page if you have multiple pages in the common grid. The grid displays 100 rows on one page.
Create a Chart
You can create a chart by navigating to any of the common grids in the Clarity PPM New User Experience.
Follow these steps:
  1. Navigate to any of the common grids in the Clarity PPM New User Experience. In our example, Sid can navigate to the Ideas grid.
  2. Right-click and select all the cells that you want to include in your chart.
  3. After finalizing the selection criterion, right-click and select
    Chart Range (beta)
    , and select the type of chart you want to create. You can create Column, Bar, Pie, Line, X-Y (Scatter), and Area charts. The chart is displayed.
You can move the chart on the slide and use the chart range handle to adjust the selection criterion and dynamically update the chart.
After you create a chart, you can perform the following actions:
  • Maximize the chart to view it more clearly.
  • Edit the chart details by using the Details button.
  • Display or hide the selection criterion by using the hyperlink icon. When the selection criterion is visible, you can modify it to update the chart dynamically. When the selection criterion is hidden, you cannot change the initial selection criterion used to create the chart.
  • Export the chart as an image file.
Some key points to remember when you create a chart are:
  • Clarity PPM will select the first string data type from the left as the default category. All other string datatypes in your selection criterion will be available if you want to edit your chart.
  • You can add a category after the chart is displayed.
  • You can edit the chart settings after the chart is displayed.
Edit Chart Details
After you create a chart, you can edit it by performing the following operations.
Follow these steps:
  1. Use the
    tab to change the chart type.
  2. Use the
    tab to modify the categories and series associated with the chart.
  3. Use the
    tab to edit the look and feel of the chart. Some key activities you can perform are:
    1. Edit the title and padding associated with the chart
    2. Edit the legends associated with the chart. You can change the position, padding, font, and font size associated with the legend.
    3. Edit the axis and grid associated with the chart. You can also use the X-Rotation and Y-Rotation options to ensure that content in the chart is legible. This feature is useful when your category is an attribute such as the subject of an idea, which includes sentences.
    4. Edit the series to enable tool-tips, labels, shadow. The chart is dynamically updated to reflect your changes.
    5. Click the chart to exit the Edit mode. 
Export a Chart
After you have finalized editing your chart, click the
icon to save your chart in the PNG format.
Export Grid Data to a CSV File
You can export the common grid data to a CSV file. Grids that support Export to CSV include projects, custom investments, custom sub-objects for projects, assignments, staff, and ideas.
The Classic user interface supports the export of up to 25000 rows to CSV file. In this release the
New User Experience
supports the export of up to 250,000 rows to CSV file.
You cannot export a CSV file when the grid is in group-by mode.
Follow these steps:
  1. Navigate to a grid that supports the Export to CSV functionality.
  2. Filter the data, add or remove columns, sort, and modify the view. Exit group-by mode.
  3. Click the
    Export to CSV
    • If your view includes 500 or fewer rows, your new CSV export file is produced immediately.
      The application assigns your current view name (or unsaved view) to the downloaded CSV file name. For example, if your view is
      and you click the
      Export to CSV
      icon, the downloaded file name is unsaved.csv.
    • If your view includes more than 500 rows, the message
      Export in Progress. The "Download will be available in..." notifications
      The application assigns
      as the downloaded CSV file name. For example, if your view name is Export Investment, the downloaded file name is 5000021_Export Investment.csv.
      The file is saved and is available for download up to
      days from the date of download. The notification displays the date in mmm-dd-yyyy format.
      The export runs in the background. You can continue working in the application.
      When the file is exported and available for download, a notification appears in the notification (bell) icon at the top right of all pages in the
      New User Experience
      to alert you.
    1. Click the notification (bell) icon to view a link to the file you exported.
    2. Click the link to download the CSV file.
  4. To cancel the export, click
Data Formatting in the Exported CSV File
  • All dates appear in YYYY-MM-DD format in the CSV file.
  • For all locales and language settings, all decimal points appear as a period (.) or dot character.
  • Money values do not include any currency symbols.
  • Semicolons appear as delimiters in between the values in multi-value lookup fields. For example,
    Carryover; Required; Top Choice
Manage Your Data Using Board Layouts

You can use the Board layout in the
New User Experience
to view projects, project tasks, ideas, and custom investments as cards. You can arrange these cards you can arrange with drag-and-drop precision on a board layout with columnar swim lanes. Some key features associated with cards are:
  • Cards can now display numeric data and money values (users can adjust the appearance of this data in View Options)
  • Cards appear in your choice of colors based on the value you select in the Color By field in View Options. Your color selections appear in the legend and are saved with the view.
  • Card titles default to the Name field. If you configure a default value for the Name field in Studio, the application uses that value when creating cards. Without a default value, new cards show New Item as their default name.
  • You can double-click a card to edit its name. You are not limited to using the default name. You can change the field used by the cards to display their names. In View Options, select any string attribute.
  • You can configure cards to display up to four (4) additional fields in any order (use View Options). When additional fields are selected, the name of the fields appears in the legend area.
  • You can configure cards to display up to three (3) numeric metrics in the order that you select. The name of each metric appears in the legend.
Roadmap items are also depicted as cards on a board. However, it currently does not use the common board layout component in
Clarity PPM
Standard Features Associated with the Board Layout
Show and Hide Columns:
You can use the Columns panel to show and hide columns in the board layout.
Use the Details Panel to Edit Information:
You can use the Details panel to view and update fields in the Board layout. The Details Panel is available as a two-column layout, which can be resized to take up 75% of your screen.  The Details layout allows you to include two fields per row.  You can horizontally drag any field to occupy one or both columns of the layout. You can vertically resize string and large string datatypes. To learn more review the Edit Information by Using the Details Panel topic on this page.
Use the Filter Locate Relevant Records:
You can apply one or more filters to search for data that meet your filter criteria.
Set Your View Options in the Board Layout:
You can use View Options to configure the board layout to meet your requirements. 
Follow these steps
  1. Open an investment and navigate to the relevant module if applicable.
  2. Click the
  3. Click
    View Options
    • COLUMNS: Select the attribute that you want the board to use for each column.
    • COLOR BY: Select the attribute that you want the board to use for the color of each card.
  5. Under CARD OPTIONS:
    • CARD TITLE: Select a string attribute to appear at the top to identify each card on the board.
    • CARD FIELDS: Select up to four (4) attributes to appear on the face of each card in the order selected.
    • CARD METRICS: Select up to three (3) attributes to appear along the bottom of each card to convey meaningful status information or metrics.
  6. To configure your own display attributes, choices, and the color of each value, click
    • PICKLIST NAME: Enter a name for your picklist. Each picklist you define can be applied to the current project only.
    • ADD CHOICE: To add a value for your picklist, click
      . Edit the name and color for each choice.
  7. When finished, click
Creating New Records in the Board Layout
When you are in the Board layout and try to add a new record, you get an error message because there are required fields that do not have default values. From
Clarity PPM
15.7 onwards, whenever you create a new record from the board view, the Details panel is automatically displayed. The panel includes all the required fields needed to create a new record. After you populate the required fields,
Clarity PPM
refreshes the Details panel and creates a new record.  You can then continue editing the record and close the Details panel after you complete your changes.  Remember that your record will be lost if you leave or refresh your current view.
When you are populating required fields for a record in the Details panel, you cannot drag and drop the record across different columns since the record has not yet been created in
Clarity PPM
Common Features Across Grid and Board Layouts
You can use the following capabilities across the grid and the board layout:
Filter Your Data in Grid or Board Layout
Filter grid data
Filter grid data
Select Values in Drop-Down Lists
The following image shows examples for working with the common drop-down value lists. When a value list appears for a grid column or as a field on a page, it allows you to select one value (a typical single-select field) or multiple values (a typical multi-select field). When these value lists appear as filters, you can typically select multiple values, even for single-select fields. This behavior allows you to filter or search on more records. For example, records that match Selected Choice 1
Selected Choice 2.
Common New UX Drop-Down Value Lists
Common New UX Drop-Down Value Lists
Saved Views
The application supports the modification and saving of views by multiple users. Each user can modify their own saved and unsaved views. The views in grids are responsive to a wide array of user actions inside grids. For each adjustment you make, decide from the following options:
  • Save an existing view
  • Save a new view
  • Keep working in the unsaved view
The application cannot tell if you or other users happen to configure an unsaved view that matches exactly with a previously saved view. For example, you save View 21 with a certain arrangement of fields. You modify the view such that it is now an unsaved view. You configure the unsaved view such that it matches the exact configuration of View 14.
still appears and not
View 14
. If you want to see that a specific view is applied, you must select it by name.
Saved Views on Sub-Objects of the Investment Abstract Object Are Available Across Objects and Instances
When you use an out-of-the-box or custom sub-object associated with the Investment abstract object (Staff, Tasks, Cost Plan), then saved views on those sub-objects are available across various objects and instances. Review the examples given below to learn more about this feature.
Saved Views on the Staff Module
When you save a view in the Staff module, it will be available across all other instances and objects that are using the Staff module in Clarity PPM. In Clarity PPM 15.7.1, the Staff module is available for projects and custom investments.
Derek is a resource manager and is responsible for staffing investments. He navigates to the Staff grid for a project and customizes the grid to show per-period metrics for soft and hard allocations. He also configures the grid to display the allocation for each resource every month and saves this view. The view will now be available across all the projects, and custom investment items in Clarity PPM 15.7.1.
Saved Views on the Tasks Module
When you save a view in the Tasks module, it will be available across all other instances and objects that are using the Tasks module in Clarity PPM. In Clarity PPM 15.7.1, the Tasks module is available for projects and custom investments. If your current instance or object does not include elements such as picklists or filters, you will receive an error message. Then, you will see an unsaved view with all the elements of the saved view that apply to your current object and instance.
Nicole, the project manager, has created a custom picklist in the timeline layout for the tasks module. She has also set the Periods to months and added a filter to review tasks with ETC between 50 and 100 hours. She now saves her view and calls it High ETC. This view will be available across all projects and custom investments in Clarity PPM. However, when stakeholders use the High ETC view on the Tasks Module in a different project or custom investment, they will see an unsaved view. This is because the picklist is only associated with the project in which it was created. Stakeholders will see the ETC filter, and the Period will be set to months. Stakeholders can save the unsaved view and continue to use it.
Saved Views on the Cost Plan Grid
When you save a view in the Cost Plan gird, it will be available across all other instances and objects that are using the generic cost plan grid. In Clarity PPM 15.7.1, the generic Cost Plan grid is available for ideas and custom investments. If your current object instance does not include a grouping attribute that was used by a filter or group by in the saved view, you will receive an error message. Then, you will see an unsaved view with all the elements of the saved view that apply to your current object and instance.
Rita, a financial manager, created a cost plan for an idea and used department and location as a grouping attribute. In the cost plan, she sets the periods to months and a money decimal display. Finally, she groups the costs by location and saves her view. When stakeholders apply this view to a custom investment cost plan where the grouping attribute is Cost Type, they will see an unsaved view. This is because the location grouping attribute is not available in the custom investment. Stakeholders will still see the periods set to months and the relevant money display.
The Projects Financial Module does not use the generic cost plan grid. Hence, the saved views associated with cost plans for custom investments and ideas will not be available for projects.
Attribute Data Types
Available Attributes
All attribute data types except the following are available for configuration in a grid:
  • Attachment
  • Custom time-scaled value (TSV)
Required Attributes
Required attributes display an asterisk (*) after their label.
  • Your current saved view might be missing one or more required fields. When you add a new row, the application shows the required fields that do not have predefined default values and your view switches to
    . Any custom attributes that are marked as required are also added to the view.
  • If you add a required custom attribute in Classic PPM when records already exist in the system, provide a default value. We also recommend that you select the
    Populate Null Values with the Default
  • Another way to populate a new required attribute is to specify an
    API Attribute ID
    so users can add it to the grid using the Column Panel and can enter a value.
What Happens When An Attribute In My Saved View Is Removed Later?
You can store your filter, column, sorting, and grouping settings in a saved view. If an attribute in the saved view is later removed or inactivated in Classic Studio, the following behavior occurs:
  • You and other users can still access the view.
  • The removed or inactive attribute no longer appears in the filter, columns, sort order, or grouping.
  • The named view now appears with the
Static Dependent and Parameterized Lookups
Static Dependent lookup and Parameterized lookups are enabled in the New User Experience for Projects, Ideas, and Custom Investment type objects. You can configure and API enable the required lookups from the Classic UI and publish the Blueprint in the New User Experience for the lookups to appear.
API Enable Lookups
Follow these steps:
  1. Log in to Classic UI.
  2. Navigate to
  3. Filter
    and click
  4. Navigate to the
    tab and click
  5. Specify the following details:
    • Attribute Name
    • Attribute ID
    • Description
    • Data Type
      • Specify
        Multi-Valued Lookup
    • Lookup
      • Browse for the lookup value and click
        and then click
        . Example, Investment Type
    • Entry Level
      - Example, Investment Process
    • Exit
      - Example, Investment Stage
    • API Attribute ID
      - Specify the ID for the lookup to be enabled in the New User Experience
  6. Click
The lookup is created and is available in the Blueprint. Copy, edit, and publish the blueprint for the lookup to appear in the object attributes.
Static Dependent Lookup
- The lookups that can be applied in single fields and have structured hierarchy are static dependent lookups. You can select the lowest level value from the lookup hierarchy based on the highest level selection.
  • For the static dependent lookup to appear in the New User Experience, you must populate the API attribute ID.
  • Once enabled the lookups are available wherever attributes are applicable and filtered. The static dependent lookups can be added to the Details panel using the Blueprint.
  • You can also add static dependent lookups to board cards.
  • You can add these attributes as columns in Grid view and in the flyout. You can also filter data based on the static dependent list lookups.
    The Investment Stage of a project can be indicated with a static dependent lookup such as
    Investment Stage > New Product Development > Maintain
    Static Dependent Lookup
Parameterized Lookup
-  Two lookup fields are connected by a passed parameter. Two lookups are defined as two separate attributes in the object and the value from one lookup will determine the available values in the second lookup.
  • Parameterized lookups will appear in the New User Experience once their API alias values are populated.
  • The lookups will function the same as in Classic UI.
  • Enabled parameterized lookups can be added to blueprints to be included in the Details panel.
  • Changes of a lookup value in a grid view or flyout are reflected seamlessly in the other.
  • You can also add parameterized lookups to board cards. 
  • You can filter data based on parameterized lookups. When filtering based on dynamic query-based lookup (lookup that changes options based on primary lookup value) then the filter will display all possible options.
Application Change
lookup has two sub-values
COTS Evaluation
. After you select the project type, you can select the project category.
Parameterized Lookup