Clarity
15.9.0
Release Notes

ccppmop159
HID_release_info_rel_notes_op
The Release Notes provide release-specific information such as new features, enhancements to an existing feature, fixed issues, and known issues. Release Notes help you plan for a new installation or upgrade to the on-premise or SaaS edition of
Clarity
.
To learn how the feature might impact your upgrade from an earlier release, see the Change Impact and Upgrade Guide.
2
Clarity
User Interface Enhancements

Select Favorite Object Instances (On-Premise Only)

You can now mark various object instances as your favorite by associating a star against them. This allows you to easily flag and find instances that require extra monitoring or attention. You can mark an instance as a favorite by adding the Starred attribute to the Grid layout or to the Details panel in
Clarity
.
Fav.png
You can mark the following object instances as a favorite:
  • Project
  • Ideas
  • Custom Investment Type
  • Roadmap
  • Hierarchies
  • Custom Object
Some other actions you can perform with Starred instances are:
  • Filter for Starred instances
  • Save a view with starred object instances
  • Import Starred Object instances into Hierarchies and Roadmaps
The "Favorites" feature is currently not available out-of-the-box for on-premise and SaaS
Clarity
customers. After upgrading to
Clarity
15.9, some of our SaaS customers reported issues related to this feature. With this in mind, the Favorites feature has been disabled for
Clarity
SaaS customers. While the feature is available in
Clarity
15.9, it has been hidden in
Clarity
15.9 Patch 1 for on-premise customers. Please contact the Broadcom Support team if you want to enable this feature in your environment.
  • You do not need "Edit" rights to set an object instance as a favorite.
  • The Starred attribute is not available in the object definition in
    Classic PPM
    . You cannot modify it.
  • You need to manually add the Starred attribute to the grid layout, or Details panel.
  • You can mark an object instance as a favorite only for top-level objects. This functionality is not available for sub-objects such as Tasks.
  • If you mark an object instance as a favorite, only you will be able to see the star associated with it. The star will not be visible to other users.
  • The location of the Starred attribute in the column panel and the filter is not sorted correctly. This is a known issue and will be fixed in future releases.
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, you can add the Starred attribute to the Clarity grid from the column panel and start marking your favorite object instances.
To learn more, see Common Components
Customize the Theme Colors
You can customize the background color and the foreground colors to reflect your organization’s branding. You can also use it to differentiate between various environments, such as development, QA, and production.
Theme.png
Clarity
supports the following CSS color formats:
  • HEX
  • RGB
  • HSL
  • You can also type in the color name
You can also select the light or dark color scheme for menu icons, text, and login logo.
 
Clarity
does not support the CMYK, HSV, and NCol CSS color formats.
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, you can customize the background color and the foreground colors to reflect your organization’s branding.
To learn more, see Clarity: System Settings
Quick Save Functionality for Views
The Quick Save functionality allows you to save changes to your view in a single click. Consider a scenario, where you opened a High Priority view on the Ideas page. The view shows all ideas grouped by priority and sorted by ROI. You have now added the Starred attribute to the grid and selected a few favorite ideas. You can simply click the Save button to save your changes to the view.
SV.png
If you are not the owner of the view that is loaded for you, you will see the view name as “(copy) saved view name”. When you make changes, your view name will change to "Unsaved copy saved view name". You can now save your view whenever you are ready.
Upgrade Action:
In previous releases of
Clarity
, you would need to open the view selector, select the view, and finally save your changes. You can use the Quick Save functionality in
Clarity
15.9.0
to save your view in a single click.
To learn more, see Common Components
Enhancing the Drop-Down Component
The drop-down component for
Clarity
has been enhanced. It will now dynamically display a drop-up or a drop-down list depending on the length of the list and the area available on the screen. This enhancement makes it vastly easier for you to select and view options.
DropDown
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, you dynamically see a drop-up or a drop-down list depending on the length of the list and the area available on the screen.
Logical OR Available for Filters
Clarity
now allows you to use the logical OR filter to quickly identify relevant records. In previous releases, you could only use the AND filter when you filtered using multiple attributes.  From this release, you can use Match All (AND) or Match Any (OR) options to filter various records. Consider an example where you want to identify all ideas that have the Priority set to high or have the Planned ROI between 100% to 400%. In such scenarios, you can select the Priority and Planned ROI attributes in the filter and use the
Match Any
option. You will see the relevant ideas that match this criterion.
OR
Upgrade Action:
In previous releases, the logical OR was not available for filters. When you upgrade to
Clarity
15.9.0
, you can start using the logical OR filter to identify relevant records and create new views.
To learn more, see Common Components
Enhancements to the Date Data Type
Clarity
now supports localized date formats based on the following factors:
  • Option selected by the user in the Settings page
  • Locale specified for the user
Date
Example
: Janet has selected the short (8/18/20) option on the Settings page and her locale is set to UK.
Clarity
will display the date as 18/8/2020. If you change the locale to the United States,
Clarity
will then display 8/18/2020. If you update the locale to Japan,
Clarity
will display 2020/8/18. You can also enter the date directly in the grid by using space, forward slash, a hyphen, and period as separators. You can also enter single digits or mixed digits. The data entry format will be validated based on your locale. If you do not use a locale-appropriate format, the error is highlighted with a red border around the cell.  For example, if your locale is set to UK, you cannot enter the date as, 8/18/2020.
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, the new date option will be available to you.
Inactive Indicator for Investments
When you mark an investment as inactive,
Clarity
will display an Inactive indicator next to the investment name.
Inactive
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, you can view the Inactive indicator next to the investments that are inactive.
Timesheet Usability Enhancement – Submit Button
In some cases, customers have reported that users are inadvertently creating and submitting their timesheets with no data, causing unnecessary administrative effort. The Submit button has been removed from the Create Timesheet page and is no longer available. Users can only submit a timesheet after they have populated it.
Inactive
Upgrade Action:
In previous releases of
Clarity
, the Submit button is available on the Create Timesheet page. When you upgrade to
Clarity
15.9.0
, the Submit button will no longer be available on this page. You can only submit a timesheet after you have populated it.
Support for Additional Attributes

Support for Attachment Attributes in
Clarity
You can now manage the attachment attributes of stock and custom objects in
Clarity
. Previously, the attachment attributes were only available in
Classic PPM
. This enhancement allows you to use
Clarity
for processes that require uploading documents to an attribute. With this enhancement, you can API enable the attachment attributes and make them available in
Clarity
Once the attribute is API enabled, you can do the following:
  • Configure the attachment attribute to be displayed in the Details panel of the Timeline, Board, and Grid layouts.
  • Configure the blueprint of the corresponding object to display the attachment attribute on the Properties page.
  • View, upload, and delete attachments in the Details panel or in the Properties page.
Attach
  • This enhancement is not supported for objects that do not have the Details panel or Properties page. For example, Roadmap Items and Cross-Project Tasks. Use
    Classic PPM
    to manage the attachment attributes for these objects.
  • The attachment attribute cannot be added to the grid in the Grid Layout or to the cards in the Board Layout. Use the Details panel or the Properties page to view, upload, or delete attachments.
  • Just like in
    Classic PPM
    , multiple files cannot be uploaded in one go, when uploading files to an attribute that supports multiple documents. Upload one file at-a-time.
  • When you create an instance (such as a Project or Idea) from the Board layout in
    Clarity
    , the attachment attributes appear disabled until all the mandatory fields are filled out.
Upgrade Action:
After you upgrade to
Clarity
15.9.0
, you need to API enable the various attachment attributes that you want to display in
Clarity
. For more information, see API Enable Custom Attributes.
To learn more, see Attachment Attribute.
Clarity
OBS Display Enhancements
Clarity
Uses Slash as OBS Delimiter
Clarity
now uses a slash ( / ) as an OBS unit separator. In the previous releases of
Clarity
, you would use the greater than symbol ( > ) as the OBS unit separator. This change allows you to use the slash symbol in filters to search for specific OBS units.
Clarity
Grid Now Shows the Complete OBS
The
Clarity
Grid now shows the complete OBS value. You can either expand the column or use the tooltip to view the complete OBS value.
OBS
You will need to expand the Details panel to view the full OBS path. You can also click
Configure
and expand the OBS field length to be wide enough to display the full OBS path.
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, you will see all these improvements in the product.
Cost Plans and Budgets Enhancements - Total Units and Total Revenue
The “Total Units” and “Total Revenue” attributes are available out-of-the-box in the Financials module, Cost Plans, and Budgets pages. The attributes are available in the grid, the Details layout, and the filter for Projects, Ideas, and Custom Investments.
Total
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, these attributes will be available in
Clarity
.
Task Enhancements – Guidelines
The “Guidelines” field is available out-of-the-box in the Task module for Projects and Custom Investments. The attributes are available in the grid, the Details layout, and the filter. Project managers typically use guidelines to provide additional information to assist users with their immediate tasks.
Total
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, the Guidelines attributes will be available.
Common Grids Usability Improvements

Multi-Select Delete Now Available in
Clarity
Common Grids
You can use the Bulk Delete capability in the Common Grid to delete multiple records. Consider a scenario where you have created a project from a template and want to delete specific tasks that were created. You can now select multiple tasks and use the Delete button to delete all the tasks. If you select more than one record,
Clarity
will prompt you to confirm your action before deleting the records.
Total
  • This capability is not available at an instance-level. Hence, you cannot bulk delete multiple projects, ideas, custom investments or custom objects. However, once you navigate to the Staff, Tasks, or other modules within an investment, you can select multiple records and delete them.
  • Clarity
    business logic will supersede the delete request wherever applicable. For example,
    Clarity
    will not delete a task that has actuals associated with it.
  • You cannot use the Bulk Delete options in the following grids:
    • Cost Plans (single delete only)
    • Cost Plan Details (single delete only)
    • Budgets (not allowed)
    • Budgets Plan Details (not allowed)
    • Status Report Grid (Project Sub-Object)
    • Cross Project Task Grid
    • Staffing Workspace
    • Roadmap Items
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, the Bulk Delete capability will be available.
To learn more, see Common Components
Assign Tasks By Using the Details Panel on Tasks Module
You can now assign resources, teams, or roles to a task by using the Assignments tab on the Details Panel of the Tasks Module. The Assignments tab provides you all the functionalities that you get with the Assignments module. Hence, you can manage task assignments, perform resource and role planning, and monitor estimated-to-complete (ETC) values for your team members. You can click
Expand
to use some key capabilities of the common grid such as Views, Group-by, Filter, and Export to CSV.
  • If a Task, such as Phase, does not support Assignments, you will see the "This Task type does not support assignments" message when you navigate to the Assignments tab.
  • Actions are not supported for Milestone or Summary Tasks.
  • All grid configuration changes made from the Assignments grid on the Details panel are reflected in the Assignments module.
  • All grid configuration changes made from the Assignments module are reflected in the Assignments grid on the Details panel.
  • The views in the Assignments Module and in the Assignments grid on the Details panel are independent. If you create a view on the Assignments module, it will not be available in the Assignments grid on the Details panel. Similarly, if you create a view on the Assignments grid on the Details panel, it will not be available in the Assignments module.
Group
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, the Assignments tab includes the grid that is available with the Assignments module. In previous releases of
Clarity
, the Assignments tab had a drop-down list that was used to assign a task to a resource, role, or team.
Enhancements to Group By Mode
If you group the columns in the grid by a specific attribute and update the dimensions of various columns, your changes will be saved when you save the view in
Clarity
. This was not the case in previous releases. Also, your configuration changes will persist if you navigate from the grid and return – prior to saving the view.
Group
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, the enhancements to Group By Mode capability will be available.
Fiscal Period Column Headings Have Colors
All common grid column headers configured to display per-period (e.g., TSV) data are assigned a unique color to improve visibility and readability. This enhancement will help you distinguish per period metrics (TSV’s) from each other. The applied column heading color does not have a specific meaning since an attribute is not mapped to a specific color.
  • The following grids support color-coded per-period metrics (TSV’s):
    • Staff module
    • Assignments module
    • Cost Plan Details
    • Budget Plan Details
    • Benefit Plan Details
  • Clarity
    assigns colors to each column header in the order the metric fields are selected from View Options. The same colors, for each selected per-period metric, will also be visible in the column configuration panel.
Group
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, your existing fiscal period column headings will now have colors.
Custom Object Enhancements

Details Module Renamed to Properties Module
The “Details” module in the blueprint has been renamed to “Properties” in the blueprint. This change helps you distinguish between the Details panel in the grid and board layout. In the custom object grid view, the object instance information tab will still be called “Details”. Opening the object instance will display the “Properties” module.
Group
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, the Details module for all your investments will be renamed as the Properties module.
Custom Sub Objects Available in Details Panel
You can configure
Clarity
to display custom sub-objects in the Details panel. This allows you to review, edit, and analyze data associated with custom sub-objects in the Details panel. Consider a scenario where a customer uses
Clarity
to manage projects and products. They have created a custom object named Vendors to capture details associated with vendors for products. They have also created two sub-objects to capture data related to Distribution Location and Purchase Order. These sub-objects are available as modules in the Blueprint associated with the Vendor object. You can view the sub-objects in the Details panel by using the
Show in Details Flyout
option.
Group
You can view the sub-objects in the Details panel by performing the following steps:
  1. Ensure that the custom sub-object is API enabled.
  2. Create a copy of the Custom Object blueprint and edit it.
  3. Add the sub-object as a module and select the
    Show in Details
    checkbox.
  4. Associate the new blueprint with the record.
  5. Navigate to the custom object and select a record.
  6. Open the Details panel and navigate to the sub-object module.
  7. Edit details by using the grid layout.
  • The tabs in the Details panel now have names instead of icons to distinguish between various sub-objects.
  • The tabs in the Details panel now have a scroll so that you can navigate between various sub-objects.
    Group
  • Sub-objects share the grid between module and Details panel.
  • The Grid View layout defined in the module will be reflected in the details panel. Any changes you make in the Details panel will also be reflected in the grid.
  • Sub-objects in the Details panel cannot have their own panel.
  • You can expand and close the sub-object to have a larger viewing area.
  • The state of the Details panel is retained till the user changes it.
    Clarity
    persists the state even if the user logs out.
  • The tab selected with the Details panel is also retained.
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, you can API-enable custom sub-objects and use the Show in Details Flyout option to ensure they are available in the Details panel.
To learn more, see Common Components
Field-Level Security for Custom Objects
You can now secure custom object attributes by using Field-Level Security (FLS). You can leverage the
Clarity
common grid to secure attributes. Once an attribute is secure, it will have a secure icon adjacent to it. This icon is displayed in the Grid layout, the Details panel, and the Properties module.
Group
When a user with the View access right tries to edit the attribute in the grid, they will see a denial icon displayed and the field will be grayed out. Users who do not have View or Edit access, will not have an option to add the secured attribute to their view. If the user accesses a saved view where a secured attribute is included, then the view is presented without that attribute, in an unsaved state.
  • You need the Administration - Access and Attributes Management – Navigate access right to setup FLS.
  • You can assign access right only to user groups.
  • Clarity
    Business rules take precedence over FLS.
  • FLS takes precedence over Instance/OBS/Global rights.
  • Field level security is only applicable to
    Clarity
    . FLS does not impact
    Classic PPM
    .
  • You can only secure attributes whose REST API aliases are populated.
Upgrade Action:
No impact. When you upgrade to
Clarity
15.9.0
, you can use field-level security to secure custom object attributes.
To learn more, see Secure Field Level Access
Clarity
Roadmap Enhancements

Usability Enhancement – Import from PPM
When you use the Import from PPM option, to import investments from
Clarity
, they will now appear in an alphabetical list. Investments will be alphabetized by name and not ID.
Import
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, and use the Import from PPM option, investments will now appear in alphabetical order.
Synchronize Additional Attributes
Roadmap items now support the “Large String” attribute. The Matching Custom Attributes capability has been expanded to now synchronize the following attributes:
Import
  • Lookups (SVL) - (Static and Parameterized)
  • Number
  • String
  • Boolean
  • Date
  • Money
  • Large String
  • Clarity
    will synchronize additional attributes when you select the "Matching Custom Attributes“ option.
  • Clarity
    matches attributes based on API Attribute ID and type.
  • If you select the "Matching Custom Attributes" option and
    Clarity
    finds a match based on these criteria, the data will be populated from the investment to the roadmap item.
  • When you synchronize Large String attributes,
    Clarity
    will copy the data as is, including special characters and formatting.
  • When you synchronize the “Money” attribute,
    Clarity
    will copy the amount without any conversion.
  • When you synchronize the “Money” attribute,
    Clarity
    requires two pieces of information namely currency and amount.
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, and use the Import from PPM option, investments will now appear in an alphabetical list. You can also synchronize additional custom attributes.
Improvements to Hierarchies

Improved Import Capabilities
You can now import investments into Hierarchies by using the object grid. You can use existing saved views to find specific investments to import. You can also use the Details panel view to get additional details of the investment instance prior to importing it into Hierarchies.
Import
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, you will be able to import investments into Hierarchies by using the object grid.
Word Wraps in Card Names
Clarity
will wrap Card titles and display long titles properly. The level of zoom will determine the amount of title that is displayed.
Import
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, the card titles will be wrapped to display long titles properly.
Plus Icon on Bottom of Card
Investment cards with children will now display an expandable icon at the bottom. The Minus icon is displayed when the children are displayed. The Plus icon is displayed when children are hidden. No icon is displayed if a card does not have a child. When you collapse a card’s child, all the levels below it will automatically collapse.
Import
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, investment cards with children will now display an expandable icon at the bottom.
Right-click Context Menu on Cards
Right mouse click for investment cards has a context-sensitive menu. The Menu options will depend on the following factors:
Import
  • Card has children
  • Card has parents
  • Any card’s child is hidden (not just the selected card)
  • The option to delete a card is always displayed in the menu.
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, you can right-click investment cards to open a context-sensitive menu.
Open an Investment Card Item Instance (Double-click Action)
Double-clicking an investment card will open the investment instance. You will have the ability to navigate back to Hierarchies. Any changes you make to the object instance are immediately reflected when navigating back to Hierarchies.
Import
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, you can double-click investment cards to open the associated investment instance.
Improvements to the
Clarity
-
Rally
Integration
This release includes the following improvements to the Synchronization Job in
Clarity
-
Rally
Integration:
  • When a project fails to synchronize due to system-level exceptions, the Agile Integration “Synchronize” option for the project retains the configuration setting. In the previous releases, the “Synchronize” option was getting automatically unchecked for such projects and the administrator had to manually select it to enable the projects for future synchronization.
  • When a project cannot be synchronized due to system-level exceptions, the synchronization job logs an error message with the details of the impacted project and continues to process the remaining projects. Previously, the synchronization job would abort when it encountered a system-level exception
  • The integration is optimized to comply with the data limit set by
    Rally
    . This optimization helps ensure that the synchronization job does not fail due to the breach of data limit.
  • The logging enhancements to the synchronization job provides more meaningful data to help troubleshoot issues efficiently. The logs now include specific workspace details such as; Project ID, API ID, Owner ID, and so on, that help identify the problem quickly.
Upgrade Action:
After the upgrade, the improvements will be effective on your existing integration setup. 
To learn more, see Integrate
Clarity
with
Rally
REST API Enhancements
Using the
/virtual/userProfile
API, you can now retrieve the user profile information such as first name, last name, email ID, locale, and so on, of the logged-in user. For more information, see Retrieve User Profile Information using API.
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, you can start using the User Profile API.
Jaspersoft Enhancements
Added Support for New Date Format
Ad hoc Views now support a new international date format of “dd MMM YYYY”. This date format is available regardless of the user locale. The date format can be selected from the context menu in an ad-hoc view.
Import
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, the new international date format of “dd MMM YYYY" will be available to you.
Domain Designer Issue Fixed (SaaS Only)
When customers migrated from our old SaaS datacenter to GCP, their database also changed from Oracle to PostgreSQL. PostgreSQL is case-sensitive and returns database table and column names in lowercase, unlike Oracle which returned database table and column names in upper case. This issue meant that any custom domains in JasperSoft would break if the customer tried to edit it. The Doman Designer issue has been resolved in this release.
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, the domain designer issue will be resolved.
New Administration Portlets

Three new administrative portlets have been added in
Clarity
to provide details on time slices.
Import
  • Current Process Time Slice Requests: Displays any currently executing time slice jobs.
  • Time Slice Request Status: Shows the current status of all Time Slice Requests, including custom slices and internal slices.
  • Time Slice Counts: Slice count data from the past sixty runs of the job.
Upgrade Action:
When you upgrade to
Clarity
15.9.0
, the new portlets will be available to you.
Known Issues
DE58534: Manage and Save Views not working on Sub object Expand: Firefox and Safari Only
You can configure Clarity to display custom sub-objects in the Details panel. This allows you to review, edit, and analyze data associated with custom sub-objects in the Details panel. When you expand the sub-object, you will not be able to use the Manage Views and Save As options if you use the Firefox or Safari browsers. However, the Manage Views and Save As options work as expected on Chrome and Edge.
Steps to Reproduce:
  1. Log into the Clarity server by using the Firefox or Safari browsers.
  2. Select
    Administration
    ,
    Blueprints
    to open the blueprint of the relevant investment. All custom sub objects would be available as modules.
  3. Select the relevant module and select the
    Show in Details
    layout checkbox.
  4. Publish the blueprint.
  5. Navigate to the investment page, select the grid layout, and ensure the investment item that you want to explore is mapped to the blueprint you recently updated.
  6. Select the investment item and open the Details panel.
  7. Select the relevant module that is available as a tab in the Details panel and click
    Expand
    .
  8. Make changes to the grid and try using the
    Manage Views
    and
    Save As
    options.
Expected Outcome: You would be able to manage and save your views.
Actual Outcome: You will not be able to use the Manage Views and Save As options.
Workaround: Navigate to Views, use the Tab key and press Enter as a workaround to select either
Manage
or
Save Views
option.
DE59144: Scheduled PMO Accelerator Reports Move to Canceled State after
Upgrade
The PMO Accelerator-related reports that are scheduled from the
Reports and Jobs
option in
Classic PPM
move to the Canceled state after you upgrade the PMO Accelerator. 
This issue does not impact the reports that were scheduled using the Advanced Reporting option.
Workaround:
After the upgrade, review all the scheduled PMO Accelerator-related reports, specifically the recurring ones, that are in the Canceled state. Create a new scheduled report for the ones that you want to continue. You can then delete the canceled reports. For more information on the workaround, see the KB article.
Resolved Defects
To view the customer reported defects that are resolved in
Clarity
15.9.0
, see the
Clarity
15.9.0
Resolved Issues list.
Third-Party Software Agreements
Clarity
15.9.0
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
Clarity
15.9.0
TPSR list
and download the
Clarity
15.9 TPSR's
to read the license agreements.