ASP.NET

Introduction

To setup a private export server in ASP.NET, you will need the official ASP.NET export handler provided in the FusionCharts package. The export handler will provide the necessary files to configure the export server. It will handle all requests sent by the user for exporting and generate the chart in the requested format.

How Does It Work?

A chart is rendered in the browser.
When the export to image/PDF option is selected, the chart generates the SVG string that represents the current state of the chart and sends to the export server.
The export server captures the SVG string.
The export handler captures the SVG string and uses SharpVectors library to convert to image or PDF.
The export handler either writes the image or PDF to disk, based on the configuration provided by chart, or streams it back to the user as a download.

Installation

Unzip the ‘asp-net-export-handler.zip’ in your IIS wwwroot folder (e.g. C:\inetpub\wwwroot).
Add an application in your server and set physical path to the above folder.
Make sure ‘IUSR’ has proper read/write permission in the ‘Exported_Images’ folder
FusionCharts’ export request contains some XML data, which is restricted in .NET 4 or above. You may need to add the following configuration in your ‘web.config’ file:

<system.web>
	<httpRuntime requestValidationMode="2.0"/>
</system.web>

Configuring the Export Server

To use the private export server, the following attributes need to be configured correctly in the chart.

Attribute Name	Description
`exportEnabled`	Set value to `1` to enable exporting for the chart.
`exportAtClient`	Set value to `0` to enable export via a Private Export Server.
`exportHandler`	Set to absolute path of the export handler e.g. `http://www.example.com/fcExportHandler/FCExporter.aspx`.
`exportAction`	Set value to `save` to store the exported file on the private export server itself. Set to `download` to send the file back to the user (client) for download.