ActiveReports 8
Set a Drill-Through Link

In a page report, you can use drill-through links to connect one report to another detailed report. Follow the steps to set a drill-through link in a page report:

  1. On the design surface, select a report control (like a TextBox) on which you want set the link and under the Properties window, click the Property dialog link. This is a command to open the TextBox dialog. See Properties Window for more on how to access commands.
  2. In the control dialog that appears, go to the Navigation page and under Action, select the Jump to report radio button. Doing this activates the fields below it.
  3. Under the Jump to Report field, enter the name of the report (like BasicReport.rdlx) that you want to navigate to on clicking the drill-through link.
    Note: Under the Jump to Report field, when you enter just a report name, the targeted report should be kept in the same directory as the parent report. Else, you can also enter the relative path to the location of the report. You can also use a report from your connected database using the Custom Resource Locator.
  4. After setting the detail report to drill-through, on the Navigation page, under Parameters, you can optionally enter a valid parameter Name and Value to pass to the detail report. This value must evaluate to a valid value for the parameter. By setting parameters you can jump right to the desired information. For example, if your summary report contains a list of invoice numbers and delivery dates for each customer, you could use a drill-through link with the invoice number as the parameter to allow the user to jump to the relevant invoice.  

    Caution: The Parameter Name must exactly match the name of the parameter in the detail report. If any parameter is spelled differently, capitalized differently, or if an expected parameter is not supplied, the drill-through report fails.

  5. Go to the preview tab and click the drill-through link to navigate to the targeted report.
  6. On the Viewer toolbar, click the Back to Parent Report button to return to the main report.

The following images show a simple drill-through link set on a list displaying years. Click any year to drill-through to a report that contains top movies in that year.

Report With a Drill-Through Link

Target Report

See Also

Concepts

Support Forum