Clarity Release Notes

The Release Notes provide release-specific information such as new features, enhancements to an existing feature, fixed issues, and known issues. The Release Notes help you plan for a new installation or upgrade to the on-premise or SaaS edition of
Free Clarity Training on Broadcom Academy
  • You can attend FREE Clarity training by registering at the Broadcom Academy.
  • The
    Clarity 15.9.2 New Features and Enhancements
    training highlights the new features in this release.
  • You can log into Broadcom Academy with your existing Broadcom credentials. If you don't have Broadcom credentials, simply provide your official email address and get started with your training.
To learn how the feature might impact your upgrade from an earlier release, see the Change Impact and Upgrade Guide.
New Clarity Mobile App 3.1.0
The Clarity 3.1.0 mobile app has been released on the iOS and Android platforms. Project Managers and other stakeholders with the relevant access rights can use the app to review and approve timesheets for three time periods namely previous, current, and next.
While the Clarity 3.1.0 mobile app supports Clarity and higher releases, you can only approve timesheets if you are on Clarity 15.9.2 or higher releases. The Mobile - Approve Time - Navigate access right has been introduced in Clarity 15.9.2 to support the mobile timesheet approval feature.
To learn more about the Clarity 3.1.0 mobile app, see New! Clarity Mobile App Version 3.1.0.
New Clarity Rally Integration

Organizations can use the new and improved Clarity-Rally integration to ensure data flows seamlessly between the two applications.
The new and improved Clarity-Rally integration is:
  • Easily extensible and configurable
    : You can map objects and attributes between Clarity and Rally to ensure the integration meets your specific requirements.
  • Simple to maintain
    : The integration can be set up and maintained by Clarity administrators who have basic Classic PPM knowledge.
  • Validated and Supported by Broadcom
    : You don’t need to perform regression testing after every release.R
Some of the key steps you need to perform the integration are:
  1. Complete the relevant prerequisites to configure the integration.
  2. Create an Integration Object to integrate Clarity with a specific Rally instance.
  3. Create an Integration Mapping.
  4. Run the Import Integration Mapping job, to fetch all Rally portfolio item type objects and their associated attributes.
  5. Define valid Object mappings.
  6. Define valid Field mappings.
  7. Specify a Clarity Investment that would map to an Object in Rally.
  8. Execute the Synchronized Mapped Information job to synchronize data between Clarity and Rally.
  9. Review Clarity’s Staging Table to understand the changes to be pushed from Rally to Clarity.
Upgrade Impact
: Customers can continue to use both the new Rally integration and the Rally Portfolio Item Hierarchy, Investments, or (Clarity) Timesheet integrations if warranted. If a customer has configured an "Agile" integration, there is no impact on that existing integration after the upgrade. The new jobs (e.g., Import Integration Mappings, Synchronize Mapped Information, and Import Staging Tables) are set as incompatible with the old jobs (e.g., Synchronize Agile Central and Create Agile Central Investments) to prevent them from running simultaneously.
Key Points to Remember
  • If the Import Integration Mapping job is not run after creating a new Integration Mappings instance, the Clarity and Rally Objects will not be available in their respective pull downs. If you create new custom attributes (in either Clarity or Rally), the Import Integration Mapping job must be run to ensure they are available in the field mapping grid
  • After the Synchronize Mapped Information job is run, the user will be auto-granted access to the Staging Tables.
  • The Integration Mapping (view, edit, and delete) Global Access rights are automatically added to the PMO System Administrator group. This back-end process enables access to the Staging Tables.
To learn more about the new Clarity-Rally integration, see Clarity Connections - Rally Integrations.
Accessibility Enhancements

The following Clarity components are compliant with the 4 aspects of compliance in the form of Visual, Responsive Design, Keyboard, and Screen Reader support:
  • View Options (Grid)
    • Money & Number decimal display, Per-Period Metrics Periods, Start Period, End Period, Totals Columns
  • Saved Views
    • Manage and Save As
  • Item Action Bar (multi-select grid)
    • Select All, Deselect All, Edit, Mark for Deletion, Clear Deletion
  • Color Picker - Pick List Color
  • Toaster Message
  • Generic Filter
  • Layout Switch (Board, Grid, Timeline)
  • Attachment (Grid)
  • Search
  • Overall Usability improvements
    • Updated People and Action Icons
    • Banner UX Style Updates
    • Column Panel – Expand / Collapse All sections
For more information on the supported components and level of compliance, see Accessibility Features in Clarity.
Upgrade Action:
No action required.
Enhancements to Investments

Using Mixed Bookings on the Staffing Page
Clarity now supports mixed booking in the Staffing Workspace. In many organizations Project Managers (PM) input soft-booked allocations for all the resources required for a given project and its duration. Project Managers are capturing ‘planned’ allocations. Resource managers have a conversation with the PM to gain alignment and then convert planned (soft) allocations to committed (hard) allocations. The conversation typically occurs on a quarterly cadence which results in a mixed booking.  A team member is mixed-booked when the planned allocation and hard allocation are not equal.
You can enable Mixed Bookings in Classic PPM on the Project Management settings page. In the previous releases, the Staffing Workspace was available in read-only mode after you turned on mixed booking. In this release, you will see the Hard Allocations checkbox on the Resource to Investments and Investments to Resources view. To learn more about the Staffing Workspace, see Clarity: Request Resources and Roles to Staff Investments.
Upgrade Action
: No action required. When you upgrade to this release, and you have mixed bookings enabled, you will be able to use the Staffing workspace.
Key Points to Remember:
  • The Telescope functional design has not changed with the introduction of Hard Allocation in the Staffing workspace.
  • Telescope capability continues to use (planned) allocations and does not include (committed) hard allocation information.
Risks Issues and Changes Modules Available for All Investments
In previous releases, you could manage risks, issues, and changes for investments by using two approaches:
  1. You manage Risks directly for each project by using various Risk attributes and calculating a risk score. Ideas and Custom Investment included a Risk field.
  2. You use Risk, Issues, and Changes modules in projects to create a detailed list of risks impacting your projects.
In this release, the following changes have been made to enhance your risk management experience
  1. If you manage risks directly for each investment, you can use a new calculated attribute Risk Score that has been introduced in this release. 11 new contributing attributes have also been introduced (Resource Availability Risk, Supportability Risk, Technical Risk, Sponsorship Risk, Organizational Culture Risk, Objectives Risk, Interdependencies Risk, Implementation Risk, Human Interface Risk, Flexibility Risk, Funding Risk). Since Risk Score is a calculated attribute, you can populate the Risk Score by population any of 11 attributes that contribute to the Risk Score. These attributes are available for all investments.
    The risk attributes associated with the project object have been depreciated. Clarity will synchronize the values between the deprecated attributes and the new attributes for one year before announcing end-of-support for the Risk attribute and the associated contributing factors. Classic PPM Views will continue to use deprecated risk attributes.
  2. If you plan to create a detailed list of risks then you can use the Risks, Issues, and Changes modules for projects, ideas, and custom investments. These modules were previously available only for projects.
  3. New Create, Edit, Delete, and View access rights have been introduced in this release. Administrators will need to add the Risk, Issues, and Changes modules to the blueprint and provide you the relevant access rights to interact with the modules.
Upgrade Impact
: You need to consider the following points while upgrading to this release:
  • After upgrading to Clarity15.9.2, the custom and standard blueprints associated with Idea and Custom Investment automatically include the Risks, Issues, and Changes modules.
    • If you want to hide these modules from the Standard Blueprint (Ideas and Custom Investments), you can leverage the Business Rules functionality.
    • If you want to remove these modules from custom blueprints, you can edit the blueprint and remove them so that they are not visible to the end-user.
  • If you have edited the Risk attribute in your environment to update the formula calculating Risk, your Risk Score, and Risk attributes will show different values in Clarity. Ensure you update the Risk Score attribute to reflect how you calculate Risks in your organization.
  • Administrators will need to provide users the global access rights to view Risk, Issues, and Changes post-upgrade to ensure they can leverage these modules.
Key Points to Remember
  1. RICs Sub-objects (modules) are not available for Classic PPM NPIOs (including Ideas).
  2. Classic PPM NPIOs properties will not be updated.
    1. Customers can configure properties, lists, and filter views, in Classic PPM, if they want to use the new Risk attributes
To learn more about the Risk, Issues, and Changes, see, Clarity: Manage Risks, Issues, and Changes for Projects.
New Scrolling Widget and Enhanced Options for Viewing Totals
You will see a scrolling per-period metrics widget on the Staffing module. You can click front and back arrows on the widget to quickly cycle through the data for various periods. Your Start Period and End Period settings will update the widget and as you cycle through periods in your widget, the Start Period and End Period will also be updated. You can also define if you want to see Sum of Periods or Grand Totals in the Totals column. If you select Grand Totals, Clarity will continue to display the Totals for the entire duration of your investment even when you cycle through various periods by using the widget.
  • Sum of Period displays the Total (e.g., allocation) for the number of periods in the grid (configured via View Options).
    • Example – If an Investment has a duration of 12 months; the grid is configured to display 6 months; Sum of Periods is selected – the Totals column will sum up the (e.g., allocation) 6 months displayed in the grid.
    • With Sum of Periods selected, the Totals field is editable.
  • Grand Total displays the Total (e.g., allocation) for the duration of the Investment regardless of how many periods are displayed in the grid (configured via View Options).
    • Example – If an Investment has a duration of 12 months; the grid is configured display 6 months; Grand Totals is selected – the Totals column will sum up the (e.g., allocation) for the 12 months of the investment
    • With Grand Total selected, the Totals field is not editable with periods in view
The scrolling per-period metrics widget will not be displayed until the user has selected at least one Per-Period Metrics in View Options.
Upgrade Impact
: No Impact. You will see the new widget on all the grids where per-period metrics are supported.
New Timeline Layout for the Tasks Module
You can use the new and enhanced Timeline layout to create and manage tasks. The Timeline layout is divided into a Work Breakdown Structure (WBS) on the left and a task timeline on the right. Both the WBS and the task timeline show you all the sub-level tasks associated with the selected project/investment item. Some key enhancements made to the timeline are:
  • You can use the COLUMNS tab to add fields to the WBS section.
  • The summary bars are shaded based on the completion of tasks associated with it.
Upgrade Impact
: In the previous release, the Timeline layout displayed fiscal periods. In this release, the Timeline layout supports Calendar periods. Hence, when you upgrade, existing tasks will be displayed in Calendar periods on the Timeline layout.
Key Points to Remember
  • The Timeline includes the WBS column as a fixed column that cannot be hidden or moved to another column position in the grid.
    • There is another attribute “WBS Sort’ which users can optionally add as a column in the table with the timeline in view – and save the configuration in a View
  • Within the Timeline, the "% Complete" progress bar is displayed for all tasks, including summary Tasks
    • The color of a Timeline bar is driven by Task Status
    • The “shading” of a Timeline bar is driven by Task % Complete
To learn more about the Timeline layout, see Clarity: Project Phases, Milestones, Tasks, and To-Do Items.
Mark Investments for Deletion
You can now mark an investment (Project, Idea, Custom Investment) for deletion in Clarity by using the Mark for Deletion action button. When you mark an investment for deletion, Clarity sets the Purge Flag field. The relevant stakeholders can now review all the investments that are marked for deletion. Once they are satisfied, they can run the Delete Investments and Time Reporting Period job to delete the relevant investments.
Before you mark an investment for deletion ensure that:
  • The financial status of the investment is set to Closed to prevent new transactions.
  • The investment status is set to Inactive.
  • No process instances are currently running on the investment.
You need to have the <investment> - Delete - All global access right and “Edit” access rights for investments that you want to mark for deletion. The following access rights have been introduced in this release to facilitate the deletion of investments from Clarity.
  • <Custom Investment> - Delete - All
  • Idea - Delete - All
The Mark for Deletion option is specific to Clarity. This functionality does not impact the Mark for Deletion option in Classic PPM.
Key Points to Remember
  • Any user with 'Delete – All (Global)' and 'Edit' access for Custom Investments, Ideas, or Projects, will have the ability to use the Mark for Deletion option.
  • When the 'Delete Investments and Time Reporting Periods' job is run, the system will delete the investment and all related data.
  • If an Investment has timesheet actuals and the
    Project Management
    llow Marked Investments with Timesheet and Transaction Data to be Deleted
    checkbox is NOT selected, you will see a message indicating that the investment cannot be marked for deletion.
To learn more about deleting investments, see Close, Deactivate, and Delete Projects and Investments.
Upgrade Impact
: No Impact. After you upgrade to this release, you will be able to mark investments for deletion.
Enhancements to Roadmaps

The Roadmaps functionality has been enhanced to leverage the Board, Grid, and Timeline layouts utilized throughout Clarity. Roadmaps leverage the Clarity common grid to ensure you can use functionality like filter, search, saved views, DETAILS panel, support for custom attributes, and export to CSV. The Board view now allows the user to configure additional content to be displayed on the Board Card and save the information to a view. The Timeline view layout now includes the DETAILS panel which allows you to easily edit roadmap items.
Upgrade Impact
: Some key points to remember when you upgrade to this release are:
  • Users can select their own Start Period and End Period by using View Options. This will help them view roadmap items beyond the duration of the roadmap.
  • The Scenario comparison option is not available in this release.
  • The search option has been enhanced so that you can locate any attribute associated with roadmap items.
  • All three layouts include the DETAILS layout to help users edit roadmap items.
  • You can select calculated number attributes as metrics in the Timeline layout and as Targets in the Grid.
  • Clarity roadmaps now support TSVs.
  • The Roadmaps grid has been enhanced to display per-period metrics.
  • Users cannot search or configure TSV’s in the DETAILS panel
  • Roadmaps now support Global Settings (Hours, Days, FTE). The only exception is when you specify a target. Since that value you define is not an attribute in Clarity, it will not automatically be updated based on your setting.
To learn more about roadmaps, see Clarity: Top-Down Planning with Roadmaps.
Key Points to Remember
  • Large String - Rich Text attributes will now synchronize to Roadmap Items from linked Investments
  • The Roadmap grid now includes the Add Row icon enabling users to create Roadmaps with required fields.
  • The New Roadmap pop-over does not support the “required field” flow. If you attempt to create a new Roadmap that has required fields, and the required fields are not visible in the New Roadmap pop-over, the user will not be able to create a new Roadmap and is presented with a toaster message. Users can use the Add Row icon to create a new Roadmap in order to populate required fields.
Expanding the Capability of To Do's

Clarity allows you to create to-do items for a phase, a milestone, for a task to break down the work into smaller activities. The new To Dos page displays all the To Dos assigned to you across various investment types in Clarity.
Clarity has introduced the following global access rights in this release:
  • To Do - Navigate
  • To Do - Create - All
  • To Do - Delete - All
  • To Do - Edit - All
  • To Do - View - All
These access rights are assigned to the Viewer license type in Clarity.
Upgrade Impact
: After upgrading to this release of Clarity, you will need to assign users the appropriate To Do access rights.
  • In previous versions, users did not need any additional rights to access To Dos. After you upgrade, you will need to assign the relevant To Do global create, delete, edit and view access rights to users. This will ensure users can access To Dos, in the Tasks details panel, without experiencing any errors.
  • To have users access the new To Do workspace you will need to assign the To Do - Navigate access right along with the other new To Do global rights.
  • The To Do's Scorecard has been deprecated and is not available in this release.
Key Points to Remember:
  • To Dos are implemented as a Studio Object but cannot be leveraged in Classic PPM.
  • The To Dos Object is not enabled for use with BPM processes.
  • The Data Warehouse uses the new To Dos tables.
  • To Dos stock attributes are Name, ID, Owner, Due Date, and Completed
    • The To Dos ID field supports auto-numbering
    • To Dos do not support the ability to create Sub-Objects.
  • The To Dos Due Date has no limitations and can fall outside of an investment's Start and Finish Dates.
  • When a To Dos is copied over from a template, Clarity populates the To Dos Due Date with whatever is in the Due Date field (e.g., blank or actual) prior to copy.
To learn more about the new To Do's page, see Clarity: Track and Edit To Dos
Business Rules for Investments and Custom Master Objects

Administrators can create business rules Clarity Blueprints to control the modules or sections displayed to end-users. Let’s consider an example where the administrator wants to show the Executive Summary section on the Properties module only when the following conditions are met:
  • The user is a member of the PMO portfolio manager group The
  • ROI is greater than 200%
  • The Corporate Priority is high
  • The project is active
In such scenarios, administrators can leverage business rules to achieve this outcome.
When you create a business rule, you define:
  • Conditions
  • Actions
  • Action Targets
Upgrade Impact
: No Impact. You can start using the Business Rules functionality after upgrading to this release.
Key Points to Remember
  • Business rules are not a replacement for security rights.
  • Attributes hidden, as part of rules hiding sections, can still be viewed in the object grid view.
  • Business rules do not control the “Detail” fly-out display as those are defined by individual users.
  • Rules will not be applied to the blueprint till they are enabled.
  • Rules are part of the blueprint and cannot be moved between environments as they do not have blueprint API or XOG support.
  • If the rule does not have at least one condition and one action defined, the rule cannot be enabled.
  • Incomplete rules can be saved but not enabled.
  • Rules cannot use the attachment, RTF, Money, and URL attributes for conditions.
  • If a section or module used in a rule is deleted, and that rule only had an action related to that section or module, then the rule will automatically be disabled if you open the rule
To learn about business rules, see Clarity: Configure Blueprints for Projects.
Customer Requested Enhancements

Inactive Departments Hidden from OBS and Department Lookups
Classic PPM now has the Active attribute with the Department OBS. In certain scenarios, where your organization changes its departments, you can set clear the Active checkbox associated with the department to hide it in Classic PPM and Clarity. You can still see the inactive departments for existing investments. However, when you browse to select a new OBS, the inactive departments will not be available.
Upgrade Impact
: After upgrade to Clarity 15.9.2, all existing departments will have their “Active” flag set to true. You can then clear the Active flag associated with departments you want to hide. Also, te new “Active” flag in departments is added to the object but not to the views. After upgrade customers will need to manually add that flag to their “Department Properties” and “Department List” views before setting the value.
Key Points to Remember:
  • Setting the new flag controls if the department will be displayed in the following lookups:
    • Department Lookup
    • Department OBS
    • Department
    • Resource OBS
    • Staffing Workspace
    • Staff OBS Unit in Project Staff Module
  • Department XOG has been updated to use the new “Active” flag
  • Deactivated departments will still be displayed where they were populated.
  • The deactivated department cannot be set for existing or new object instances.
Multi-Select Update Available for Grid Layout
You can edit multiple records on the Grid layout. When you select multiple records and click the Edit button, a bulk edit window will be displayed. The window includes all the fields that were displayed in the grid. You can update the relevant fields and click Save to commit your changes. In case, certain fields cannot be updated due to internal business rules, those changes would be ignored.
  • Attachment fields cannot be changed during bulk edit.
  • The starred fields cannot be edited by using bulk edit.
  • If the grid has Group-By mode enabled, the multi-select bulk edit mode is not enabled.
  • The Attribute grid used to configure field-level security does not support the multi-select feature.
Upgrade Impact:
No impact. You can upgrade to this release and start using the Bulk Edit capability.
To learn more about Clarity grids, see Common Components
The Links Module is now available for Ideas. Users can now add links to the idea or create a new category and add links specific to that category. To learn more about editing blueprints for ideas, see Clarity: Configure Blueprints for Ideas.
Upgrade Impact
: When you upgrade to the latest release, the Standard and custom blueprints will automatically include the Links module. The Links module in Ideas works exactly the same as “Custom Investment Type” links and does not support any parameters.
  • If you want to hide this module from the Standard Blueprint for Ideas, you can leverage the Business Rules functionality.
  • If you want to remove the module from custom blueprints, you can edit the blueprint and remove the module so that it is not visible to the end-user
Delete Permissions Separated from Edit Permissions
You can now segregate delete permissions from edit permissions. Every object now has the following new rights available:
  • Global Delete All
  • OBS Delete
  • Instance Delete
Now when a user creates a new object instance, they will not be able to delete it without the delete access rights.
Upgrade Impact
: When you upgrade to the latest release, Clarity will grant delete rights to all users who currently have edit rights to an object. When you grant a user the delete right, Clarity will not give users view or edit permissions.
API Alias Attribute Added to the Field-Level Security Grid
Customers wanted more information about attributes when enabling field-level security. Error message in Clarity displays API attribute ID which could only be seen in Classic PPM.
Attributes only showed “Attribute ID” which is not the same as the API ID assigned to the attribute. From Clarity 15.9.2 onwards, customers can easily view and configure field-level security based on API attribute ID.
Upgrade Impact
: No impact. When you upgrade to the latest release of Clarity, you will be able to see API Attribute ID on the Attributes grid.
Create Project from Template

Clarity has introduced the ability to define the create screen when creating a project from a template. This will force users to populate required fields when creating a project from a template. A new “Create from Template" configuration module has been added to the “Project” blueprint. Every project blueprint will have the ability to define which fields are displayed to the user when they create a new project using that blueprint.
When you convert an idea to a project, Clarity will now use the new “Create from Template” modal based on the blueprint assigned to the selected template. Three additional options are displayed to copy team, financials, or Risks, Issues, and Changes.
Upgrade Impact
: No impact. This feature will be available to you when you upgrade to the Clarity 15.9.2 release.
Key Points to Remember:
  • Any studio-defined required fields, not included in the “Create from Template”, will automatically be added to the create modal if the attribute does not have a default value. Attributes will be displayed alphabetically based on the name.
  • Required fields will have default value populated in the create screen based on the following logic:
    1. Value from the project template
    2. If the template does not have value populated then display the value from the studio definition
    3. Display null value if no value is found in the template or studio.
Data Warehouse Enhancements

Data warehouse and Reports Include New Functionality Offered by Roadmaps
The Data warehouse table dwh_rdm_item_position has been renamed to dwh_rdm_picklist_position. The dwh_rdm_item_position name will not be available. All the other Data warehouse tables for roadmaps will remain the same.
In the Roadmap report, the Swimlane and the Color By input controls now include custom attributes. The list and the board options in Clarity are also included. The previous default items namely Type, Status, and In Plan are now available by default. However, you can still select them in Board Options if needed.
Add Picklists Available in Investments for Data Warehouse
The DWH_INV_PICKLIST table is now a lookup table for picklists. The object_code_key column includes the investment associated with the picklist. DWH_INV_PICKLIST_POSITION table carries the investment association.
Risks, Issues, and Changes (RICs) are Captured at Investment Level
All the investment objects in Clarity (Projects, Ideas, Custom Investments) now support Risk, Issues, and Changes. To help drive this change, Clarity now includes a new calculated attribute Risk Score in this release. The Risk attribute is still available and continues to be a Formula attribute. However, when customers update the RICs, Clarity will now use the Risk Score attribute when it saves the information in the Data warehouse.
The Risk Attribute has been replaced with the Risk Score attribute in all existing project management reports. Clarity also has a new view to help existing customers adopt the Risk Score attribute.
The following new reports have been created to help report developers capture RICs for all investments:
  • Investment Risk Register
  • Investment Issue Register
  • Investment Change Request Register
  • Investment Risk, Issue, and Change Summary
Upgrade Impact
: The Risk attribute is still available in the PMO accelerator. Customers using in attribute in Classic PPM can continue to do so in this release. If customers want to start using the Risk Score attribute, they can upgrade the PMO accelerator. New customers will use the Risk Score attribute.
Tables to Store To Dos Updated in the Data Warehouse
In previous releases, Clarity used the dwh_inv_todo table to store all the information about To-Dos. In Clarity 15.9.2 and higher releases the dwh_cmn_todo table stores all the To-Dos. The assoc_object_key is used to link to the parent. When you run the Data warehouse and if you have any To-Do items that need to be translated, Clarity will create the dwh_cmn_todo_In table.
Customers can use the dwh_inv_task_v view for tasks.
Upgrade Impact
: When you upgrade to this release of Clarity, all the information in the dwh_inv_todo table would be copied to the dwh_cmn_todo table. The dwh_inv_todo table will not be deprecated but will not store any information.
Enhancements to Hierarchies

The BETA tag is no longer applicable to Hierarchies. The following features have been added to this release:
OBS Security Added to Hierarchies
Hierarchies now support OBS security. You can associate a hierarchy with an OBS to ensure you take advantage of the existing OBS framework when assigning rights for the hierarchy. To learn more about hierarchies, see Clarity: Create and Edit Hierarchies.
Upgrade Impact
: When you upgrade to this release, Clarity will automatically
delete all existing saved views for hierarchies
Configure Blueprints with Channels for Hierarchies
As an application administrator or PMO content designer, you can use blueprints to configure layouts for hierarchies. You can copy and configure blueprints that reflect the goals of each business unit in your organization. Let's consider an example where multiple product management teams in the organization are using hierarchies to achieve different business outcomes. They have created multiple custom attributes. Some attributes are relevant to the New Banking Application Product Management team while others are relevant to the Next-Gen AI team. The administrator can create different blueprints for these teams so each team would only see information relevant to them.
In this release, the Hierarchies blueprint includes the Investments and the Properties modules. Both modules will automatically be included in your blueprint. You can also create channels to embed content from another source, such as an external site, application, or Classic PPM context-sensitive investment reports into hierarchies.
To learn more about blueprints, see Clarity: Hierarchy Blueprints.
Upgrade Impact
: When you upgrade to this release, Clarity will automatically
delete all existing saved views for hierarchies
Assign Different Colors to Various Investment Types
In previous releases of Clarity, you could select a single custom or stock lookup attribute to select the color of all investment cards in the hierarchy. In this release of Clarity, you can select different attributes for different investment types that are available in your hierarchy. You can select fields from both the abstract investment object and the concrete objects (projects, ideas, and custom investments). To learn more about setting colors for investment cards, see Clarity: Create and Edit Hierarchies.
Upgrade Impact
: You can now color investment cards based on different attributes for different investments. In previous releases, you could select a single custom or stock lookup attribute to select the color of all investment cards in the hierarchy. When you upgrade to this release, Clarity will automatically
delete all existing saved views for hierarchies
Import Child Cards Directly from Parent Card
You can select an investment card, right-click, and use the Import Children option to import multiple investments as children. To learn more about importing investments in hierarchies, see Clarity: Create and Edit Hierarchies.
Upgrade Impact
: When you upgrade to this release, Clarity will automatically
delete all existing saved views for hierarchies
Configure Hierarchy Cards and Metrics Using Project, Idea, and Custom Investment Fields
In the previous release, fields that were a part of the abstract investment object were available for selection in hierarchies. In this release, you can select fields associated with the concrete investment object (project, ideas, custom investments) to displayed on investment cards. You can also use the various metrics available with concrete investment objects to create custom metrics for Hierarchies. To learn more about setting metrics for investment cards, see Clarity: Create and Edit Hierarchies.
Upgrade Impact
: When you upgrade to this release, Clarity will automatically
delete all existing saved views for hierarchies
Enhancements to Custom Metrics
There have been multiple updates made to custom metrics for Hierarchies.
  • In previous releases of Clarity, you could not view the calculations of custom metrics after you created them. In this release, you can click the Edit icon associated with a metric to view its definition.
  • You can only create or delete a custom metric only when you have the Hierarchy - Manage Metrics global right. If you don’t have this access right, you will see an error message when you try to access the MANAGE METRICS dialog.
  • The Aggregation and Calculation metrics are now available in two separate tabs to provide a better user experience.
  • The custom metrics are now available under the Hierarchical category in the filter on the cross-object grid. The metrics are also available in the Column picker under the Hierarchical category in the Cross-Object grid.
Upgrade Impact
: Hierarchy users will lose their ability to create hierarchy metrics that they previously had unless they have the "Hierarchy - Manage Metrics" access right. Also, when you upgrade to this release, Clarity will automatically
delete all existing saved views for hierarchies
To learn more about custom metrics, see Clarity: Create and Edit Hierarchies.
Analyze Hierarchies By Using the Cross-Object Investment Grid
The Cross-Object Investment Grid for hierarchies includes two key updates:
  • The Parent and Level columns are available in the Hierarchies gird. You can add these columns to the grid to see how the investments are related to each other.
  • You can view the custom metrics in the cross-object investment grid. In the previous release, custom metrics were only visible in the Manage Metrics window on the Hierarchy tab.
To learn about the Cross-Object Investment Grid, see Clarity: Create and Edit Hierarchies.
Upgrade Impact
: When you upgrade to this release, Clarity will automatically
delete all existing saved views for hierarchies
Applying Field-Level Security for Hierarchies
You now have the following capabilities for using field-level security with hierarchies.
  • Field-level security is now applicable in hierarchies.
  • You can now secure fields associated with the hierarchy object by using the Field Level Security grid
  • You can secure attributes associated with the abstract financial object. Consider a scenario where you want to secure the Planned Cost attribute. Since this attribute is available for the abstract financial object and concrete investment object (Project, Ideas, Custom Investments), you need to:
    • Secure it as the abstract investment object level (Investment Abstract object and Financial Abstract object)
    • Secure it for individual concrete investment objects (Projects, Ideas, Custom Investments)
      If you secure Planned Cost for the abstract financial object and projects but don't secure it for ideas, you will see the Planned Cost for ideas in the cross-object grid in hierarchies.
Field-level security does not apply to custom metrics. If you secure the planned cost field and then create an aggregation metric named Aggregated Planned Cost, the aggregation metric cannot be secured by using field-level security.
To learn about the Cross-Object Investment Grid, see Clarity: Create and Edit Hierarchies.
Upgrade Impact
: When you upgrade to this release, Clarity will automatically
delete all existing saved views for hierarchies
Display Messages When Users Log Into Clarity

Administrators can now display messages to users when they log into Clarity. Administrators can use the System Settings section on the Administration page to configure the message and associated settings.
To learn more see, Clarity: System Settings.
Upgrade Impact
: No impact. You can start using this feature after you upgrade to Clarity 15.9.2.
Key Points to Remember
  • The Login message will not appear if users are using SSO to log into Clarity.
  • Clarity does not support multiple languages for the login message.
Introducing Pages

Administrators can now define a collection of pages in Clarity. It provides a single place to access desired Clarity or external application pages without being inside an object instance. This allows customers to leverage the Channel functionality outside the object instance. Administrators can define blueprints for pages.
To learn more about pages, see Clarity: Working with Pages and Clarity: Pages Blueprints.
Key Points to Remember:
  • Classic PPM includes the new studio object called “Page”.
    • Includes Instance, Global, and OBS access rights
  • Attributes in Page can be secured using Field Level Security.
  • Pages cannot be seen in Classic PPM.
  • You cannot define sub-objects for the Page object
  • Channels within a blueprint are limited to the same governor limit of 15.
  • In Classic PPM the “Page” object has the event enable flag. This is standard object configuration, but processes will not be supported with the Page object.
  • When setting security you will see two “Page” objects listed. One refers to the Classic PPM portlet page, and the other to the Clarity page. The description for the Clarity page will list “new user experience”.
Upgrade Impact:
Administrators need to assign the Page – Navigate access right to users so that they can leverage this functionality.
Time Slicing Group By Job Renamed to Time Slicing Sync
Time Slicing Group By Job has been renamed to Time Slicing Sync in this release. The job and the associated SQL Curve per-period metrics are now available for Clarity SaaS customers. To learn more about this job, see Clarity Jobs Reference.
Known Issues
DE59825 - Unable to Add a New Row in Grid When Attachment Attributes are Marked Required
Steps to Reproduce:
  1. Log in to Classic PPM and create an attachment attribute.
  2. Mark the attachment as required.
  3. Navigate to Clarity and add the attachment to the grid.
  4. Click the Add Row button.
Expected Results: New row gets added after filling all the required fields.
Actual Results: API error is displayed and a new row is not added.
DE60865 - Error while creating a cost plan detail row with TSV values entered first
Steps to Reproduce:
  1. Create a project with a valid department.
  2. Go to the financials module within the project in Clarity.
  3. Create a cost plan.
  4. Create a cost plan detail row. Enter values for the TSV before entering values for the grouping attributes.
Scenario 1: User creates a cost plan detail row and starts entering the grouping attributes values. As soon as all the grouping attribute values are entered, the cost plan detail record is created. The cost (tsv) always goes through the Update request here.
Scenario 2: User creates a cost plan detail row and starts entering the tsv values first and then grouping attributes values. As soon as all the grouping attribute values are entered, the request to create a cost plan detail record is sent. This is when the user runs into this issue.
Expected Results: Cost plan detail gets created.
Actual Results: Attribute(s) [cost] are not supported for this action.
Workaround: Enter values in the 'grouping' fields first so the record can be created before entering per-period metric values.
DE60518 - Bulk Edit - Preview Doesn't Show Updated Totals on Editing TSV Values
Steps to Reproduce:
  1. Navigate to Staff grid for an investment. From view options make sure Totals column is selected as Sum of Periods.
  2. Select any 2 resources and click on Edit (Bulk Edit).
  3. Make changes to Allocation in Totals column in Bulk Edit.
Expected Results: Value is distributed across all time periods in Preview changes.
Actual Results: Value is only reflected in Totals column and not distributed across all time periods.
DE60890 - Department OBS is Being Reset to the Default Regardless of Whether There is a Value Set
Any changes to Project attributes in both Classic PPM and Clarity are causing the Department OBS value to be reset to the default. If Financial plans are already created on the project, the following error is generated in Classic PPM and Clarity instead of the Department being changed:
Error: The department cannot be changed to a different entity after financial plans have been created.
Classic PPM: If the field is not added to the Edit View in Classic PPM, updating any Project attributes resets the Department OBS to the default whether there's already a value set or not. If the field is added to the Edit View in Classic, the issue does not happen.
Clarity: If the field is added to the Blueprint in Clarity, updating any Project attributes on the Project resets the Department OBS to the default regardless of a value being set or not.
To learn more about the issue and the workaround, see KB214524.
DE61118 - Timeline Column for Task Duration Shows an Inflated Value
Summary: The Timeline Column for Duration has inflated values as compared to the value in the DETAILS panel or on the grid.
Steps to Reproduce:
  1. Navigate to the Project Timeline.
  2. Click the '+' button to create a new task in a Project.
  3. In the DETAILS panel, update the dates for this task. Set the Start date to Monday, May 3, 2021, and the Finish date to Friday, May 28, 2021. The Duration column will show 20 workdays as expected based on the calendar.
  4. Navigate to the Tasks Grid. Add the Duration field to the grid layout. The duration remains at 20 as expected.
  5. Navigate back to the Tasks Timeline and review the Duration Column.
Expected Results: The value of the Duration field in the Timeline Column cell should equal 20 days.
Actual Results: The value of the Duration field is 25 days.
To learn more about the issue and the workaround, see KB214524.
DE60991 - Unable to Create Risks for Idea, Projects, and Custom Investments after Upgrade to Clarity 15.9.2
Summary: After upgrade to Clarity 15.9.2, you are unable to create Risks for Idea, Projects, and Custom Investments. It shows a system error.
Steps to Reproduce:
  1. Login to MUX and navigate to Ideas.
  2. Create a new Idea or use one of the existing Ideas.
  3. Click Risks and then attempt to create a risk. Please check the error message and contact your System Administrator.
The same issue occurs while creating the Risks from Projects and Custom Investments. Also, it occurs while creating risks from Projects in Classic PPM.
Expected Results: You should be able to create Risks successfully.
Actual Results: You are unable to create a Risk and get an error message.
To learn more about the issue and the workaround, see KB215960.
DE61039 - System Actions in Processes Erroring Based on Custom Investments After Upgrade to Clarity 15.9.2
Steps to Reproduce:
  1. Login as Administrator.
  2. Create a simple process based on the Custom Investments (For Example: Create Event). Observe the same issue while updating the event as well.
  3. Add system action to Start (For Example: Updating Blueprint or Name).
  4. Validate the process.
  5. Create the Custom Investment and observe the process failed.
Expected Results: The process completes successfully.
Actual Results: The process error occurs - BPM-0522: Internal Process Engine Error. Please contact your Site Administrator (Error executing action).
To learn more about the issue and the workaround, see KB215668
DE61039 - Remove Job Logs in PostgreSQL Is Failing on Clarity 15.9.2
Summary: Clarity 15.9.2 (PostgreSQL) Remove Job Logs and Report Library Entries Job are failing in both scheduled and manual runs with the failure message (NJS-0401: Execution of job failed).
Steps to Reproduce:
  1. Navigate to Home, Jobs, Scheduled Jobs.
  2. Run Remove Job Logs and Report Library Entries Job. Set the parameters: 1 for Jobs and 1 for Reports
Expected Results: The job completes or removes the entries from Jobs - Log and the immediate entries from Jobs - Scheduled Jobs.
Actual Results: Job fails with the failure message - NJS-0401: Execution of job failed.
The stored procedure
is missing on PostgreSQL. However, this stored procedure is available on Oracle or MSSQL
To learn more about the issue and the workaround, see KB215839
Resolved Defects
To view, the customer reported defects that are resolved in
, see the
Resolved Issues list.
Third-Party Software Agreements
uses third-party software that is in accordance with the terms and conditions for use, reproduction, and distribution as defined by the applicable license agreements.
View the
TPSR list
and download the
15.9.2 TPSR's
to read the license agreements.