Jama Connect® 9.0.2 Customer-Validated Cloud

• Inline Editing - Double-click on an item to open quick edit mode to update a subset of

fields in a condensed form. Switch to full edit mode to work with all available fields. 

• Insert Items - Add new items where you want without losing your place in the document. 

Document View Comments Panel

You can now view comments and items simultaneously, interacting with both as needed.

 From the Comments panel, you can: 

• Read and reply to existing comments
• Add, like, mute, and filter comments
• @mention a person or group

Document View - Additional Improvements

• Quick Edit mode now opens when you double-click on an item
• Also, when you click in the white space to the right of the content, the item is selected or deselected. 
• When you hover over an item and Quick Mode isn't activated, editable user fields include a gray background.  
• In Quick Edit mode, only fields that are displayed are required fields with an empty value.
• Required fields with a value are hidden unless you configure them to be displayed.
• From Admin > Organization > Details, you can disable or enable Document View.
• If your organization prefers to manage the transition from Reading View more tightly, you might turn it off. 
• In Document View, Quick/Full Edit forms hide required fields already populated and show only blank fields if those fields are not configured to be displayed in the current view. 

Document View — Future Enhancements

Document View will continue to evolve in future releases with new features and capabilities; the slide-out panel will include additional widgets and actions, including related items, connected users, activities, versions, and more. 

Additional features under consideration for the longer-term roadmap:

• New content alert and refresh for collaborating with colleagues on content development.
• Breadcrumb and jump-to navigation to quickly access specific content. 
• Nested tables for components or folders. 
• Advanced field configuration for mixed item types and hiding fields. 
• Extending Document View design and usability to other areas of Jama Connect, including the Review Center.

Now Available: Jama Connect Advisor™

On October 26, 2022, Jama Software launched Jama Connect Advisor, a fully integrated add-on product for Jama Connect Cloud. Jama Connect Advisor helps users write effective, efficient, and well-organized requirements. Based on industry-accepted INCOSE rules (International Council for Systems Engineering) and EARS notation (Easy Approach to Requirements Syntax), Jama Connect Advisor utilizes natural language processing to deliver insight into requirement quality and accuracy in real time.

For details and licensing information, visit our website or contact your Jama Software Customer Success Manager. 

Introducing Multiple Project Dashboards

With this release, you can expand dashboard organization and categorize data with individually named project dashboards.
Project and organization admins can create, edit, or delete a dashboard. Users with read/write permissions can view dashboards created by their admins. Work with your admin to create a dashboard with the widgets that best support your team's needs.

Organization and project admins now click Add Dashboard to name and create project dashboards within these parameters: 

• The initial project dashboard allows unlimited widgets, but we recommend a maximum of 20 for optimal performance.
• Subsequent dashboards are limited to 20 widgets. 
• You can have a maximum of 20 dashboards per project.

When you use the dashboard feature, your role determines your interactions and the available options. 

​​​​See Working with Dashboards in the Jama Connect® Product User Guide for more information about the dashboard feature. 

Test Management Improvements 

Test Step Usability Updates

Several updates have been made to the Single Item View for test cases to improve the editing workflow.

• Result column styling has been updated to indicate better that this column is not editable from the test case item.
• The add Step button is now located at the bottom of the table.

Keyboard focus shortcuts have been added for easier step editing and navigation. 

The Rich Text Editor remains at the top of the table for improved formatting control when you add steps. 

You can easily copy and paste an entire test step to other steps. You can triple-click on the row number to select an entire test step.

Test Management Improvements - Multiple Tests

Testers now have the option to execute multiple tests in a row without closing and reopening the Test Execution window.

• Select Open my next assigned test to allow a user to execute or navigate through multiple assigned runs.

• From the Test Execution window, a summary of all test runs by status now appears for that cycle after you run through or execute multiple runs.  

Test Management Improvements - Saving Progress

Testers can save progress when executing a test run by selecting Save. 

Additional Test Management Improvements

• From the Test Run Execution window, you can now copy text without clicking Start Test Run. 
• When a test run without steps is started and saved before it has passed or failed, the status In progress is now applied. 
• When the Test Run Execution window opens, associated items are no longer automatically unlocked, and action buttons are disabled until you click Start Test Run. 

Baseline Improvements

Introducing the Baseline Compare

This release introduces the ability to compare two versions of a baseline using the baseline in-app Compare option via Document View. This feature allows users to compare older baselines with newer versions of baselines within the same source, a first for baseline management directly within Jama Connect.

When you view a baseline in the new document layout, select Compare to activate the in-app comparison feature. Previously, users had to export a report to view baseline-to-baseline changes.

Changes are displayed in line with the version indicated by color:

• Red = Edited or deleted text/data from an older version
• Green = Edited or added text/data from a new version

Note: The new document layout and baseline comparison aren't visible if the organization admin disabled Document View. Also, baseline comparison reports are still available to support specific use cases. 

Baseline Source List View and In-app Comparison Summary

This release introduces the ability to compare two baselines from the Baseline Source List View. A baseline source is generated when you create a baseline or review; you can now select the baseline source to see all baselines associated with that source in List View.

This feature provides detailed information about the baseline's metadata, such as the number of items, Baseline ID, Baseline signatures, Baseline status, and Baseline type. Previously, only some information was accessible from the baseline's Details View. 

Previously, you had to run an external comparison report to see differences between baselines. The comparison summary allows you to see a high-level view of baseline changes. You also have the option to run the enhanced baseline comparison report, which was previously only available via Community reports.  

You can run a comparison report by selecting two baselines from the Baseline Source List View and clicking Compare. From there, you can download and open the report. 

Additional Baseline Improvements

• A new confirmation message appears when the organization and project admins create baseline folders.
• Users with permission to create baselines can make them from the Project Explorer Tree by right-clicking on a set, component, folder, or item.

• You can now email a link to a baseline from the baselines header. 

• The breadcrumb navigation (Find Me option) has been relocated from the baseline header to the baseline ID.

• To create a baseline from a filter more efficiently, right-click on a filter and select Add baseline.

Reports Administration Now Available for Cloud Customers

Organization admins in a Cloud environment can now manage custom reports and exports from Admin > Reports. With Microsoft Office Template and Velocity report templates, you can now:

• Add reports
• Edit existing reports
• Delete existing reports

Important Note:  Any new or edited reports should be tested in a non-production environment before being implemented in a production environment.   

Please contact Jama Software® Support to help upload custom BIRT reports. 

Updates to Velocity PDF — Table of Contents, Table of Tables, and Table of Figures

A new configuration for Velocity PDF exports and reports is available in the Add/Edit Report modal, including a Table of Contents, Table of Tables, and Table of Figures. The best part? No changes to your Velocity template file are required to include these tables in the output file!

When adding a new Velocity template file or editing an existing one, follow the steps below:

• Ensure the Report Type = Velocity and the Report Format includes PDF
• Note there is a new section labeled Include Table of... (PDF only):
  • Select the checkboxes for the table(s) you would like to include in the output file
• Save the report template after completing all other relevant fields.

Users who run a report with these options will be notified when a PDF is selected as the file format in the report window. Please note: PDF files containing tables of contents, figures, or tables will take longer to generate hyperlinks to each section. The more pages the PDF includes, the longer the report will take to generate.

Once the file is generated and downloaded, the table(s) will be included in the PDF output, and each section will be linked to the appropriate page. 

Velocity PDF Report Templates — Additional Improvements

This release also introduces new Velocity PDF report template options: Table of Contents, Table of Tables, and Table of Figures. 

• If a report template includes a title page wrapped in a <div> container with the given class name TitlePage, the export now places the "Table of..." list on a new page after the title page.
• The "Table of..." list appears on the first page without the container and class name. 
• Each "Table of..." list is enclosed in a unique <div> container/class name so they are targeted by the Velocity template with a specific CSS.
• Support for h5-h7 tags has been added with unique class names, so the Velocity template with specific CSS targets them.

For more information, see Quick Start: HTML Templates for Velocity PDF Reports.

Wildcards in Search Updates

This release updates how Jama Connect uses wildcards in a search. The primary search bar and the filter panel search bar

have been updated to improve how search results are presented.

• Removed the Wildcard That Was Automatically Applied to the Front of Search Terms
• This wildcard returned results that included words with additional characters before the ones typed into the search field.
• For example, when you searched for "term" the auto-wildcard returned "docuterm", "postterm", "syncterm", etc.
• Added a Checkbox to "Include Wildcard Results" To the Search Results and Filter Panel
• This option allows you to add a wildcard to the front of your search term as needed.

Important Considerations:

• The primary search bar and filter panel search still use a wildcard automatically added to the end of your search term.
• The results contain terms you entered in the search field but with additional characters after the terms.
• For example, when you search for "term," the auto-wildcard at the end still returns results for "term," "terminal," "terminus," "termites," etc.
• Additional results included by selecting Include wildcard results aren't included if you switch to Trace View from the search results.
  • This capability will be available in a future release.

Report History Page Updates

This release introduces new features and a complete redesign of the Report History page. 

Now you can: 

• Search for a report 
• Sort columns to reorganize the table 
• Download multiple reports at a time 
• Delete multiple reports at a time 
• Determine the origin of a report or export by viewing the new Context column 

General and Usability Improvements

Review Center

Guardrails now prevent you from performing actions on previous review revisions or changing closed reviews. 

Categories

• When an organization admin selects Clean up categories, a message appears in the Activity history. 

• Velocity reports now include the option to retrieve categories with items. 

User and License Admin

•  Organization admins can now export a list of all users from the Users page. 

The exported data Excel sheet in License Admin has the following changes:

• A new column calculates the Duration in Milliseconds in a hh:mm:ss format to clarify when the user logged in.
• The 'UTC' text was removed from the LoggedInAt and LastActivityAt columns so that Excel can recognize these as date/time formats.

Editing Container Items

The item opens in the new inline edit mode when you edit a component, set, or folder. 

To edit an item:

• In the Explorer Tree, right-click on an item.
• From the header, select Edit. 

API

v1 API 

• GET v1/baselines/{baselineId}/versioneditems - response now contains the applied category snapshots at the time of the baseline
• The GET/items/{id}/versioncategories API parameters. The versionID has been replaced with versionNumber to match our existing patterns.  

Labs API

• The POST /baselines endpoint now allows you to create a baseline without first making a source.

Velocity

The Velocity API method for returning a list of ChangeRequestAssociation objects is now given a ChangeRequest ID.

General Maintenance and Library Updates

This release includes updates to several libraries and foundational technology components like Java and Spring. These updates align with our continuous improvement objectives to support usability, performance, and security across the app.   

SAML and REST API Update for Custom Data 

For SAML, the 'Custom identifier' option in the 'Match on field' attribute has been divided into two options:

• Custom Identifier (NameID)
• Allows root admins to configure SAML to use custom data sent over in the NameID attribute during user authentication flow.
• Custom Identifier (Attribute)
• Allows root admins to configure SAML to use custom data sent over in a custom attribute during user authentication flow.

Note: These are Beta features that are still under development.

The following v1 API endpoints now have a property for adding Custom Data to specified users. This custom data for users pertains to a beta SAML feature still being developed.

• PUT /users/{userId}
• POST /users
• GET /users
• GET /users/{userId} & GET /users/current

BIRT Reports EOL

The BIRT reporting engine and associated reports will no longer be supported with the Spring 2024 release. Look for additional communication via the Jama Software User Community on new Velocity reports and other options to assist in the transition from this legacy reporting platform.  

Resolved Issues

Known Issues