The articles in this section of the Knowledge Base involve working with Sub Reports for display in your reports. To learn more about Sub Reports, and how to access this section within the Report Designer, see Understanding Sub Reports in Report Designer. This article features a step-by-step tutorial demonstrating the steps necessary to add a sub report to a report.

1. Open Report Designer.
   
2. Add a Report Title Band if desired.
   
3. Add a Data Band and set the Data Source to the Products table.
   
1. Add a text component to this band and select Products > Name from the Data Column tab. 
   
4. Add a Child Band beneath the Data Band.
   
1. Add a Sub Report component to the Child Band. A new page is automatically added to the report template when the sub report component is added.
   


Fig. 01 – New Page Automatically Added




Your new page is likely called “subReport_1.”


At this point, your report template should look something like the following:




Fig. 02 – Page One of the Report Template



5. Go to the new page of the report template, and place a Header Band with text components for your column labels (In this case, Height, Width, Depth). Place a Data Band with text components for the list of the heights, widths, and depths of your products (in this case, the Data Columns are Products.Height, Products.Width, and Products.Depth). See Figure 04. 
   
1. Set the Master Component of the Data Band to DataBand1. The Master Component is selected instead of selecting a Data Source. Leave the Data Source unassigned. 
   


Fig. 03 – Master Component




By setting the Master Component to DataBand1, you connect DataBand2 to the information being passed to it from DataBand1, rather than setting the Data Source to the entire Products table. If you were to connect DataBand2 to the entire Products table, when the report was rendered, all of the product heights, widths, and depths would be printed at once in the Sub Report, rather than just the height, width, and depth of the single product being passed from DataBand1. See Figures 05 and 06 for visual comparisons.


At this point, your Sub Report resource page should look something like the following:




Fig. 04 – Page Two (subReport_1) of the Report Template



6. Run your report. The results should resemble Figure 05. 
   


Fig. 05 – Example printed report using the Master Component connection. The dimensions are listed for the individual products passed from DataBand1.





Fig. 06 – Incorrect example. This report has been set up using the Products table as the data source, so all of the product dimensions in the work order are listed instead of just the “Open Base w Dividers FF” being passed from DataBand1.