SAVEASHTML Function (Report)

Saves a report as an HTML file. The file is saved on the computer where the Microsoft Dynamics NAV Server instance is running, and then downloaded to the Dynamics NAV client when ready.

Important

This function is only supported when a report uses a Word report layout when it is run.

Syntax


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

Parameters

Number
Type: Integer

The ID of the report object that you want to run.

FileName
Type: Text

The folder path and name of the file that you want to save the report as.

The path must already exist and the service (login) account that is used by the Microsoft Dynamics NAV Server instance must have permission to write to the target folder. Otherwise, you will get errors.

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
Type: Report

Specifies the report that you want to run.

Property Value/Return Value

Type: Boolean

Indicates whether the report was saved successfully.

true if the report was saved; otherwise, false.

  • If you omit the return value, then when a report cannot be saved for some reason, an error message appears to the user, such as "Out of hard disk space," "The file parameter is not open," and so on.

  • If you use the return value and an error occurs, false is returned and no error message appears. It is assumed that you will handle any errors.

Remarks

The SAVEASHTML function uses the logic in the codeunit 9651 Document Report Mgt. code unit to handle the format transformation.

The SAVEASHTML function can be used on the Report data type and on Report variables. When you are programming the SAVEASHTML function, if 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 know which report you want to run, then create a Report variable, set the Subtype of the variable to a specific report, and then use this variable when you call the SAVEASHTML function.

When you call the SAVEASXML function, the report is generated and saved to "FileName." The request page is not shown.

Reports that use an RDLC layout when run cannot be saved in the HTML format. A runtime error will occur if SAVEASHTML is used on an RDLC report.

See Also

Report Data Type