The following options can be set at run time while working with the JS Viewer.

interface PrintOptions {
    error: ((error) => void);
    reportID: string;
    reportParameters?: Parameter[];
    reportService?: ReportServiceSettings;
}

Hierarchy (view full)

Properties

error: ((error) => void)

The callback that is invoked when an error occurs in the process of displaying the report.

Type declaration

    • (error): void
    • Parameters

      Returns void

Example: To handle an error:

// ESM usage
import { printReport } from './jsViewer.min.js';
printReport({
error: (error) => {
if (error.message) {
// show error message.
alert("Internal error! Please ask administrator.");
}
}
}):

Example: To handle an error:

// UMD usage
GrapeCity.ActiveReports.JSViewer.print({
error: (error) => {
if (error.message) {
// show error message.
alert("Internal error! Please ask administrator.");
}
}
}):
reportID: string

The id of the report to be shown by the JS Viewer.

Example: Usage example:

// ESM usage
import { printReport } from './jsViewer.min.js';
printReport({
reportID: 'AnnualReport.rdlx'
}):

Example: Usage example:

// UMD usage
GrapeCity.ActiveReports.JSViewer.print({
reportID: 'AnnualReport.rdlx'
}):
reportParameters?: Parameter[]

The array of the {name, value} pairs that describe the parameters values used to run the report.

Example: Usage example:

// ESM usage
import { printReport } from './jsViewer.min.js';
printReport({
reportParameters: [{ name: 'ReportParameter1', values: ['1']}]
}):

Example: Usage example:

// UMD usage
GrapeCity.ActiveReports.JSViewer.print({
reportParameters: [{ name: 'ReportParameter1', values: ['1']}]
}):
reportService?: ReportServiceSettings

Set up the settings to connect the Web API.

Example: Usage example:

// ESM usage
import { printReport } from './jsViewer.min.js';
printReport({
reportService: {
url: 'http://example.com/api/reporting',
securityToken: '42A9CD80A4F3445A9BB60A221D042FCC',
}
}):

Example: Usage example:

// UMD usage
GrapeCity.ActiveReports.JSViewer.print({
reportService: {
url: 'http://example.com/api/reporting',
securityToken: '42A9CD80A4F3445A9BB60A221D042FCC',
}
}):