Release Notes and Announcements

Velocity Reporting update FAQ (updates start with Jama Connect 8.42)

By Kristina posted 09-13-2019 14:32

  

What are these changes?

The Velocity engine is being updated, requiring new template syntax for customers' reports.


Why is Jama Software making these changes?

Updating the Velocity reporting process to the new format will improve the overall quality of these reports in several ways:

  • Improving overall security
  • Increasing the stability of reports over time
  • Simplifying the Report building process 


How does this impact Jama Connect users at my company?

Jama Connect users are not expected to be impacted immediately, but with any change in tooling, there is a risk of fringe issues not being immediately visible due to the highly customizable nature of the application.

All custom Velocity report templates will need to be modified to a slightly new format in order to ensure full functionality is retained. The Jama Software development team has created a conversion script that will perform the heavy burden for self-hosted customers. Likewise, this same script will be performed server side on our cloud to help ease the change.

Cloud: At the time of 8.44 release, Clients who have not contacted the Support team to change Velocity early will be updated automatically and revised reports will be available to your teams automatically.

Self-hosted: We have crafted an analysis script which will skim your reports and identify templates and functions which are no longer supported with the updated engine. A conversion script will also be available for assisting in converting your Velocity report templates. This will assist in narrowing the scope of work needed by your teams to transition. Here is a link to the GitHub repository for the conversion script: Velocity Report Updater.

These customers are encouraged to send copies of Velocity report templates to Jama Software for review so that template functions with less frequent usage can be reviewed for a potential fix in the 8.48 Spring Standard release. 


When can I start using the new feature?

All customers can use it as soon as the 8.42 release is deployed or installed.


Can I choose not to opt in?

Temporarily, yes. This is opt-in for the roll out phase, but this is a short window and delaying may impact your teams later. 

Cloud: Prior versions of Velocity will be disabled upon deployment of the 8.44 release, but previously created reports will be converted to the new syntax automatically. 

Self-hosted: Prior versions of the Velocity template syntax will be disabled upon upgrade to the Standard 8.48 release. Failing to upgrade will result in installations that do not have access to the new security and performance improvements this update provides.  Only the new Velocity template syntax will be supported with the 8.48 release.


Where can I see the documentation?


You can see all of the Velocity documentation via this link. Make sure to refresh your page, because if you've visited before, the older data may be cached.


What elements have been changed and how?

We've created data sources that group the methods used in reports into related domains. Replace any references to items in the left column with the data source in the right column. This is best for informational purposes, our recommendation is to use the linked conversion script (Velocity Report Updater) to avoid manually making these changes to your reports.

3 comments
159 views

Comments

6 days ago

Hi,
there has been a feature-request regarding disabling of macro-caching. Has this been considered in the course of the engine changes?
BTW: We have started looking into the effort that it will take us to translate the reports from old to new velocity. The updater seems to do a good job. Except for the $velocityReportUtil.getValueForField() we did not need to manually rewrite anything yet.

Regards
Anna

25 days ago

Hi @Jan,

Please go ahead and reach out to Jama support to request this activation, as support's assistance is advised.

Thank you,
Carmen
​​

27 days ago

The corresponding release notes state that:
"The changes to Velocity are currently released as opt-in and must be turned on by a system administrator for Jama Connect on-premises instances."

I did not find an option in the system properties (root login) or anywhere else that allows to activate this opt-in. Did i miss this crucial information in the release notes or the reporting update FAQ?