Feasibility of Test Protocol and Report Export Customizations in Velocity Reports

Author: Amanda Jennewein
Date: November 10, 2025
Audience: Support Engineers, Consultants, and Customer Administrators evaluating or implementing Velocity report customizations in Jama Connect®.
Environmental Details:

Jama Connect® and Velocity reports

Summary

This article addresses common feasibility questions related to customizing Velocity reports for test protocols and exports. Topics include report file generation, image handling, column formatting, validation of missing results, hyperlink formatting, conditional conclusions, and defining test runs for export.

Customer Questions and Feasibility Details

1. Can image sizes be reduced upon export to prevent Word file size issues?

Answer:
Reducing image size during export typically does not provide enough compression to avoid Word file limitations.

Recommendation: Split the report into multiple runs to reduce image volume or use a custom script to handle image extraction outside the report.

2. Can table columns in a Velocity template have fixed widths?

Answer:
Yes, Velocity templates can enforce fixed column widths, and macros can be used to auto-scale images within those cells.

Limitation: Long unbroken strings may override column width settings, as Word automatically resizes columns to fit such content.

3. Can an error message be generated if “results” fields are missing before the report runs?

Answer:
Velocity reports can perform a pre-emptive check to verify that all test case “results” fields are populated. If any are empty, the report can generate a message or error output within the resulting file listing the missing items.

Note: Velocity cannot display a pre-run pop-up error; validation messages can only appear within the generated report output.

4. Can a table of attachments be added to describe appendix contents?

Answer:
Yes. A table can be generated to show metadata about attachments (e.g., name, type, and download link).

Note: This table lists attachment data or download links, not the visual images themselves.

5. Can hyperlinks in rich text fields be removed upon export?

Answer:
Yes. Hyperlinks can be omitted or converted to plain text during report export.

Key Limitations

Velocity cannot generate more than one file per report run.
Pre-run error prompts are not supported (only in-report error messages).
String parameters have a 256-character limit.

Suggested Alternatives

Split extensive reports into smaller batches.
Use EESP scripting for image extraction.
Apply filtering mechanisms instead of manually entering IDs.
Use macros for image scaling and consistent formatting.
To engage with our Enterprise Engineering Services Program (EESP), please contact your Customer Success Manager or Solutions Consultant.

Additional Information / Metadata /Resources

Feedback:
Have suggestions or improvements? Please leave your feedback in the comments section below.

Related to