Prev Next

Setting Sections for Reporting

As part of designing or editing a template for generating a document report, you define the content to deliver in your report, specifically:

  • Which model features to report on (such as elements, attributes, linked documents and Tagged Values), using the 'Sections' panel of the Document Template Designer
  • What information to provide on the instances of each feature (such as the name, type, phase, priority or author), using the 'Content' panel of the Document Template Designer

The information you define here determines the structure of the report, what sections it contains and the order of those sections.

Access

Ribbon

Publish > Tools > Document Templates > Sections

Publish > Tools > Document Templates > Content

Other

Resources window | Document Generation | User Templates : right-click on a template | Open > Sections

Resources window | Document Generation | User Templates : right-click on a template | Open > Content

Select model components to be documented in the report

Step

Action

See also

1

Expand some or all of the hierarchy in the 'Sections' panel.

2

Select the checkbox next to the feature name; the feature name is then displayed as a pair of section tags in the 'Content' panel of the Document Template Designer.

element >

< element

For features in the lower levels of the hierarchy, selecting a child feature automatically selects the parent level(s) and adds the parent tags to the 'Content' panel.

3

If you want to change the sequence of sections, click on the appropriate feature name in the 'Sections' hierarchy and click on or to move the feature name up or down.

The position of the feature name within the 'Sections' hierarchy determines the position of the section documenting that feature in the 'Content' panel, and hence in the report. You can change the sequence either before or after you have selected the checkboxes, it makes no difference.

4

For each selected feature, click between the section tags in the 'Content' panel and add text, or right-click and select the 'Insert Fields' option to add fields.

Add Section Content

Notes

  • More specific guidance is provided for selecting these features:
         -  Child objects
         -  Embedded elements
         -  Profiled Relationship Matrices
         -  Constraints and Scenarios
         -  Linked Documents and Document Artifact contents
         -  Elements held in external Packages
         -  Tagged Values
         -  Sections formatted as tables
         -  Using the Custom section for Custom Query Fragments

Learn more