The Report Content page

This guide contains:

Before you begin: Set up your Report Template Properties

To start working with the Report Content page, you need to walk through the following setup steps:

  1. Upload your report template if it isn't already uploaded.

  2. Click the yellow Edit button below the report template, then navigate to the Content Blocks tab.

  3. Define the content blocks that your report template is expecting.

  4. Then, navigate to the Document properties tab.

  5. Define the document properties that your report template is expecting.

  6. Click the Update Report template properties button, then navigate to Projects in the header and locate the project you're working with. Click the yellow Edit button, and make sure that the project is associated with the report template in Step #1.

Content Blocks

The Content Blocks pane on the Report Content page will display the Content Blocks that you've defined in your Report template properties. If they do not appear, walk through the steps outlined above.

Note sure what Content Blocks your report template is looking for? Learn more in the Note content control page of the Custom Word reports guide.

In the example below, we've defined the following Risk Block Group in our report template properties:

  • Title: A Text field with the value Overall Risk Rating
  • Type: A Text field with the value Risk
  • Risk: A Text field with the possible values High, Medium, or Low
  • Description: A free Text field
Projects 70

Inside the Dradis project that is associated with the report template pictured above, our Report Content page's Content Blocks section looks like this:

Projects 71

To customize the data that will populate the Note content controls in your custom report template, just click Edit and fill in the fields with your project-specific content:

Projects 72

You may also manually add new Content Blocks within the Project even if that Content Block is not defined in your report template properties, or if you are working in a project not associated with a report template. Click on the '+' icon on the sidebar to add a Content Block.

Projects 87

Document Properties

The Document Properties pane on the Report Content page in your Project will display the Document properties that you've defined in your Report template properties. If they do not appear, walk through the steps outlined above.

Not sure what document properties your report template is looking for? Learn more in the Adding document properties page of the Custom Word reports guide.

In the example below, we've defined 3 document properties in our report template properties:

  • dradis.client
  • dradis.title
  • dradis.version
Projects 66

Inside the Dradis project that is associated with the report template pictured above, our Report content page looks like this:

Projects 67

To define the Document properties so that they populate the placeholders in the report template, we just need to fill in the fields with the correct values:

Projects 65

You may also manually add new Document Properties within the Project even if those Properties are not defined in your report template properties, or if you are working in a project not associated with a report template. Click on the '+' icon on the sidebar to add a Document Property.

Projects 88

Remember to click the Save All button after updating your document properties. If you attempt to navigate away from the page without saving your document properties, you will get a warning so you don't lose your data.

Projects 89

Migrating an old-style Project

Previously, the document properties and content blocks were stored in Notes set to specific categories. If you import one of these old-style Projects into Dradis, it will be automatically migrated for you so that you can use the new Report content page with Document Properties and Content Blocks.

When you import your old-style Project, you'll see an alert like this on the Report content page and on the Project Summary page:

Projects 68

Just click the Migrate report content data button!

The document properties and their values from your imported project will appear on the Report content page once the migration has finished. If they do not appear, walk through the steps outlined above.

If you have a property in your imported project that isn't defined in the Document Properties of your Report template properties, it will appear highlighted in yellow as shown below. If you are confident that this document property (e.g. dradis.version) isn't needed, you can go ahead and delete it.

Projects 69

The Content Blocks will also be converted. If you have a content block in your imported project that isn't defined in your Report template properties, it will appear highlighted in yellow as shown below.

In some cases, Dradis just wasn't able to match the Content Block to a Block Group. If you edit the Content Block and select the correct Block Group from the dropdown at the top, the Content Block will appear correctly without the highlight.

If you are confident that this Content Block (e.g. Conclusions and Recommendations) isn't needed, you can go ahead and delete it.

Projects 73

Next help article: Adding issues and evidence →