REPORT.RUN Function
Loads and runs the report that you specify.
Syntax
REPORT.RUN(Number [, ReqWindow] [, SystemPrinter] [, Record])
Parameters
Number
Type: Integer
The ID of the report that you want to run. To specify the report from a list, on the View menu, choose Symbols.
If the report that you specify does not exist, then a run-time error occurs.
ReqWindow
Type: Boolean
Specifies whether the request window for the report will be displayed. The request window is part of the report object.
Specify true to display the request window before you run the report. Specify false to run the report without displaying the request window.
This parameter overrides the setting of the UseRequestPage Property of the report. If you do not provide a value for the ReqWindow parameter, then the setting of the UseRequestPage property is used.
Important
Client-side printing is not supported by Microsoft Dynamics NAV Web client. If you set this parameter to false and the report will be run on Microsoft Dynamics NAV Web client, you must set up the report to print from Microsoft Dynamics NAV Server, otherwise an error occurs at runtime. For more information, see How to: Specify Printer Selection for Reports and STARTSESSION Function (Sessions).
SystemPrinter
Type: Boolean
Specifies whether to use the default Windows printer or use table 78, Printer Selection, to find the correct printer for this report. For example, if the report prints on continuous pages, you can set up an entry in the Printer Selection table to specify to always print this report on a specific printer.
Specify true to use the printer that is defined as the system printer. Specify false, which is the default value, to use the printer that is defined in the Printer Selection table.
Record
Type: Record
Specifies which record to use in the report. Any filters that are attached to the record that you specify are used.
Remarks
If you do not know the specific report that you want to run when you are designing the report, then use this function or the REPORT.RUNMODAL Function. If you do know the specific report that you want to run, then you can use the RUN Function (Report) or the RUNMODAL Function (Report). When you use these functions, the request page runs modally. However, when you choose Preview on the request page, the Print Preview page does not run modally.
Note
Internet browsers can only handle one file per request. Therefore, with the Web client, if this method is called in a repetitive statement (or loop) that generates multiple files, only the last file will be sent to the browser. Alternatively, when designing for the Web client, bundle the files in an archive file (.zip), for example, by using the methods found in codeunit 419 File Management. For more details about this design pattern, see Multi-File Download.
Example 1
This example shows how to run a report. This example displays the request window and sends the report to the printer that is selected in the Printer Selection table.
REPORT.RUN(1001);
Example 2
This example shows how to run a report. This example skips the request window, starts the report immediately, and sends the report to the printer that is selected in the Printer Selection table.
REPORT.RUN(1001, FALSE);
Example 3
This example shows how to run a report. This example skips the request window and starts the report immediately. It sends the report to the system printer instead of the printer that is selected in the Printer Selection table.
REPORT.RUN(1001, FALSE, TRUE);
Example 4
This example shows how to run a report for which you specify a record. This example displays the request window and sends the report to the system printer. This example requires that you create the following variable in the C/AL Globals window.
| Variable name | DataType | Subtype |
|---|---|---|
| MyRec | Record | Customer |
MyRec.FINDLAST;
MyRec.SETRECFILTER;
Report.RUN(101, TRUE, TRUE, MyRec);