ActiveReports 14 .NET Edition
ActiveReports 14 User Guide / How To / Localize and Deploy / Configure HTTPHandlers in IIS 8 and IIS 10
In This Topic
    Configure HTTPHandlers in IIS 8 and IIS 10
    In This Topic

    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 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. 

    Note: The WebViewer, the JSViewer, and the Web Designer are supported only in the Integrated pipeline mode. You will get  PlatformNotSupportedException on using these in Classic pipeline mode.

    Classic Mode

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

    To 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.

    To 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
      *.Web aspnet_isapi.dll version to match your app pool ActiveReports 14 Cache Item Script Mapping
      *.rpx aspnet_isapi.dll version to match your app pool ActiveReports 14 RPX Script Mapping
      *.rdlx aspnet_isapi.dll version to match your app pool ActiveReports 14 RDLX Script Mapping
      *.rdl aspnet_isapi.dll version to match your app pool ActiveReports 14 RDL 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.

    To add handlers without configuring IIS 8 and IIS 10 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, Version=14.x.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
          <add verb="*" path="*.rdl" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web, Version=14.x.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
          <add verb="*" path="*.rdlx" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web, Version=14.x.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
          <add verb="*" path="*.Web" type="GrapeCity.ActiveReports.Web.Handlers.WebCacheAccessHandler, GrapeCity.ActiveReports.Web, Version=14.x.xxxx.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 installed on your machine.

    .Net 4.x

    Paste inside the <system.webServer> tags.
    Copy Code
    <handlers>
    <add name="AR14Rpx" path="*.rpx" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.x\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.x,bitness32"/>
    <add name="AR14Rdlx" path="*.rdlx" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.x\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.x,bitness32"/>
    <add name="AR14Rdl" path="*.rdl" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.x\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.x,bitness32"/>
    <add name="AR14Web" path="*.Web" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.x\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.x,bitness32"/>
    </handlers>

    Note: If you have a 64 bit Web application, change the preCondition attribute on each line to classicMode,runtimeVersionv4.x,bitness64.

    Integrated Mode

    To 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
      *.Web GrapeCity.ActiveReports.Web.Handlers.WebCacheAccessHandler ActiveReports 14 cache item integrated handler mapping
      *.rpx GrapeCity.ActiveReports.Web.Handlers.RpxHandler ActiveReports 14 RPX integrated handler mapping
      *.rdlx GrapeCity.ActiveReports.Web.Handlers.RdlxHandler ActiveReports 14 RDLX integrated handler mapping
      *.rdl GrapeCity.ActiveReports.Web.Handlers.RdlxHandler ActiveReports 14 RDL 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.

    To add handlers without configuring IIS 8 or IIS 10 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
    <add verb="*" path="*.Web" type="GrapeCity.ActiveReports.Web.Handlers.WebCacheAccessHandler, GrapeCity.ActiveReports.Web, Version=14.x.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" name="AR14_WebCacheAccessHandler" resourceType="Unspecified" preCondition="integratedMode"/>
    <add verb="*" path="*.rpx" type="GrapeCity.ActiveReports.Web.Handlers.RpxHandler, GrapeCity.ActiveReports.Web, Version=14.x.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" name="AR14_RpxHandler" resourceType="Unspecified" preCondition="integratedMode"/>
    <add verb="*" path="*.rdl,*.rdlx" type="GrapeCity.ActiveReports.Web.Handlers.RdlxHandler, GrapeCity.ActiveReports.Web, Version=14.x.xxxx.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" name="AR14_RdlxHandler" resourceType="Unspecified" preCondition="integratedMode"/>

    Note: If you have a 64 bit Web application, change the preCondition attribute on each line to integratedMode,runtimeVersionv4.x,bitness64.