# PrintOptions

## Content

# Interface: PrintOptions

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

## Extended by

- [`ExportOptions`](ExportOptions)

## Properties

### error

```ts
error: (error) => void;
```

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

#### Parameters

##### error

[`ErrorInfo`](ErrorInfo)

#### Returns

`void`

#### Examples

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

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

***

### reportID

```ts
reportID: string;
```

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

#### Examples

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

```javascript
// UMD usage
GrapeCity.ActiveReports.JSViewer.print({
reportID: 'AnnualReport.rdlx'
}):
```

***

### reportParameters?

```ts
optional reportParameters?: Parameter[];
```

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

#### Examples

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

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

***

### reportService?

```ts
optional reportService?: ReportServiceSettings;
```

Set up the settings to connect the Web API.

#### Examples

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

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