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 created an analysis script for internal use on the reports you sent us. We identified templates and functions which are no longer supported with the updated engine and found replacements where possible. 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.