Clarity Release Notes

ccppmop160
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
.
Free Clarity Training on Broadcom Academy
To learn how the feature might impact your upgrade from an earlier release, see the Change Impact and Upgrade Guide.
2
Clarity-Rally Integration Enhancements

Access Clarity Timesheets from Rally
Univ
As a Rally user, you can now access Clarity's Timesheet directly from Rally in SSO and non-SSO authentication environments. Timesheets open in a separate browser window. You simply need to add Tasks to the timesheet (if required), record time, and submit the timesheet.
The Clarity Timesheet app is a 'Core' Rally app, which Broadcom fully supports.
Upgrade Impact:
When upgrading, some key points you must remember are:
  • The new core Clarity Timesheet app replaces the former community app.
  • You must add the Clarity Timesheet app by using the gear icon.
  • The new core Clarity Timesheet app is supported with all supported Clarity releases.
Access Rally by using Channels in Clarity
Univ
You can access Rally directly from Clarity when Rally is configured as a Clarity Channel in SSO and non-SSO authentication environments. As with all Channels, the Rally application is accessed in the context of the Clarity investment, and no separate browser window is opened.
Upgrade Impact:
After you upgrade to this release, you can access Rally from Clarity by using channels.
Map Parent Field in Clarity and Rally
Linked
You can now map and synchronize Clarity's Parent field value to Rally's Parent field value. This ensures that changes are synchronized between both systems when you update the parent values in Clarity or Rally. Hence, when you use the Auto-Import Children option in Hierarchies, you can see the latest relationship between various investments in your organization.
Consider an example where you have created a set of Business Outcomes in Clarity and mapped them to Initiatives in Rally. You have also created Projects and mapped them to features in Rally. You can now create a bi-directional field mapping between the Parent fields in Clarity and Rally to ensure that the change is reflected in both of them whenever you update a parent for a project in either system.
Remember that you must execute the Synchronize Mapped Information job to synchronize the values between both systems.
Upgrade Impact:
Ensure that you have installed the latest version of the PMO-Accelerator content add-in to leverage the new capabilities. There is no change in functionality for the Import Integration Mappings, Synchronize Mapped Information, and Import Staging Tables jobs.
To learn more, see Integrating Clarity and Rally.
Map Custom Lookups from Clarity To Rally
Univ
You can now map Clarity single-value lookups to custom lookups (also called drop-down lists) in Rally. In the previous release, you could only map Clarity lookups to four Rally lookups, namely Rally Investment Categories, Rally Milestones, Rally Projects, and the Rally States.
Let's consider a scenario where you have a custom lookup in Rally titled Business Risk and want to map it to the Business Operational Risk lookup in Clarity. You can now:
  1. Create a New Lookup mapping in Clarity to map the values between the Business Operational Risk lookup in Clarity and the Business Risk lookup in Rally.
  2. Create a field mapping between these lookup fields to ensure data is synchronized.
When you update the value of the Business Operational Risk attribute in Clarity and run the Synchronize Mapped Information job, the Business Risk field in Rally will be automatically updated.
Some key points you must remember are:
  • In this release, you can only update custom lookup values in Rally based on changes in Clarity. The Rally-to-Clarity update is not supported.
  • Please review the Data Type Compatability table to review the supported mapping options. Clarity currently only supports mapping to the Drop Down List attribute type in Rally. You cannot map to the Drop Down list (Multi-Value) and Drop Down List (User) attributes.
  • In this release, you cannot map a Clarity number lookup to a Rally custom lookup. You can only map a Clarity string lookup to a Rally custom lookup.
Upgrade Impact:
Ensure that you have installed the latest version of the PMO-Accelerator content add-in to leverage the new capabilities.
To learn more, see Integrating Clarity and Rally.
Roadmaps Enhancements

Export the Roadmap Timeline to PDF
Linked
You can now export the Roadmap timeline view to a PDF file so that you can now include Timeline visuals in presentations or other documents for stakeholder communication. The Export capability is available in the Item Actions menu. The exported PDF includes the agreements, dependencies, and events defined in the roadmap. The exported file name follows the pattern "<roadmap name>_<saved view name>."
Some key points you must remember are:
  • When the exported PDF dimensions (Width X Height) are less than (or smaller) than the default dimensions, the PDF generated will use the default dimensions 1366 W X 768 H.
  • When the exported PDF dimensions (Width X Height) are greater than (or larger) than the default dimensions, the PDF generated will use the dimensions of the generated file.
  • Adobe Acrobat has a limitation with PDF files exceeding a 200" (horizontal) X 200" (vertical) dimension. The PDF file will open upon export but display an error message indicating some of the content may be truncated. If a Roadmap Timeline exceeds the PDF limitation, you will not experience any issues when viewing the Timeline within a supported browser.
  • Clarity's current job (Purge CSV Downloads), created to clean up CSV export files, has been updated to clean up PDF export files. The Purge CSV Downloads job is not available to the end-user from the (Classic PPM) and runs every day at 12:30 midnight and cleans up files older than seven days.
Upgrade
Impact
: After you upgrade to this release, you will be able to leverage the Export to PDF capability.
View Business Agreements on the Roadmap Timeline
Linked
The Business Agreements workspace in Clarity enables you to define and manage agreements between investments in Clarity. Stakeholders can review these agreements before conducting the next roadmap planning activity or making decisions that impact the investment dates. You can review existing agreements between investments by selecting the Show Agreements toggle. The dependencies between agreements are indicated by using dotted lines to highlight predecessor and successor relationships.
The Roadmap Timeline tools to optionally show Dependencies, Text Overflow, and Agreements have been updated to a 'slider' from a 'check box' to improve the overall user experience from a consistency perspective.
Upgrade
Impact
: After you upgrade to this release, you can start using the Agreements capability in Clarity. After you define agreements, you can view them in the associated roadmaps.
Create and Manage Item Events in the Roadmap Timeline
Linked
For Roadmap Items with linked investments, you can now configure visual indicators to represent events such as milestones or other key (linked) investment dates in the form of a diamond, circle, triangle, square, star, flag, or rocket. Events represent linked investment dates such as investment start or finish dates, Milestone Tasks, or custom date attributes. You can leverage the Events sub-tab on View Options to define the icons associated with relevant events.
Some key points you must remember are:
  • If an event falls outside the Roadmap Item start or finish date, the Event will be positioned at either the start or finish on the Roadmap Item – whichever is closest to the Event date.
  • After using 'Import from PPM,' you must synchronize events defined with a custom date attribute to ensure they are visible and positioned on a Roadmap Item.
  • When Roadmap Items are moved (shifted left or right), Event positioning (e.g., their corresponding dates) will move relative to the Roadmap Item move.
  • If a Roadmap Item has (2) Events that fall on the same date, only the Event created last will be displayed on the Roadmap Item.
Upgrade
Impact
: After you upgrade to this release, you can start using the Events capability in Roadmaps.
Synchronize Roadmap Items with Linked Investments
Linked
You can synchronize additional fields such as Roadmap Item Description, Manager, Priority, Status, Status Indicator, and Stage with linked investments. Roadmap Item (Name) and Goal were the only fields available under the 'Other' section in prior releases.
The Sync All Attributes option is selected by default. You can clear this option and select only relevant attributes.
The 'Sync Linked Items' page becomes distorted if an attribute's name has too many characters. Changing languages or applying a label that results in too many characters can cause the 'Other' attribute listing to be incorrectly positioned at the bottom of the page.
Upgrade
Impact
: After you upgrade to this release, you will be able to synchronize the new attributes.
To learn more, see Clarity Roadmaps.
Enhanced Visual Experience During Drag and Drop in the Roadmap Timeline
Linked
The user experience for moving a Roadmap Item within the Timeline view has an exciting new look and feel. The User Experience becomes available when changing either the start date only, the end date only, or shifting the roadmap item left of right or between swim lanes. The visible Date Drag Guidelines with extra shading help you position the roadmap item on the timeline.
Timesheets Enhancements

Enhanced User Experience While Adding Tasks
Linked
The user experience for adding tasks to a timesheet has been enhanced in this release. You can choose from the following four options:
  • Select Tasks
  • Add Assigned Tasks
  • Copy Previous Timesheet
  • Copy Previous Timesheet (with time)
The Smart filters in Clarity recognize the current user and populate the timesheet based upon the selection. The Copy Previous Timesheet options are only selectable if a timesheet for the prior period exists.
Upgrade Impact:
After you upgrade, you will be able to leverage the enhanced user experience while creating timesheets.
To learn more, see Submit a Timesheet.
Enhanced Filters While Using Select Tasks Page
Linked
When you manually wanted to add tasks to a timesheet in previous releases, you used the "+Work" page that included a series of custom filters. You can now use the Add Tasks button and choose Select Tasks to open the Select Tasks generic grid in this release. This grid includes all the capabilities of the Clarity generic grid. You can view the powerful filtering capability to identify and add relevant tasks quickly.
Upgrade Impact:
After you upgrade, you will leverage the enhanced Select Tasks grid to add tasks to the timesheet.
To learn more, see Submit a Timesheet.
The following are the rules/conditions determining which Tasks are displayed in the new My Timesheet 'Add Tasks' grid:
  • A default filter (Assigned Resource = Current User) is applied when you choose the "Select Tasks" option.
  • Tasks for active investments (e.g., Projects, Ideas, CITs, and NPIOs) where the user is allocated to the investment as either an individual or as a member of a team assigned to the investment.
  • Tasks for which the user has been assigned either an individual or a team member allocated to the task.
  • Only when the corresponding user exists and is:
    • Open for Time Entry
    • Active
    • Labor
    • Not a role
  • The task is not a milestone or a phase.
Status Report Enhancements

In this release, three new capabilities have been  introduced in the Status Module:
  1. You can now configure report content and preview & publish in a PDF format in Ideas and Custom Investments with the "Living Status Report" capability.
    • You can create new reports from the "Reports" tab, configure report content, preview, publish to a PDF format, and manage existing reports or view previously published reports.
    • From the "Current" tab, you can configure report content, preview, and publish to a PDF format (for the most current report).
      StatusModule_LivingStatusReport.png
  2. You can simultaneously update multiple status reports using bulk edit from the 'Reports' tab or configurable grid view. The Status module grid includes a new 'Latest' attribute to indicate the most recent record (by date) combined with 'report status' set to 'final.'
    StatusModule_EditBulk.png
  3. From the Status module grid, you can indicate the most recent status report record using the new 'Latest' checkbox.  Clarity determines the latest report by using the 'Report Date' and 'Report Status=Final.'
Upgrade Impact
: When you upgrade to this release, the Living Status Report will be available to all users who have access to the Status module.
Task Management Enhancements

Edit Dependencies in the Task Timeline
Linked
You can now directly manage dependencies in the Timeline grid by editing the predecessor and successor fields. This capability was not available in previous releases, and it reduces the need to use multiple third-party tools to manage tasks. You can click WBS/Row icon to choose a preferred format and then edit the predecessor and successor fields to define the new dependencies.
Upgrade Impact
: When you upgrade to this release, you will be able to edit dependencies on the Task Timeline.
Simultaneously Assign Multiple Resources to Task Assignments
Linked
The newly introduced Assigned Resources multi-value lookup (MVL) shows you various resources assigned to tasks. You can now use the multi-select capability to select multiple resources for the task. This capability provides project managers with an improved user experience and reduces the total number of clicks to assign work.
When you use Bulk Edit to update 'Assigned Resources' (MVL), the existing data will be removed and replaced with the new selection(s).
Upgrade Impact
: When you upgrade to this release, you will be able to use the multi-select capability to assign multiple resources.
To learn more, see Manage Tasks.
Review Baselines in the Timeline Layout
Linked
You can leverage the Compare to Baseline action to view the current baseline in the Task Timeline. This option displays the baseline taskbars by using the baseline dates and the current dates. In this release, the Baseline module has been added to the default project blueprint. After your administrator adds this module to your blueprint, you will see the baselines for your projects.
Some key points you must remember are:
  • You don't need to have access to the Baselines Module to use the Compare to Baseline action.
  • You don't need any additional access rights to use the Compare to Baseline action.
Upgrade Impact
: When you upgrade to this release, you will be able to use the Compare to Baseline action. Also, you must add the Baselines module to the relevant blueprints manually.
Expand and Collapse All Investments In The Timeline Layout
Linked
You can use the Expand All and Collapse All options in the Timeline layout to expand and collapse all tasks.
Upgrade Impact
: When you upgrade to this release, you will be able to leverage the new Expand All and Collapse All functionalities.
Quickly Filter Tasks Assigned to Self
Linked
You can quickly locate my Task assignments using the 'smart' filter where 'assigned resources' is the current user. It provides team members an improved user experience and reduces the total number of clicks to find their work.
Upgrade Impact:
When you upgrade to this release, you will be able to leverage the smart filter capability.
Allocate Resources to Investments on the Staffing Page
Linked
You can now create and add staffing allocations by using the Staffing Workspace. This option was not available in the previous release where the Staffing Workspace was introduced.
In the Staffing workspace, the Team object (the main object) now has date range context to leverage per-period metrics with either Sum of Totals or Grand Totals options.
Upgrade Impact:
After you upgrade to this release, you can create and add staffing allocations in the Staffing workspace. Ensure you have the relevant access rights to leverage this functionality.
To learn more about the Staffing workspace, see Analyze Resource Allocation.
Introducing Business Agreements
Linked
The success of any large organization depends on the seamless execution of hundreds of different investments that are loosely or tightly coupled with each other. Most customers struggle to capture and manage agreements between these investments. Generally, the discussions on the dependencies between investments happen in planning meetings, and the decisions are documented in emails which get buried very quickly.
Hence, when critical investments in an organization introduce changes that impact their delivery dates, most stakeholders are caught unaware, and the effects are felt both upstream and downstream. When you analyze the root cause of such failures and delays, you identify two key reasons.
  • There is no single place of truth in the organization where stakeholders can review dependencies between investments. Hence, they are unaware of the impact of making changes that extend the timelines of any investment.
  • Most stakeholders simply don't remember all the investments dependent on them and the ripple effect of introducing changes.
The Business Agreements workspace in Clarity addresses these challenges by enabling you to define and manage agreements between investments in Clarity. Stakeholders can review these agreements before conducting the next roadmap planning activity or making decisions that impact the investment dates.

Configure Blueprints for Business Agreements
Linked
As an application administrator or PMO content designer, you can use blueprints to configure layouts for the Agreements workspace. 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 agreements. You can create different blueprints that include custom fields and channels that are relevant to those stakeholders.
Upgrade Impact
: After you upgrade to this release, the Agreement blueprint will be available to you. You can create a copy of this blueprint and edit it.
To learn more see, Business Agreements Blueprints.
Working with the Business Agreements Canvas
Linked
The Canvas layout provides a simple and visually intuitive interface to help you manage your business agreement. The canvas will display grey shading to the area where the selected widget/field will be dropped. You can click a particular view to open the Canvas layout, including the Investment Dependences, Conversation, Stakeholders widgets, and the commitment and deadline fields.
Some key points to remember are that you can:
  • Configure the layout to add or remove widgets and attributes.
  • Modify the canvas by dragging the available widget or field to the canvas.
  • Resize widgets in fields.
  • Configure the data in six columns on the canvas.
  • Include all supported data types except TSVs.
  • Edit data on the canvas.
  • View only objects for which you have permission when editing data.
  • Use the "@" symbol to notify users while using the Conversations widget.
Upgrade Impact:
After upgrading to this release, you can use the canvas to manage business agreements between various investments.
View Business Agreements for Investments in Clarity
Linked
When you create an agreement between investments, you can see this agreement in the Agreements modules within those investments. Your administrator must add the Agreements module to the blueprint associated with your investments.
You cannot edit agreements from within your investment. However, you can click the Agreement Name and navigate to the Agreements workspace.
Upgrade Impact
: The administrator must add the Agreements module to various investment blueprints to ensure users can see the agreement.
Business Rules Enhancements

Disable Editing of Attributes
A new action is introduced in Blueprints to disable editing attributes. The Disable Editing Attributes action has two options:
  1. Disable Selected:
    You can now define attributes that should not be editable when conditions are met.
  2. Disable All Except Selected:
    You can also define an action where the selected attributes are editable, and all other attributes are not editable.
DiableEditingAttributes.png
Some key points you must remember while working with 'Disable Editing Attributes' are:
  • Rules will control the editing of the attributes within the investment. So, you can't edit the field from:
    • Board Layout
    • Grid Layout
    • Detail Panel
    • Properties Page
  • For the non-editable field, you will see a denial icon displayed, and the field will be greyed out.
Upgrade Impact
: When you upgrade to this release, the Disable Editing Attributes rule will be available in the relevant blueprints.
Active Rules Increased to 25
Univ
You can now define any number of rules within a blueprint. You can also have 25 rules simultaneously active. In previous releases, you could only have ten active rules.
  • Rules do not get applied in any specific order. Clarity reads all the rules and then applies them simultaneously.
  • If you have two rules that negate each other, then no rules will be applied unless the two rules contradicting each other are disabling attribute editing.
  • Suppose two rules disabling editing of attributes, such as one rule to disable editing of attributes and another to disable editing of all except selected attributes, are applied on the same attribute. In that case, the disabling of the attribute will supersede, and the attribute will be disabled.
  • Disabling editing of attributes will work in conjunction with FLS.
    • If an attribute is set to be read-only using business rules or FLS and editable using the other, then the read-only action will prevail.
Upgrade Impact
: After you upgrade to this release, you can simultaneously have 25 active business rules. You must activate existing rules manually.
Hide Actions By Using Business Rules
Univ
In the previous releases, administrators did not have fine-grained access control capabilities for actions. A new Hide Actions rule has been introduced in this release to show relevant actions to specific users. You can use the rule to hide actions based on conditions.
Upgrade Impact
: After you upgrade to this release, you will be able to leverage the Hide Actions capability. The Hide Actions capability is not available on the Pages blueprint.
Business Rules Available for Pages
You can now define business rules for Pages to control the modules, sections, and actions displayed to end-users for Pages in Clarity. When you create a blueprint, you define
  • Conditions
  • Actions
  • Action Targets
Upgrade Impact
: After you upgrade to this release, you will be able to leverage the Business Rules capability for Pages.
To learn more, see Blueprints for Pages.
Enhancements to Custom Investments

Define Templates for Custom Investments
Univ
You can create custom investment items from templates to save time and enforce consistency. A template is a framework that helps you quickly get started with new custom investments. For example, you may have templates for all major types of custom investments in your organization. While creating custom investments, users can simply choose the relevant template and create the investment.
Select the newly introduced Template flag to mark a particular custom investment as a template. When users create a new custom investment using a template, the Originating Template field will be populated automatically.
Some key points you must remember are:
  • You can secure The Template and the Originating Template field by using field-level security.
  • The Template field has been introduced in the Investment object.
  • The old Project Template field is kept in sync with the new investment template flag for projects.
  • The new Template field will not be displayed in Classic PPM.
  • The old project-specific Template field will not be displayed in Clarity. Its API alias is assigned to the Template field associated with the Investment object.
Upgrade Impact
: After you upgrade, the Template and the Originating Template fields will be available. You can now mark various investments as Templates.
Create a New Custom Investment Item from a Template
Univ
A new <CIT Name> - Create From Template access right has been introduced in this release. This right is present alongside the <CIT Name> - Create access right that is already available. When you have the  <CIT Name> - Create From Template access right, you will see the New From Template button in the Custom Investments grid and board layouts. You can use this button to create a new custom investment from a template. When you create a custom investment from a template, Clarity prompts you to enter the information requested by the administrator in the Create from Template module of the blueprint associated with the template. After you enter this information, Clarity will create a new custom investment with the following information:
  • Roles:
    You can remove the role after adding a named team member to the project that matches a role.
  • Financial Plans:
    Both detailed and summary financial plans.
  • Links:
    All links are copied. Links can contain parameter variables with dynamic context-sensitive values.
  • Task To-Do Items:
    Any to-do items that are associated with the existing tasks are copied to the new investment item.
    Completed
    items are reset to
    Open
    status.
  • Risks, Issues, and Changes
    : Any risks, issues, and changes associated with the template are copied over to the new investment item.
Some key points you must remember are:
  1. The Create from Template modal will only allow up to 200 attributes to be configured.
  2. The <CIT Name> - Create From Template access right coexists alongside the <CIT Name> - Create access right.
Upgrade Impact
: Administrators must assign the Create from Template access right to the respective users and groups after you upgrade.
Specify Mandatory Attributes While Creating Custom Investments
The Custom Investments blueprint includes a Create From Template configuration module. Administrators can use it to configure all the out-of-the-box and custom fields that users must populate in the New Custom Investment window when users create a new custom investment from a template.
Some key points to remember while using the Create From Template configuration module are:
  • Clarity will display all mandatory fields on the screen provided they do not have a default value set or auto-numbering.
  • Administrators cannot remove mandatory fields without default values or auto-numbering from the New Custom Investment section.
  • Administrators cannot add the Blueprint field to the New Custom Investment section.
  • In this release, you cannot add Timescaled value, Multi-value Lookups, and Attachment fields to the Create From Template section.
Upgrade Impact
: The Create From Template capability will be available when you upgrade to this release.
To learn more, see Custom Investments Blueprints.
Enforce Required Attributes for Custom Investments
Univ
The Create from Template module in the blueprint makes it mandatory for users to populate an attribute while creating a custom investment. However, you cannot use it to ensure that the attribute is required every time a user updates it. In Clarity 16.0.0 and higher releases, you can use the Always True condition in Business Rules to add a Required Attributes action. This would ensure that Clarity would not allow you to update records if the required attribute is not populated.
If you select the Always True flag, you cannot specify any other conditions in the Business Rule. You can choose only the Required Attributes action and select the relevant attributes.
Some of the key points you must remember are:
  • The Always True condition in business rules is only applicable to projects and custom investments.
  • You cannot select read-only attributes and auto-numbered attributes in the Required Attributes section.
  • You cannot select the Blueprint attribute by using business rules.
  • If users create an investment by using the New From Template option, Clarity will automatically add the required fields to the New Investment window.
  • When you update a required attribute with a non-null value, users cannot change its value to null. However, if an attribute has a null value before you enforce the business rule, users will not be prompted to add a value till they update the attribute.
  • You will not see any asterisk or visual indicator associated with attributes you select in the Required Attributes section. This applies to the grid layout, board layout, Details panel, and Properties module.
  • You cannot enforce this rule on the following data types:
    • Attachment
    • TSV
    • Calculated/Aggregated/Formula
    • Boolean
    • Read-only studio attributes
    • Auto Number fields
    • Rich Text fields
Upgrade Impact
: Only custom investments using a blueprint that has business rules for required attributes will be impacted. If the investment is using a blueprint that has business rules for required attributes, then:
  • End-users can update the investments without entering a value for the attributes required by the business rule. Clarity will not force the end-user to enter a value for those attributes.
  • Once the end-user enters values for any attribute required by the business rule, Clarity will always require a value for that attribute.
Datawarehouse and BI Enhancements

New Data Synchronized in the Data Warehouse
There are now main additions in the Data Warehouse.
  1. The Timesheet tables in the Datawarehouse have been updated to include the time entry note date field.
    Univ
  2. The investments tables include the newly introduced parent attribute.
    Univ
Upgrade Impact
: When you upgrade to this release, you must run the Load Datwarehouse Job at full load to view the additional data in the Datawarehouse.
Improved Performance of Load Data Warehouse Job
The addition of the following functionality has enhanced the Load Data Warehouse job:
  • The job performance associated with the DWH_RES_RESOURCE" table has been enhanced. When a Resource's property data changes, like the primary role or manager, the resource availability facts will not be updated unless the resource's available hours are updated. Also, when a resource is updated, if the resource name does not change, Clarity will not update any lookup tables based on the resource name. Clarity will not update lookups based on resource name where the resource name did not change.  Previously, if any resource property data changed, Clarity would update all the lookups based on resources for that resource.
  • Data synchronization processing has transitioned from scripts to database procedures for faster replication. The multi-valued lookup data synchronization is updated to improve performance. These improvements have only been made for the PostgreSQL database.
  • Data Warehouse leverages Pentaho Version 9.
Created Date Added to Data Warehouse
The Created Date attribute was added to various tables in the Data Warehouse in Clarity 15.9.3. The Clarity team made this change to address issues reported by customers where records were not getting synchronized if they updated them when the Load Data Warehouse job was being executed. The following areas in Clarity will leverage the Created Date attribute in this release.
Univ
Support for Clarity API Keys to Access Odata
The Enhanced Odata API allows you to use basic authentication and Clarity API Keys to authenticate users to access the Odata environment. You can use the following syntax:
  • Basic Authentication:
    • Username: <Clarity Username>|<Odata-Authenticator> 
    • Password: <Password defined in Clarity>
  • API Keys
    • Username : <API Client ID>|<Clarity Username>|<Odata-Authenticator>
    • Password: <API Keys>
  • The enhanced API works with Odata v2 and v4.
  • All the rules associated with API Keys, such as key expiration, will be applied.
  • Existing Odata access right is still needed to access Odata.
  • Administrators must enable APIs in their environment and create an API Client that end-users should use to generate API keys.
  • When you refresh a non-production from a production environment, Clarity will overwrite the API keys for the non-production environment with the production values as the API keys are stored in the database.
Upgrade Impact
: After you upgrade to this release, you will be able to use the API Keys feature for Odata authentication. Ensure you are using Odata v2 or v4.
To learn more about API Keys, see Authentication and Keys. To learn more about configuring OData access, see Configuring OData Access.
General Enhancements

Introducing Boards and Picklists for Custom Objects
Univ
You can use the Board layout in
Clarity
to view records associated with custom objects as cards. You can arrange these cards with drag-and-drop precision on a board layout with columnar swim lanes. Some key features associated with cards are:
  • Cards can display numeric data and money values (you 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 you select. The name of each metric appears in the legend.
You can also configure your display attributes, choices, and the color of each choice by using the picklist capability.
Upgrade Impact
: After you upgrade to this release, this board layout will be available on the Custom Objects page in Clarity.
To learn more about the Board layout, see Manage Your Data Using Board Layouts.
To learn more about using Custom Objects, see Viewing Custom Objects and Sub Objects.
New Job to Delete Job Log Entries
Univ
The Remove Job Logs and Report Library Entries by Type job lets you delete the job and report library entries. This job is similar to the "Remove Job Log and Report Library" job, except it takes different input parameters and gives administrators more control of what logs should be created. The job has two required parameters:
  • Job/Report Type: - Accepts multiple job types.
  • Age to Delete: Age of entries
Upgrade Impact
: After you upgrade to this release, this job will be available to you. Please note that this job is incompatible with the current Remove Job Log and Report Library job.
To learn more about Clarity jobs, see Jobs Reference.
Enhanced Auto Save Functionality
The Auto-Save functionality in Clarity has been updated. Clarity did not save their changes if a user updated a field and quickly navigated away in previous versions. Clarity will now continue to save changes as a user navigates away but wait 500 ms with no user interaction before refreshing the entire record.
Upgrade Impact
: The enhanced AutoSave functionality will be available after you upgrade to this release.
Confirmation Message Removed from Saved Views
Univ
When you navigated away from a view in previous releases, after making layout changes, you received a confirmation message to save your view. This confirmation message will not be available in Clarity 16.0.0 and higher releases. Whenever users update a view, the view name will be italicized to indicate a change. If a user navigates away without saving the view, their changes would be lost.
Upgrade Impact
: When you upgrade to this release, you will no longer receive a confirmation message when you navigate away from a view after making changes.
To learn more about using Saved Views, see Saved Views in Clarity.
Forecast and Forecast Variance Added to Financial Plan Details
Univ
The Cost Plan Details and the Budgets Details page now have three new attributes: Forecast, Forecast Variance, and Forecast Cutover.
Forecast is defined as the sum of the actual amount for the fiscal period completed and the planned amount for the fiscal period in the future.
Forecast variance is defined as the difference between the planned cost and forecast.
Forecast Cutover allows you to overwrite how Forecast is calculated. When you populate the Forecast Cutover field, Clarity will calculate Forecast as the sum of the actual amount till the Forecast cutover date and the planned amount for the fiscal period in the future.
  • Clarity calculates the total value for Forecast and Forecast variance based on the Totals ("Sum of Periods" or "Grand Totals") setting in View Options.
  • The Forecast attributes are not available in Classic PPM.
Upgrade Impact
: When you upgrade to this release, all three new fields will be available on the Cost Plan/Budget Plan details page. The Forecast Cutover date will not be available in Classic PPM.
Standardized Investment Naming
Univ
In the previous release, Clarity introduced the ability to create labels for stock and custom attributes. However, the Project Name, Idea Name, Project ID, and Idea ID could not be updated by using this functionality since their labels were hardcoded. In this release, you can associate labels with these fields, and Clarity will display the updated values in the grid, Details panel, and Properties module.
Upgrade Impact
: After you upgrade to this release, Clarity will apply the labels to the Project Name, Idea Name, Project ID, and Idea ID in the relevant grid, Details panel, and Properties module. In previous releases, these Project attributes were called "Name" and "ID." They will now be called "Project Name" and "Project ID."
Cross Object Grid Enhancements
Drag.png
When using the Group By capability in the cross-object investment grid (Hierarchies, To-Dos, Staffing), you can drag and drop columns from its parent group to a different group. This capability was not available in the previous release. For example, if you group the investments by "Type," all the investments would be grouped by investment type. The Name, Investment ID, and Type attributes will be available under the Common Investment section. The Parent and Level columns will be under the Hierarchical section. You can now drag the Level field from the Hierarchical section and place it next to the Name field in the Common Investment section.
Upgrade Impact
: When you upgrade to this release, you can drag and drop columns from a parent group to a different group. However, please note that you will see multiple entries for the group header in the Column Panel in such scenarios.
To learn more about the Hierarchies cross-object grid, see Analyze Investments in Hierarchies by Using the Cross-Object Investment Grid.
Introducing Smart Options
Univ
Clarity has now introduced Smart Filters, Smart Periods, and Smart Actions to enhance your experience.
Smart Filters
: You can filter for "Current User" across various investments and objects to quickly identify actions you must complete on that particular area of Clarity. For example, you can review all the projects approved by you on the Projects grid by using this filter.
Univ
You can create a custom lookup to be used along with the Current User flag filter.
Smart Dates
: You can now leverage dynamic date periods for Time-Scaled-Values (TSVs). These dynamic date options vary when you are selecting Start and End Periods in the View Options drop-down. They are available in Cost Plans, Budget Plans, Benefit Plans, Roadmaps, Hierarchy, Staffing, and Widgets.
Dynamic dates are based on the fiscal period defined in the default entity.
Smart Actions:
You can now quickly add tasks to your timesheets by using the Add Assigned Tasks, Copy Previous Timesheet, and Copy Previous Timesheet (with time) options.
Upgrade Impact: These Smart options will be available when you upgrade to this release.
Usability Enhancements
The following user experience enhancements have been introduced to the left-hand navigation menu in Clarity.
  • The left-hand navigation menu is now scrollable. To see additional navigation icons that does not display on a smaller screen or increased browser zoom, you can now use the new vertical scrollbar.
  • You now have the ability to use right-click on left-hand navigation menu to open a module such as project tiles in another window or tab.
Enhancements to Hierarchies

Investment Type Attribute Added to Risks, Issues, and Changes Grids
The Type attribute is now available in the Hierarchies Grid and the Risks, Issues, and Changes modules. This attribute helps display the investment type for a particular investment. You can now group the various risks, issues, or changes in a hierarchy by "Type" to view the risks associated with Projects, Ideas, and Custom investments.
Upgrade Impact
: When you upgrade to this release, the Type attribute will be available in Clarity. However, this attribute will not be available in Classic PPM.
User Experience Enhancements To Hierarchies
The following user experience enhancements have been introduced for hierarchies in Clarity.
  • You can click various investments from the cross-object investment grid or the Risks, Issues, and Changes modules to access them directly from Hierarchies. You can then navigate back from the investment to the hierarchy. This capability was not available in the previous releases.
  • You can use the Bulk Edit capability in the Risks, Issues, and Changes grid. To learn more about this capability, see Common Components.
  • You can import hierarchies and manage custom metrics from the cross-object investment grid. This capability was previously available in the Hierarchy layout.
To learn more about the cross-object investment grid, see Cross-Object Investment Grid.
Upgrade Impact
: When you upgrade to this release, these capabilities will be available in hierarchies.
Introducing the Investment Timeline Layout for Hierarchies (Read-Only)
The Timeline layout in hierarchies allows you to view the relationships between them by using a hierarchical timeline. Each bar corresponds to an investment, and their length is determined by the Start and Finish dates and the relevant View Options.
The Timeline layout is divided into the Investment Breakdown Structure on the left and the Investment Timeline on the right. Both the Investment Breakdown Structure and the Investment Timeline displays the relationships defined by using the Hierarchy layout.
Upgrade Impact
: When you upgrade to this release, the Timeline layout will be available to all users who have access to hierarchies.
Introducing the Status Module for Hierarchies
You can view the status reports associated with all the investments included in your hierarchy. When you open the Status module, you can access fields associated with the abstract investment object and concrete investment objects such as projects, ideas, and custom investments. You can also view fields associated with the Risks object. You use the information in the Status module to quickly analyze the health of various investments and make relevant decisions without leaving the Hierarchies workspace.
Some key points you must remember while working with the Status module are:
  • Your administrator needs to associate the Status module with a blueprint and then map the blueprint to a hierarchy. You can then view the Status module for that hierarchy.
  • If a user has view access to the hierarchy, they will have view access rights to all investments that are a part of the hierarchy. They can also view the status reports associated with those investments in the Status module.
  • You can edit various fields associated with the Status object. You will not be able to edit fields for any other object in the Status module.
To learn more about the Status module, see Explore Status Reports.
Upgrade Impact
: The Standard blueprint associated with Hierarchies will not be automatically updated to include the Status module. Administrators must create a copy of the Standard blueprint and add the Status module to make it available to end-users.
Introducing Configurable Widgets

You can review and summarize the health of an investment by using a series of configurable visual widgets. In this release, the following widgets are available:
  • Number Tile
  • Pie
  • Bar
  • Progress Ring
Linked
Some of the critical actions you can perform with widgets are:
  • Use the Show Widgets button to display the widgets toolbar.
  • Use the Add Widgets dialog box to add existing widgets from the My Widgets section and the Widget library.
  • Create a New Widget from the Add Widgets dialog box.
If you have the Widgets - Manage Widget Library access right, you can:
  • Add your widgets to the Widget library so that other users can leverage them.
  • Edit existing widgets to update the widget definition and filter criterion
  • Move a widget from the Widget library to the My Widgets section.
In this release, the widgets are available in Hierarchies, To Do's, and Custom Objects.
Upgrade Impact
: When you upgrade to this release, the existing out-of-the-box widgets for Hierarchies and To Do's will be automatically moved to the widget library of the administrator. They would need the Widgets - Manage Widget Library access right to edit these widgets.
Enhancements to APIs

View Contract Number in Broadcom SaaS Environment
Univ
The Telemetry Data Export portlet has been enhanced to display a new column, "Serial Number." This field displays the customer's active contract number and the line number for the specific license SKU. The Serial Number column will only be populated for Broadcom SaaS customers.
Upgrade Impact
: When Clarity SaaS customers upgrade to this release, they will see the Serial Number field on the Telemetry Data Export portlet.
To learn more see, View Telemetry Data.
Create an API Attribute ID for Custom Virtual Attributes
A few releases ago, we provided the capability to add API alias to virtual attributes via XOG.
In this release, we are enabling the capability to add the API alias for a virtual attribute in Classic PPM.
VirtualAttributes.png
Upgrade Impact
: When you upgrade to this release, you can enable the capability to manage the virtual attribute API alias in Classic PPM.
To learn more, see Virtual Attributes.
Lookup Object Type Available While Using Describe for the Object Attributes API
Linked
You can discover supported APIs by appending "/describe" to the API URL specified in the API section to view the list of supported public APIs for Clarity. The Describe capability now provides the object lookup attribute's reference object. The image highlights an example where the Value Stream object attribute references the Value Stream - General lookup.
Upgrade Impact
: When you upgrade to this release, you can use the enhanced Describe capability for APIs.
To learn more, see Getting Started with REST APIs.
Clear MVL fields with XOG
Linked
In previous releases, you could not remove a value populated in a multi-value lookup using XOG. In this release, the XOG API has been updated to remove all values populated within a multi-value lookup. The multi-value lookup will accept the new flag "complete= "true" that will replace the passed values with existing values. If no values are passed then, the API will remove all existing values.
Upgrade Impact
: When you upgrade to this release, you can remove values associated with multi-value lookups.
Introducing the User API
Linked
You can now use the User API to manage users. You will be able to use the APIs to:
  • Get user information
  • Update selected user information
  • Update user groups
Some key points you must remember are:
  • You need administrator access to update users.
  • You cannot create a new user by using the API in this release.
  • Assigning user groups can be done by updating the "userGroups" multi-value lookup.
Upgrade Impact
: When you upgrade to this release, you can leverage the User API.
To learn more about APIs in Clarity, see Getting Started with REST APIs.
Accessibility Enhancements

Each of the accessibility improvements is needed to drive adoption because organizations demand compliance with accessibility standards to ensure their users have the proper tools to view and access company-specific details. Numerous foundational accessibility improvements have been incorporated, encompassing:
  • Visual Design (e.g., color, contrast, visible focus)
  • Responsive Design (e.g., pop-up windows, text areas, and browser zoom)
  • Keyboard (e.g., key input, tab order, and focus)
  • Screen readers (e.g., semantics, hierarchy, and pages structures)
In this release, the following Clarity components are compliant with the four aspects of compliance in the form of Visual, Responsive Design, Keyboard, and Screen Reader support:
  • Main (Left) Navigation
  • Object, URL, or Attachment "Link" Navigation
  • My Timesheet
    • Add Tasks
    • Select Tasks Page
    • Add Tasks Flow
    • Add Tasks Filters
    • Notes
  • Holistic Page-Level Navigation
  • Financials Module
Some key points you must remember are:
  • The Clarity product team has determined the combinations below are the supported platforms from an accessibility perspective:
    • Operating System: Windows
    • Browsers: Chrome, Firefox, Edge
    • Screen Readers: JAWS
  • According to the screen reader survey, it is known that:
    • Windows is the clear market leader in the IT Industry.
    • Chrome and Firefox are dominant, whereas IE usage is declining.
    • JAWS is dominant in the Enterprise area.
In Clarity 16.0.0.1 and higher releases, when you click any page, each page shows the title element using one of the following formats:
  • {Page Title} - Clarity
  • {Instance Name} - {Module Name} - Clarity
The page title updates support the screen reader in effectively announcing the page title in Clarity.
Upgrade Impact:
You can leverage all the accessibility enhancements after you upgrade to this release.
To learn more, see Accessibility in Clarity.
Known Issues
Here's a quick list of known issues in this release:
Resolved Defects
To view, the customer reported defects that are resolved in
Clarity
16.0.0, see the
Clarity
16.0.0 Resolved Issues list
.
Third-Party Software Agreements
Clarity
uses third-party software in accordance with the terms and conditions for use, reproduction, and distribution as defined by the applicable license agreements.
Download the
Clarity
16.0.0 TPSR's
to read the license agreements.