Jama Connect® 9.0.2 Customer-Validated Cloud

Amanda Jennewein
Amanda Jennewein
  • Updated
Release Date: 2023/06/22

Introducing Document View 

Jama Connect has added a streamlined authoring and editing experience called Document View.

You can write, read, and edit items in one view without losing your place in the overall document

and context of related content. Key features of Document View include:

  • One View 
    • Read and write content in a simplified format.

Screenshot 2024-04-12 at 4.25.13 PM.png

  • 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. 

Screenshot 2024-04-12 at 4.25.44 PM.png

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

Screenshot 2024-04-12 at 3.49.50 PM.png

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

Screenshot 2024-04-12 at 3.50.57 PM.png

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.

Screenshot 2024-04-12 at 3.54.18 PM.png

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. 

Screenshot 2024-04-12 at 3.55.00 PM.png

​​​​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.

Screenshot 2024-04-12 at 4.26.17 PM.png

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

Screenshot 2024-04-12 at 3.58.47 PM.png

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

Screenshot 2024-04-12 at 4.26.42 PM.png

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.

Screenshot 2024-04-12 at 4.01.36 PM.png

  • 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.  

Screenshot 2024-04-12 at 4.02.18 PM.png

Test Management Improvements - Saving Progress

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

Screenshot 2024-04-12 at 4.27.13 PM.png

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.

Screenshot 2024-04-12 at 4.04.08 PM.png

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

Screenshot 2024-04-12 at 4.27.38 PM.png

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. 

Screenshot 2024-04-12 at 4.05.49 PM.png

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. 

Screenshot 2024-04-12 at 4.28.11 PM.png

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.

Screenshot 2024-04-12 at 4.07.19 PM.png

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

Screenshot 2024-04-12 at 4.08.31 PM.png

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

Screenshot 2024-04-12 at 4.09.16 PM.png

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

Screenshot 2024-04-12 at 4.09.51 PM.png

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. 

Screenshot 2024-04-12 at 4.11.33 PM.png

Screenshot 2024-04-12 at 4.28.42 PM.png

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.

Screenshot 2024-04-12 at 4.29.20 PM.png

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.

Screenshot 2024-04-12 at 4.14.11 PM.png

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. 

Screenshot 2024-04-12 at 4.14.53 PM.png


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.

Screenshot 2024-04-12 at 4.17.38 PM.png

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 

Screenshot 2024-04-12 at 4.18.30 PM.png

General and Usability Improvements

Review Center

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


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

Screenshot 2024-04-12 at 4.19.39 PM.png

  • 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. 

Screenshot 2024-04-12 at 4.20.42 PM.png

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


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.


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

ID Description


When you convert an item type to another item type that has a pick list with a mandatory field, the field is now populated with the default value.  


Deleted Test Plans not longer affect data in the System Health Report.  


Emails are now sent to the specified email address if the license usage threshold has been reached.  


Leading and trailing spaces in a text field can now be removed went editing an item.  


The Replace with baseline window now reflects the correct item number and reports when no updates are needed. 


The relationship type configured via relationship rules is now applied when editing relationships.  


Items exported from Baseline List View now appear in the correct order in tables.  


When a test group name changes, the updated name is now reflected in Table View and Single Item View. 


Users with a dash in their email address domain can now be invited to reviews.  


When you select the option Fix URL References, the URLs for images in test steps are now updated.  


<>& characters are now displayed in Reading View as expected


When a participant is changed from Approver to Reviewer and a new revision is published, the approve/reject count on the new revision does not count items that were formerly approved/rejected by that user when they were an Approver.


Calculated and Logic fields now export as expected in velocity.


When you update Test Runs via REST API, the execution time now remains unchanged and no longer resets to midnight. 


Sending a cycle to review now always includes runs that were not deleted while editing groups in a cycle.


When you export a baseline with categories, the categories now maintain the baselined information. 


When you search for Categories and assign them to items, those Categories now correctly match terms in the displayed path. 


We have updated the text of the error message that appears when you delete a user group that has permissions for review transitions. 


In Reading View, the required date fields now appear in the correct location above the categories table. 


In Trace View and Coverage Explorer, exported items with Matrix Lookup Calculations are now now displayed correctly. 


The Trace View item preview panel shows the correct version number for the item.  


When you edit a description field with an image, the Save & done button is now enabled when there is a slow internet connection. 


For test runs, you no longer need to populate custom date fields to save the test run. 


When a baseline item is edited, converted, or reverted, the pop-up text, Can't replace with baseline, no longer appears.


Test Cycle custom attributes are now displayed correctly in the Add/Edit Cycle Details window.


Review activities are now displayed correctly when certain fields in the review are blank.


Sets with specific permissions that are converted to a folder will display correctly in List View.  


In a review, when a moderator clicks Resolve below the original comment, the comment is now saved correctly and the item content isn't changed. 


Changes were made to parameters in Jama Connect and in Tomcat logs and log size to avoid crashes in specific scenarios.


The CKEditor description field options are now displayed correctly in the Edit Cycle Details window in a test cycle. You now see the following options: Add/Edit Diagram, Add Image, Add image from server, Check Accessibility, Math Editor, and Chemistry Editor. 


In List View, pick list values are now saved when you perform an inline edit. 


You can now successfully provision a new instance or migrate using a .jama backup. 


In the REST API, PATCH /items will update items that include a Lookup Matrix.


Electronic signature is now available when the username is configured for authentication via SAML.  

Known Issues

ID Description
SOS-DEF-6970 Description from previous baseline copies over when trying to edit a new baseline. 
SOS-DEF-7042 Baseline list view select all isn't selecting all baselines on all pages until all pages are paged through before selecting any row.
SOS-DEF-7045 Baseline comparison from the baseline document view isn't showing differences past the first page.





Related to

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request



Please sign in to leave a comment.