REPORT.RUN Function

Loads and runs the report that you specify.

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.

Example

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

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

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

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.

MyRec.FINDLAST;
MyRec.SETRECFILTER;
Report.RUN(101, TRUE, TRUE, MyRec);

See Also

Reference

Report Data Type