SAVEASPDF Function (Report)

Saves a report as a .pdf file.

Syntax


[Ok :=] REPORT.SAVEASPDF(Number, FileName[, Record])  
[Ok :=] ReportVariable.SAVEASPDF(FileName)  

Parameters

Number
Type: Integer

The ID of the report that you want to run. From the C/AL Editor, on the View menu, choose C/AL Symbol Menu to select the report from a list.

FileName
Type: Text

The path and name of the file that you want to save the report as. This path can be a local drive or mapped network directory, such as C:\MyReports\report206.pdf. For a network directory, you can also use the Universal Naming Convention (UNC) path, like \\servername\sharename\folder\filename.

Record
Type: Record

Specifies which record to use in the report. Any filters that have been applied to the record that you specify will be used.

ReportVariable
The report that you want to run.

Property Value/Return Value

Type: Boolean

true if the report was saved; otherwise, false.

If you omit this optional return value, then run-time errors can occur. If you include a return value, it is assumed that you will handle any errors.

Remarks

You can use the SAVEASPDF function on the global REPORT object or on Report variables. If, at design time, you do not know the specific report that you want to run, then use the global REPORT object and specify the report number in the Number parameter. If you do know which report you want to run, then create a Report variable, set the Subtype of the variable to a specific report, and use this variable when you call the SAVEASPDF function.

When you call SAVEASPDF, the report is generated and saved to "FileName." A Saving to PDF window shows the status of the process. Note that the request page will not be shown.

The FileName parameter specifies a location on the computer that is running Microsoft Dynamics NAV Server. If you call this function from a client, such as from an action on a page, then use the DOWNLOAD Function (File) to download the .pdf file from the computer that is running Microsoft Dynamics NAV Server to the computer that is running the client.

Note

By default, when a report uses an RDLC report layout at runtime, fonts are embedded in the generated PDF. You can specify whether fonts are embedded in the PDF for RDLC reports by changing the Report PDF Font Embedding setting in the Microsoft Dynamics NAV Server instance configuration or changing the PDFFontEmbedding property in report objects. For more information, see Configuring Microsoft Dynamics NAV Server and PDFFontEmbedding Property.

Example

This example shows how to use the SAVEASPDF function to save a specific report as a PDF file on the computer that is running Microsoft Dynamics NAV Server. It requires that you create the following variables.

Variable name DataType Subtype
Filename Text Not applicable
ReturnValue Boolean Not applicable
Report206 Report Sales - Invoice
Filename := 'C:\MyReports\report206.pdf';   
ReturnValue := Report206.SAVEASPDF(Filename);  

See Also

Report Data Type