ASP.NET
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 exporting requests sent by the user and generate the chart in the requested format.
How Does It Work?
Step 1: A chart is rendered in the browser.
Step 2: When an export option is selected, the chart generates the SVG string that represents the current state of the chart and sends it to the export server.
Step 3: The export server captures the SVG string.
Step 4: The export handler captures the SVG string and uses the SharpVectors library to convert the chart/chart data into the required format.
Step 5: The export handler either writes the exported chart/chart data to disk, based on the configuration provided by the chart, or streams it back to the user as a download.
Starting v3.11.0, FusionCharts supports exporting chart data as XLS. To export a chart in the XLS format, using server-side exporting, it is mandatory that the exporting server has the latest code, which is available in the FusionCharts package. Alternatively, the FusionCharts export link, export.api3.fusioncharts.com, can also be used.
Installation
Step 1: Unzip the asp-net-export-handler.zip folder in your IIS wwwroot folder (e.g. C:\inetpub\wwwroot).
Step 2: Add an application in your server and set the physical path to the above folder.
Step 3: Make sure 'IUSR' has the proper read/write permissions in the Exported_Images folder.
Step 4: FusionCharts' export request contains some XML data, which is restricted in .NET 4 or above. Therefore, 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 to 1 to enable exporting the chart. |
exportAtClient |
Set to 0 to enable export via a private export server. |
exportHandler |
Set to the absolute path of the export handler, for example: http:// www.example.com/fcExportHandler/FCExporter |
exportAction |
Set 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. |