Debugging your template
One of the most powerful features of Dradis is our 1-click reporting engine.
When you are working with a custom report template, there will come a time when you need to do some debugging to understand how things are working or why you are not getting the results you expected.
In this guide you will learn how to debug issues with your template and how to identify problems with your content that are causing your template to fail.
What this guide covers
This is a template debugging and troubleshooting guide. It covers:
Common problems when generating a report
- Generating the report from the command line
- When you generate the report but the content isn't there
- When the export fails
- Cannot populate "MyControlName" inline content control with multi-paragraph content
Word error messages
- Word error: Word experienced an error
- Word error: ambiguous cell mapping
- Word error: qualified name
- Word error: XML parsing
Validating your project
- Validating Issue fields
- Validating Evidence fields
- Validating Content Block fields
- Validating document properties
- Validating Screenshots
Missing content
If you're not getting an error message but instead missing content or having trouble getting tool output exporting into your reports, check to make sure your Mappings Manager is correctly configured for your Report template.
Export stalling
After you click Export, the on-screen log should update until "Worker process completed" appears. If the on-screen log isn't updating with any progress, you may need to clear the export queue.
Head to the
/setup/jobspage in your browser.When prompted for credentials, enter in the Admin console - HTTP Basic Auth credentials from the Dradis user portal.-
In the Queues section, you'll see where there are active jobs. In the example below, the dradis_export queue:
-
Click on the queue that needs clearing (e.g. dradis_export) and click the Remove Queue button in the top right corner to clear the queue:
Finally, test the export in the web app again. If that doesn't do the trick, try the command line export instructions.
If you don't have a report template yet and want to create your first one, I'd recommend these resources:
- Dradis Pro custom Word reports 101: This is the best way to get started, it covers what are the different moving parts and how everything fits together.
- Sorting and filtering: Learn how to sort your findings by severity, CVSSv2 number, etc.
- Reporting by host, reporting by issue: Present your findings by host (e.g. issues affecting host X) or by issue (e.g. the XSS problem affects hosts X, Y and Z).
Next help article: Common problems →