Manage Report Outlines

Required Tenable Security Center User Role: Organizational user with appropriate permissions. For more information, see User Roles.

In Tenable Security Center, the report outline allows you to modify the structure of a PDF or template-based report.

The outline consists of the following components:

Component Outline Level Description
chapter primary Highest-level component. Can contain any type of element (grouping, text, chart).
element subordinate A grouping, text, or chart element. Can be nested in a chapter or grouping component.

Edit a Report Outline

To edit a report outline:

  1. In the left navigation, click Reporting > Reports.

    The Reports page appears.

  2. In the reports table, click the name of the report you want to edit.

    -or-

    Right-click the row for the report you want to edit, and click Edit.

    The Edit Report page appears.

  3. On the left side of the page, click Definition.

    The report outline appears. The outline is, by default, expanded.

  4. In the report outline, you can:

    • Expand or collapse elements nested in the outline by clicking Collapse All or Expand All at the top of the outline.
    • Expand or collapse elements nested in an individual chapter or element by clicking the arrow next to the element.
    • Add a custom chapter.
    • Add a template chapter.
    • Add or edit a report element.
    • Reorder chapters and elements in a report.

    • Delete a report element by clicking the delete icon next to the element.

      Note: Tenable Security Center does not ask you to confirm this deletion. However, the deletion is not final until you save all changes to the report.

  5. Click Submit to save your changes to the report.

Add a Custom Chapter to a Report

In Tenable Security Center, you can add custom chapters to PDF or template-based reports.

To add a custom chapter to a report definition:

  1. In the left navigation, click Reporting > Reports.

    The Reports page appears.

  2. In the reports table, click the name of the report you want to edit.

    -or-

    Right-click the row for the report you want to edit, and click Edit.

    The Edit Report page appears.

  3. On the left side of the page, click Definition.

    The report outline appears. This outline is, by default, expanded. For more information, see Edit a Report Outline.

  4. At the bottom of the report outline, click Add Chapter

    Tip: If the report contains multiple chapters or sections, scroll down to locate the bottom navigation bar. It can also be helpful to click Collapse All on the top navigation bar to collapse the outline to its highest-level components.

    The Add Chapter page appears.

  5. In the Name box, enter a title for the chapter.

  6. In the Location box, select a relative location for the chapter within the report.

  7. In the Style box, select a style for the report.

  8. Click Submit.

    Tenable Security Center adds the chapter to the report and displays the Edit Report page.

  9. Click Submit to save your changes to the report.

Add a Template Chapter to a Report

In Tenable Security Center, you can add template chapters to template reports and custom PDF reports.

To add a template-based chapter to a report definition:

  1. In the left navigation, click Reporting > Reports.

    The Reports page appears.

  2. In the reports table, click the name of the report you want to edit.

    -or-

    Right-click the row for the report you want to edit, and click Edit.

    The Edit Report page appears.

  3. On the left side of the page, click Definition.

    The report outline appears. This outline is, by default, expanded. For more information, see Edit a Report Outline.

  4. At the bottom of the outline, click Add Template Chapter.

  5. Do one of the following:

    • In the Search Templates box in the top right corner of the page, search for a specific template by keyword.

      Tip: After the initial search, you can limit search results by template category.

    • Click a template category icon to view the related templates.

  6. Click the report template that contains chapters you want to include in your custom report.

  7. (Optional) Modify the default options for the report template:

    1. In the Chapters section, select which chapters from the template you want to include in your report. By default, the report includes all chapters from the template.

    2. Do one of the following:

      • In the Focus section, target all systems in the report.

        This is the default setting. To return to this setting, click All Systems in the Targets drop-down box.

      • Target specific assets in the report.

        1. In the Targets drop-down box, click Assets.

        2. Select Assets and Repositories.

      • Target specific IP addresses in the report.

        1. In the Targets drop-down box, click IP Addresses.

        2. In the IP Addresses box, type the IP address or addresses where you want the report to focus. Use commas to separate multiple addresses.

        3. In the Repositories box, select a target repository or repositories.

      • Target specific repositories in the report.

        1. In the Targets drop-down box, click Repositories.

        2. In the Repositories box, select a target repository or repositories.

    3. (Optional) Edit text in the Description box.

      Note: You cannot modify any information in the Details section.

  8. Click Add.

    Tenable Security Center adds the template chapter or chapters to your custom report and displays the Add Report page again.

  9. (Optional) Change the template chapter options.

    1. Click the edit icon next to the chapter you added.

    2. In the Name box, edit the chapter title.

    3. In the Location box, change the relative location for the chapter within the report.

    4. In the Style box, select a style for the chapter.

    5. Click Submit to save your changes to the chapter.

  10. Click Submit to save your changes to the report.

Add or Edit a Report Element

You can add or edit elements within chapters or grouping elements in Tenable Security Center reports.

To add or edit a report element:

  1. In the left navigation, click Reporting > Reports.

    The Reports page appears.

  2. In the reports table, click the name of the report you want to edit.

    -or-

    Right-click the row for the report you want to edit, and click Edit.

    The Edit Report page appears.

  3. On the left side of the page, click Definition.

    The report outline appears. This outline is, by default, expanded. For more information, see Edit a Report Outline.

  4. Do one of the following:

    • Click Add Element next to the element where you want to add the element.

    • Click the edit icon next to the element you want to change.

      Tip: To display Add Element or the edit icon, hover the cursor over the element.

  5. Configure any of the following types of elements:

  6. Click Submit to save your changes to the report.

Configure a Grouping Element in a Report

Grouping elements in Tenable Security Centerreports include:

Type

Description

Relevant Reports

Group

Groups associated elements on the same page.

 PDF

Section

Allows you to organize content within chapters.

 PDF

Iterator

Allows you to specify how the report groups its data. For example, if an Iterator Type of Port Summary is chosen for a vulnerability report, vulnerability data in the report is grouped by detected ports. If you do not configure an iterator, hosts and vulnerabilities are listed in the report individually.

 PDF

To configure a grouping element:

  1. In the left navigation, click Reporting > Reports.

    The Reports page appears.

  2. In the reports table, click the name of the report you want to edit.

    -or-

    Right-click the row for the report you want to edit, and click Edit.

    The Edit Report page appears.

  3. On the left side of the page, click Definition.

    The report outline appears. This outline is, by default, expanded. For more information, see Edit a Report Outline.

  4. Click Add Element.

    Tip: To display Add Element, hover the cursor over the element.

  5. Do one of the following:

    • Add a group to the report.

      1. In the Grouping section, click the Group icon.

      2. Configure the following options:

        OptionAction
        NameType a name for the element.
        LocationSelect a location for the element in the report.
        StyleSelect a style for the element.

    • Add a section to the report.

      1. In the Grouping section, click the Section icon.

      2. Configure the following options:

        OptionAction
        NameType a name for the element.
        LocationSelect a location for the element in the report.
        StyleSelect a style for the element.

    • Add an iterator to the report.

      1. In the Grouping section, click the Iterator icon.

      2. Configure the following options:

        OptionAction
        General
        NameType a name for the element.
        LocationSelect a location for the element in the report.
        StyleSelect a style for the element.
        Definition
        Query

        Select a predefined query to define the data included in the element. For more information, see Queries.

        Type

        Select the type of data to include in the element. Iterator elements support vulnerability or event data only.

        Source

        Select the source of the data included in the element.

        Valid values for this field differ based on the setting of the Type option:

        • If Type is set to Vulnerability, valid Source values are:
          • Cumulative—All vulnerabilities, regardless of whether the vulnerabilities have been remediated or not
          • MItigated—Remediated vulnerabilities

          • Individual Scan—Vulnerabilities identified in a specific scan

            Note: If you select Individual Scan, Tenable Security Center displays the Selected Scan option, which allows you to select a scan to use as the basis of the report:

            1. Click one of the predefined date ranges, or click Custom Range and enter starting and ending days for the range.

            2. Click Fetch Scans to view a list of possible scans within the date range.

            3. Click the scan you want to use in the drop-down box.

        • If Type is set to Event, valid Source values are:
          • Active—Currently active events

          • Archive—Archived events

            Note: If you select Archive, Tenable Security Center displays additional options, allowing you to select the LCE that collected the events and the Silo that stores the archived events.

        Filters

        Specify additional criteria to refine element data. See Manage Report Filters

        Iterator Type

        Select a grouping method for iteration data:

        • IP Summary—Group vulnerability or event data by the IP addresses of detected hosts.
        • Port Summary—Group vulnerability or event data by the detected ports.
        • Type Summary—Group event data by event type.
        • User Summary—Group event data by user.
        • Vulnerability Summary—Group vulnerability data by individual vulnerability.
        Results DisplayedSelect the number of results you want to include in the iteration.
        Sort ColumnSelect the column that Tenable Security Center uses to sort the iteration data.
        Sort DirectionSelect the sort direction for the iteration data.
        Header InformationSelect the columns you want to include in the iteration data. Available columns depend on the settings of the Type and Source options.
  6. Click Submit to save the element.
  7. Click Submit to save your changes to the report.

Configure a Text Element in a Report

Text elements in Tenable Security Center reports include:

Type

Description

Relevant Reports

Matrix

Data in a chart layout.

 PDF

Table

Data in a table layout (max results displayed: 999).

The underlying data set determines the report display. The default view for most reports is host-centric and Tenable Security Center presents the user with the ability to choose a vulnerability-centric report (a listing of vulnerabilities with all associated hosts).

 PDF

Paragraph

Descriptive text that can be inserted anywhere in the report. Use this option to describe table elements or report output for the viewer.

 PDF

Assurance Report Card

An element based on the results of a selected Assurance Report Card.

PDF

To configure a text element in a report:

  1. In the left navigation, click Reporting > Reports.

    The Reports page appears.

  2. In the reports table, click the name of the report you want to edit.

    -or-

    Right-click the row for the report you want to edit, and click Edit.

    The Edit Report page appears.

  3. On the left side of the page, click Definition.

    The report outline appears. This outline is, by default, expanded. For more information, see Edit a Report Outline.

  4. Do one of the following:

    • Click Add Element to add an element.

    • Click the edit icon next to the element to edit an existing element.

      Tip: To display Add Element and the edit icon, hover the cursor over the element.

  5. Do one of the following:

    • Add a matrix to the report.

    • Add a table to the report.

    • Add a paragraph to the report.

      1. In the Text section, click the Paragraph icon.

      2. Configure the following options:

        Option Action
        Name Type a name for the element.
        Location Select a location for the element in the report.
        Style Select a style for the element.
        Text Type the text of the paragraph.
      3. Click Submit to save your changes to the element.

    • Add an Assurance Report Card to the report.

      1. In the Text section, click the Assurance Report Card icon.

      2. Configure the following options:

        Option Action
        Name Type a name for the element.
        Location Select a location for the element in the report.
        Style Select a style for the element.
        Assurance Report Card Select the Assurance Report Card (ARC) you want to add to the report. For more information on ARCs, see Assurance Report Cards.
      3. Click Submit to save your changes to the element.

  6. Click Submit to save your changes to the report.

Configure a Matrix Element in a Report

A matrix element is a type of text element you can insert into a Tenable Security Center report definition. For more information on text elements, see Configure a Text Element in a Report.

To configure a matrix element in a report:

  1. In the left navigation, click Reporting > Reports.

    The Reports page appears.

  2. In the reports table, click the name of the report you want to edit.

    -or-

    Right-click the row for the report you want to edit, and click Edit.

    The Edit Report page appears.

  3. On the left side of the page, click Definition.

    The report outline appears. This outline is, by default, expanded. For more information, see Edit a Report Outline.

  4. Do one of the following:

    • Add a new element:

      1. Click Add Element.
      2. In the Text section, click the Matrix icon.

    • Click the edit icon next to the element you want to change.

    Tip: To display Add Element and the edit icon next to an element, hover the cursor over the element.

  5. Configure the General options:

    Option Action
    Name Type a name for the element.
    Location Select a location for the element in the report.
    Style Select a style for the element.

  6. In the Cells section, select the number of columns and rows you want the matrix to include. By default, the matrix is 4 cells by 4 cells.

  7. Click Generate Cells.

    Tenable Security Center displays the empty matrix for configuration.

  8. Do one of the following:

    • Edit a row or column header.

      1. Click the header for the row or column you want to edit.

      2. Next to the header label, click the actions menu.

        The actions menu appears.

      3. Click Edit Header.

      4. In the Label box, type a new header.

      5. Click Submit.

    • Add a matrix component.

      1. Click the matrix cell where you want to add the component.

      2. In the Data Type drop-down box, select the type of data for the component.

      3. In the Type drop-down box, select the type of calculation you want the component to perform.

      4. In the Source drop-down box, select a data source.

      5. (Optional) In the Filter box, add or edit a filter using the same steps you would to add a filter to a report element; see Manage Filter Components for a Single Element in a Chapter Report.

      6. In the Rules section, click Add Rule to add a rule.

        -or-

        Click the edit icon next to a rule to edit an existing rule.

      7. Click Submit to save your changes to the component.

    • Copy a row or column.

      1. Click the header for the row or column you want to copy.

      2. Next to the header label, click the actions menu.

        The actions menu appears.

      3. Click Copy.

        For columns, Tenable Security Center inserts the copied column to the right of the original column

        For rows, Tenable Security Center inserts the copied row under the original row.

    • Delete a row or column.

      1. Click the header for the row or column you want to delete.

      2. Next to the header label, click the actions menu.

        The actions menu appears.

      3. Click Delete Cells.

  9. Click Submit to save your changes to the element.

  10. Click Submit to save your changes to the report.

Example

Configure a Table Element in a Report

A table element is a type of text element you can insert into a Tenable Security Center report definition. For more information on text elements, see Configure a Text Element in a Report.

To configure a table element in a report:

  1. In the left navigation, click Reporting > Reports.

    The Reports page appears.

  2. In the reports table, click the name of the report you want to edit.

    -or-

    Right-click the row for the report you want to edit, and click Edit.

    The Edit Report page appears.

  3. On the left side of the page, click Definition.

    The report outline appears. This outline is, by default, expanded. For more information, see Edit a Report Outline.

  4. Do one of the following:

    • Add a new element.

      1. Click Add Element.

      2. In the Text section, click the Table icon.

    • Click the edit icon next to the element you want to change.

      Tip: To display Add Element and the edit icon next to an element, hover the cursor over the element.

  5. Configure the General options:

    Option Action
    Name Type a name for the element.
    Location Select a location for the element in the report.
    Style Select a style for the element.

  6. Configure the Data options:

    Option Description
    Type Equivalent to the Definition option of the same name in Report Options.
    Query
    Source
    Tool
    Filters

  7. Configure the Display options:

    Option Description
    Results Displayed Equivalent to the Display option of the same name in Report Options.
    Sort Column
    Sort Direction
    Display Columns

  8. Click Submit to save your changes to the element.

  9. Click Submit to save your changes to the report.

Example

Configure a Charts Element in a Report

Charts elements in Tenable Security Center reports include:

Option

Description

Relevant Reports

Bar Chart

Click to add a bar chart element to the report.

 PDF

Pie Chart

Click to add a pie chart element to the report.

PDF

Line Chart

Click to add a line chart element to the report.

Line charts are defined by time (x-axis) and series data (y-axis). When selecting the time, available options include Relative time and Absolute time. One or more series data elements can be chosen and displayed as discrete lines for easy comparison.

 PDF

Area Chart

Click to add an area chart element to the report.

Area charts are defined by time (x-axis) and series data (y-axis). When selecting the time, available options include Relative time and Absolute time. One or more series data elements can be chosen and displayed as a stackable view for easy comparison.

 PDF

To configure a chart element in a report:

  1. In the left navigation, click Reporting > Reports.

    The Reports page appears.

  2. In the reports table, click the name of the report you want to edit.

    -or-

    Right-click the row for the report you want to edit, and click Edit.

    The Edit Report page appears.

  3. On the left side of the page, click Definition.

    The report outline appears. This outline is, by default, expanded. For more information, see Edit a Report Outline.

  4. Do one of the following:

    • Add a chart element:

      1. Click Add Element to add an element.
      2. In the Charts section, click the icon for the type of chart you want to add.

    • Click the edit icon next to an existing chart element.

      Tip: To display Add Element and the edit icon, hover the cursor over the element.

  5. For all charts, configure the General options:

    Option Action
    Name Type a name for the element.
    Location Select a location for the element in the report.
    Style Select a style for the element.

  6. For bar charts and pie charts, configure the following Data options:

    Option Action
    Type Equivalent to the option the Definition option of the same name in Report Options.
    Query
    Source
    Tool
    Filters

  7. For line charts and area charts, configure the following Data options:

    Option Action
    Data Type Valid values are Relative and Absolute. Use to configure the x-axis of the chart.
    Data Range

    Use to configure the x-axis of the chart:

    • If you select Relative for Data Type, select a relative date range.
    • If you select Absolute for Data Type, select a specific start and end date for the data.
    Series Use to configure the y-axis of the chart. Line charts and area charts require that you configure at least one series.

  8. For bar charts and pie charts, configure the following Display options:

    Option Action
    Results Displayed Equivalent to the Display option of the same name in Report Options.
    Sort Column
    Sort Direction
    Display Columns

  9. Click Submit to save your changes to the element.

  10. Click Submit to save your changes to the report.

Reorder Report Chapters and Elements

In Tenable Security Center, you can reorder chapters and elements in a PDF, CSV, or template-based report.

To reorder report chapters and elements:

  1. In the left navigation, click Reporting > Reports.

    The Reports page appears.

  2. In the reports table, click the name of the report you want to edit.

    -or-

    Right-click the row for the report you want to edit, and click Edit.

    The Edit Report page appears.

  3. On the left side of the page, click Definition.

    The report outline appears. This outline is, by default, expanded. For more information, see Edit a Report Outline.

  4. Do one of the following:

    • In the report outline, click the report element, then drag and drop it to its new location.

    • Click the edit icon for the component, and select a new location in the Location drop-down box.

  5. Click Submit to save your changes to the report.