Issue content control

The Issue content control is a special control that tells the reporting engine to repeat a given section of the report for each of the Issues in your Dradis project.

The basics

The most naive example of the Issue content control in action:

Reports 21

If your project has 3 issues and you export it using the template above, this would be the result:

Reports 22

Under the hood, there is nothing special to the Issue control. It's just another Rich Text Content Control, where we assign the Issue value to the Title fields (remember that Word automatically populates the Tag value if you don't provide one):

Reports 23

It's Dradis' reporting engine, and not Word, the one that gives a special meaning to the Issue title. There are other special titles that you can use that we'll cover in the next sections of the manual.

In the real world

If you've been following this manual sequentially, this is where we left our template in the last section:

Reports 20

We want this section of the template to be repeated for each of our findings. Lets wrap everything with an Issue control.

First select the area of the template you want to repeat:

Reports 25

Then click on Rich Text Content Control to add a new control, and give it the Issue title:

Reports 26

The Issue control can enclose almost any type of content, rows in tables, full tables, images, etc.

However, there is a little problem that Issue controls leave unresolved. If you have 3 issues in your project, which one will appear first in the report?

Ah, each section of this manual creates new questions and opens new possibilities, how exciting!

Next help article: Filtering and sorting →