HttpHandlers are included in the Professional edition of ActiveReports to allow you to quickly and easily display reports in the browser. In order to use ActiveReports HTTP handlers on the Web with ASP.NET, you must first configure the machine to use the handlers.
For information on how to configure ActiveReports handler mappings in IIS 7.x, see the section Configure HTTPHandlers in IIS 7 and IIS 8 of this Guide.
Follow these steps to configure the ActiveReports HTTP handlers in IIS 6.x so that you can link directly to reports in your Web applications. Once the handlers are configured, you can automatically run a report and view it in the browser from a URL.
To configure ActiveReports HTTP handlers to enable report linking on your machine
- In the Control Panel, open Administrative Tools, then Internet Information Services (IIS) Manager.
- In the Internet Information Services (IIS) Manager window that appears, in the left pane, expand the Sites node, right-click the Web application you want to configure, and select Properties.
- On the Directory tab of the YourWebSite Properties dialog that appears, click the Configuration button.
- In the Application Configuration dialog that appears, select the list item with .aspx in the Extension column and click Edit.
![](images/hs-note.gif) |
Note: If your machine does not have the ASP.NET server components installed, the .aspx handler does not appear in the Application Mappings list. |
- In the Executable field, select and copy all of the text, and click Cancel to return to the Application Configuration dialog.
- Click the Add button to add a new Application Mapping.
- In the Add/Edit Application Extension Mapping dialog that appears, enter the information from the first row of the table below.
Executable |
Extension |
Check that file exists |
Paste the text copied from the *.aspx script map. |
.ar8 |
Clear this checkbox. |
Paste the text copied from the *.aspx script map. |
.ar8Web |
Clear this checkbox. |
Paste the text copied from the *.aspx script map. |
.rpx |
Select this checkbox. |
Paste the text copied from the *.aspx script map. |
.rdlx |
Select this checkbox. |
Paste the text copied from the *.aspx script map. |
.rdl |
Select this checkbox. |
Paste the text copied from the *.aspx script map. |
.ActiveReport |
Select this checkbox. |
- Click OK to close the window and add the script mapping.
- Repeat for each script mapping in the table above.
To enable HTTP handlers in your project
In your Web application, open the Web.config file and add code like the following between the <system.web> and </system.web> tags, changing the Version number on each line to match the version installed on your machine.
Paste inside the <system.web> tags. |
Copy Code
|
<httpHandlers>
<add verb="*" path="*.ar8" type="GrapeCity.ActiveReports.Web.Handlers.ReportBinariesStreamer, GrapeCity.ActiveReports.Web.v8, Version=8.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
<add verb="*" path="*.ActiveReport" type="GrapeCity.ActiveReports.Web.Handlers.CompiledReportHandler, GrapeCity.ActiveReports.Web.v8, Version=8.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
<add verb="*" path="*.rpx" type="GrapeCity.ActiveReports.Web.Handlers.RpxHandler, GrapeCity.ActiveReports.Web.v8, Version=8.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
<add verb="*" path="*.rdl" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web.v8, Version=8.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
<add verb="*" path="*.rdlx" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web.v8, Version=8.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
<add verb="*" path="*.ar8Web" type="GrapeCity.ActiveReports.Web.Handlers.WebCacheAccessHandler, GrapeCity.ActiveReports.Web.v8, Version=8.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
</httpHandlers>
|
See Also