Configure HTTPHandlers in IIS 6

Show All

Hide All

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.

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.
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.	.AR12	Clear this checkbox.
Paste the text copied from the *.aspx script map.	.AR12Web	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.

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=".AR12" type="GrapeCity.ActiveReports.Web.Handlers.ReportBinariesStreamer, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" /> <add verb="" path=".ActiveReport" type="GrapeCity.ActiveReports.Web.Handlers.CompiledReportHandler, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" /> <add verb="" path=".rpx" type="GrapeCity.ActiveReports.Web.Handlers.RpxHandler, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" /> <add verb="" path=".rdl" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" /> <add verb="" path=".rdlx" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" /> <add verb="" path=".AR12Web" type="GrapeCity.ActiveReports.Web.Handlers.WebCacheAccessHandler, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" /> </httpHandlers>

Paste inside the <system.web> tags.

Copy Code

<httpHandlers>
    <add verb="*" path="*.AR12" type="GrapeCity.ActiveReports.Web.Handlers.ReportBinariesStreamer, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
    <add verb="*" path="*.ActiveReport" type="GrapeCity.ActiveReports.Web.Handlers.CompiledReportHandler, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
    <add verb="*" path="*.rpx" type="GrapeCity.ActiveReports.Web.Handlers.RpxHandler, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
    <add verb="*" path="*.rdl" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
    <add verb="*" path="*.rdlx" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
    <add verb="*" path="*.AR12Web" type="GrapeCity.ActiveReports.Web.Handlers.WebCacheAccessHandler, GrapeCity.ActiveReports.Web.v12, Version=12.0.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
</httpHandlers>