Learn more about MATLAB Report Generator

Nest Setup File - Allow one report template (.rpt file) to run inside another

Description

This component runs another report template at the point where the Nest Setup File component is located in the current report template.

The components of the inserted report template are stored in the current report template at the same level as the Nest Setup File component. Thus, inserted components have the same parent component as the Nest Setup File component.

Properties

• Setup file to run: Specifies the name of the report template to import and run. You can enter a name or use the browse button (...) to find the file.

• Inline nested report in this report: Inserts the nested report in the original report template where this component is located.

• Insert link to external report: Creates two separate reports, one using the original report template and one using the nested report template.

• Recursion limit: Allows you to nest a report template inside itself by setting a recursion limit in this field. The recursion limit sets a limit on the number of times the report template can run itself.

• Nest all reports with specified file name: Nests all reports with the same name as specified in the Setup file to run option.

Example

In the following example, the report template R2.rpt is nested in R1.rpt:

[-] Report - R1.rpt                [-] Report - R2.rpt
 [ ] Chapter                              [ ] 1
      [-] B                               [ ] 2
         [ ] Nest Setfile - R2.rpt       [-] Chapter
         [ ] C                              [ ] 4
      [ ] D                                 [ ] 5

The generated report is identical to the one generated by the following report template:

    [-] Report - R1.rpt
      [ ] Chapter
      [-] B
         [ ] 1
         [ ] 2
         [-] Section 1
           [ ] 4
           [ ] 5
         [ ] C
      [ ] D

Components that determine their behavior from their parents, such as Chapter/Subsection, are affected by components in the parent report template.

Insert Anything into Report?

Yes, if the nested report template produces a report.

Class

rptgen.crg_nest_set

See Also

Comment, Import File, Stop Report Generation, Time/Date Stamp

© 1984-2010- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS