ActiveReports Developer 7
Configure HTTPHandlers in IIS 7.x
See Also Support Forum
ActiveReports Developer 7 > ActiveReports Developer Guide > How To > Customize, Localize, and Deploy > Configure HTTPHandlers in IIS 7.x

Glossary Item Box

HttpHandlers are included in the Professional edition of ActiveReports to allow you to quickly and easily display reports in the browser.

Follow these steps to configure the ActiveReports HTTP handlers in IIS 7.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.

Classic Mode

If any part of your Web application is not supported in Integrated Mode, you can run it using the Classic .NET AppPool.

ShowTo run your Web application in the Classic .NET Application Pool

  1. In the Control Panel, open Administrative Tools, then Internet Information Services (IIS) Manager.
  2. In the Internet Information Services (IIS) Manager window that appears, in the left pane under Connections, expand the Sites node and select the Web application you want to configure.
  3. To the right of the Handler Mappings pane that appears, under Actions, click Basic Settings.
  4. In the Edit Site dialog that appears, click the Select button.
  5. In the Select Application Pool dialog that appears, drop down the Application pool, select Classic .NET AppPool, and click OK.
  6. Back in the Edit Site dialog, click OK to accept the changes.

ShowTo configure ActiveReports HTTP handlers to enable report linking in your Web applications

  1. In the Control Panel, open Administrative Tools, then Internet Information Services (IIS) Manager.
  2. In the Internet Information Services (IIS) Manager window that appears, in the left pane under Connections, expand the Sites node and select the Web application you want to configure.
  3. In the site's Home pane that appears, under IIS, double-click Handler Mappings.
  4. To the right of the Handler Mappings pane that appears, under Actions, click Add Script Map.
  5. In the Add Script Map dialog that appears, enter the information from the first row of the table below.
    Note: If you have a 64 bit app pool, add script mappings for the 64 bit version of the aspnet_isapi.dll by navigating to C:\Windows\Microsoft.NET\Framework64\v*\aspnet_isapi.dll.
    Request path Executable Name
    *.ar7 aspnet_isapi.dll version to match your app pool ActiveReports 7 Script Mapping
    *.ar7Web aspnet_isapi.dll version to match your app pool ActiveReports 7 Cache Item Script Mapping
    *.rpx aspnet_isapi.dll version to match your app pool ActiveReport 7 RPX Script Mapping
    *.rdlx, *.rdl aspnet_isapi.dll version to match your app pool ActiveReports 7 RDLX Script Mapping
  6. Click the Request Restrictions button and ensure that the Invoke handler only if request is mapped to check box is cleared.
  7. Click OK to close the window and add the script mapping.
  8. Repeat for each script mapping in the table above.

ShowTo add handlers without configuring IIS 7.x using the Classic .NET AppPool

  1. 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 ActiveReports 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="*.rpx" type="GrapeCity.ActiveReports.Web.Handlers.RpxHandler, GrapeCity.ActiveReports.Web.v7, Version=7.0.5252.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
      <add verb="*" path="*.rdlx, *.rdl" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web.v7, Version=7.0.5252.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
      <add verb="*" path="*.ar7" type="GrapeCity.ActiveReports.Web.Handlers.ReportBinariesStreamer, GrapeCity.ActiveReports.Web.v7, Version=7.0.5252.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
      <add verb="*" path="*.ar7Web" type="GrapeCity.ActiveReports.Web.Handlers.WebCacheAccessHandler, GrapeCity.ActiveReports.Web.v7, Version=7.0.5252.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
</httpHandlers>
  2. In your Web application, open the Web.config file and add code like the following between the <system.webServer> and </system.webServer> tags depending on the .Net Framework version 2.0 or 4.0 installed on your machine:

    Show.Net 2.0

    Paste inside the <system.webServer> tags. Copy Code 
    <handlers>
          <add name="AR7Rpx" path="*.rpx" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv2.0,bitness32"/>
          <add name="AR7Rdlx" path="*.rdlx" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv2.0,bitness32"/>
          <add name="AR7Rdl" path="*.rdl" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv2.0,bitness32"/>
          <add name="AR7" path="*.ar7" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv2.0,bitness32"/>
          <add name="AR7Web" path="*.ar7Web" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv2.0,bitness32"/>
    </handlers>

    Show.Net 4.0

    Paste inside the <system.webServer> tags. Copy Code 
    <handlers>
          <add name="AR7Rpx" path="*.rpx" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv2.0,bitness32"/>
          <add name="AR7Rdlx" path="*.rdlx" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv2.0,bitness32"/>
          <add name="AR7Rdl" path="*.rdl" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv2.0,bitness32"/>
          <add name="AR7" path="*.ar7" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv2.0,bitness32"/>
          <add name="AR7Web" path="*.ar7Web" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv2.0,bitness32"/>
    </handlers>

    Note: If you have a 64 bit Web application, change the preCondition attribute on each line to classicMode,runtimeVersionv2.0,bitness64, or in ASP.NET 4, change it to classicMode,runtimeVersion4.0,bitness64.

Integrated Mode

ShowTo configure ActiveReports HTTP handlers to enable report linking in your Web applications

  1. In the Control Panel, open Administrative Tools, then Internet Information Services (IIS) Manager.
  2. In the Internet Information Services (IIS) Manager window that appears, in the left pane under Connections, expand the Sites node and select the Web application you want to configure.
  3. In the site's Home pane that appears, under IIS, double-click Handler Mappings.
  4. To the right of the Handler Mappings pane that appears, under Actions, click Add Managed Handler.
  5. In the Add Managed Handler dialog that appears, enter the information from the first row of the table below.
    Request path Type Name
    *.ar7 GrapeCity.ActiveReports.Web.Handlers.ReportBinariesStreamer ActiveReports 7 integrated handler mapping
    *.ar7Web GrapeCity.ActiveReports.Web.Handlers.WebCacheAccessHandler ActiveReports 7 cache item integrated handler mapping
    *.rpx GrapeCity.ActiveReports.Web.Handlers.RpxHandler ActiveReports 7 RPX integrated handler mapping
    *.rdlx, *.rdl GrapeCity.ActiveReports.Web.Handlers.RdlxHandler ActiveReports 7 RDLX integrated handler mapping
  6. Click the Request Restrictions button and ensure that the Invoke handler only if request is mapped to check box is cleared.
  7. Click OK to close the window and add the handler mapping.
  8. Repeat for each handler mapping in the table above.

ShowTo add handlers without configuring IIS 7.x using the DefaultAppPool

In your Web application, open the Web.config file and add code like the following between the <system.webServer> and </system.webServer> tags, changing the ActiveReports Version number on each line to match the version installed on your machine.

Paste inside the <system.webServer> tags. Copy Code 
<handlers>
  <add name="*.rpx_*" path="*.rpx" verb="*" type="GrapeCity.ActiveReports.Web.Handlers.RpxHandler, GrapeCity.ActiveReports.Web.v7, Version=7.0.5252.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" preCondition="integratedMode,runtimeVersionv2.0" />
  <add name="*.rdlx_*" path="*.rdlx, *.rdl" verb="*" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web.v7, Version=7.0.5252.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" preCondition="integratedMode,runtimeVersionv2.0" />
  <add name="*.ActiveReport7_*" path="*.ar7" verb="*" type="GrapeCity.ActiveReports.Web.Handlers.ReportBinariesStreamer, GrapeCity.ActiveReports.Web.v7, Version=7.0.5252.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" preCondition="integratedMode,runtimeVersionv2.0" />
  <add name="*.ArCacheItem_*" path="*.ar7Web" verb="*" type="GrapeCity.ActiveReports.Web.Handlers.WebCacheAccessHandler, GrapeCity.ActiveReports.Web.v7, Version=7.0.5252.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" preCondition="integratedMode,runtimeVersionv2.0" />
</handlers>

Note: If you have a 64 bit Web application, change the preCondition attribute on each line to integratedMode,runtimeVersionv2.0,bitness64, or in ASP.NET 4, change it to integratedMode,runtimeVersion4.0,bitness64.

See Also

©2014. ComponentOne, a division of GrapeCity. All rights reserved.