ActiveReports 6 Online Help
Configure Handler Mappings in IIS 7.x
See Also Send comments on this topic.
ActiveReports 6 > ActiveReports User Guide > How To > Customize, Localize and Deploy > Configure Handler Mappings in IIS 7.x

Glossary Item Box

Follow these steps to configure the ActiveReports handler mappings in IIS 7.x for running ActiveReports Web Applications on your machine.

ShowTo configure the ActiveReports handler mappings in IIS 7.x to run ActiveReports Web Applications on your machine (classicMode)

  1. In the Control Panel, open Administrative Tools, then Internet Information Services Manager.
  2. In the Internet Information Services window that appears, expand the tree view in the left pane until you see the Web application you need to configure.
  3. Select the node for your application. The Features View pane is displayed.
  4. Double-click Handler Mappings in the Features View pane.
  5. On the Actions pane, click Add Script Map...
  6. In the Add Script Map dialog box that appears, enter the following information:

    Request path:*.ActiveReport

    Executable: To choose the executable, depending on your version of the .NET Framework, see the table below.

    Version of .NET Framework Executable
    ASP.NET 2.0 (32 bit version) C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll
    ASP.NET 2.0 (64 bit version) C:\Windows\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll
    ASP.NET 4 (32 bit version) C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll
    ASP.NET 4 (64 bit version) C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll

    Name: ActiveReport Script Mapping

    Note: If you have a 64 bit machine, you need to add script mappings for the 64 bit version for aspnet_isapi.dll (C:\Windows\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll) in the same way as it has been done for the 32 bit version in the web.config file.

  7. Click the Request Restrictions… button and make sure the "Invoke handler only if request is mapped to:" check box is not selected.

  8. Click OK to close the Add Script Map window.

  9. Repeat steps 5-8 to add another script mapping.

    Enter the following information for the second script mapping (see the step 6 above):

    Request path:*.ArCacheItem

    Executable: To choose the executable, depending on your version of the .NET Framework, see the table below.

    Version of .NET Framework Executable
    ASP.NET 2.0 (32 bit version) C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll
    ASP.NET 2.0 (64 bit version) C:\Windows\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll
    ASP.NET 4 (32 bit version) C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll
    ASP.NET 4 (64 bit version) C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll

    Name: ActiveReport Cache Item Script Mapping

    Note: If you have a 64 bit machine, you need to add script mappings for the 64 bit version for aspnet_isapi.dll (C:\Windows\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll) in the same way as it has been done for the 32 bit version in the web.config file.

  10. Repeat steps 5-8 to add the last required script mapping. For the step 7 above, make sure the "Invoke handler only if request is mapped to:" and the "File" check boxes are selected.

    Enter the following information for the third script mapping (see the step 6 above):

    Request path:*.rpx

    Executable: To choose the executable, depending on your version of the .NET Framework, see the table below.

    Version of .NET Framework Executable
    ASP.NET 2.0 (32 bit version) C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll
    ASP.NET 2.0 (64 bit version) C:\Windows\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll
    ASP.NET 4 (32 bit version) C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll
    ASP.NET 4 (64 bit version) C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll

    Name: ActiveReport RPX Script Mapping

    Note: If you have a 64 bit machine, you need to add script mappings for the 64 bit version for aspnet_isapi.dll (C:\Windows\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll) in the same way as it has been done for the 32 bit version in the web.config file.

ShowTo configure the ActiveReports handler mappings in IIS 7.x to run ActiveReports Web Applications on your machine (integratedMode)

  1. In the Control Panel, open Administrative Tools, then Internet Information Services Manager.
  2. In the Internet Information Services window that appears, expand the tree view in the left pane until you see the Web application you need to configure.
  3. Select the node for your application. The Features View pane is displayed.
  4. Double-click Handler Mappings in the Features View pane.
  5. On the Actions pane, click Add Managed Handler...

  6. In the Add Managed Handler dialog box that appears, enter the following information:

    Request Path: *.ArCacheItem

    Type: DataDynamics.ActiveReports.Web.Handlers.WebCacheAccessHandler

    Name: ar_arcacheitem-integrated

  7. Click the Request Restrictions… button and make sure the "Invoke handler only if request is mapped to:" check box is not selected.
  8. Click OK to close the Add Managed Handler window.

  9. Repeat steps 5-8 to add another script mapping.

    Enter the following information for the second script mapping (see the step 6 above):

    Request path:*.ActiveReport

    Type: DataDynamics.ActiveReports.Web.Handlers.CompiledReportHandler

    Name: ar_activereport-integrated

  10. Repeat steps 5-8 to add another script mapping. For the step 7 above, make sure the "Invoke handler only if request is mapped to:" and the "File" check boxes are selected.

    Enter the following information for the third script mapping (see the step 6 above):

    Request path:*.rpx

    Type: DataDynamics.ActiveReports.Web.Handlers.RpxHandler

    Name: ar_rpx-integrated

ShowTo check whether your Web Application is running in the Classic .NET Application Pool

  1. In the Internet Information Services Manager, select your Web Application in the Connections panel.
  2. In the Actions pane, click Basic Settings.... The Edit Application window will appear.
  3. In the Edit Application window, click the "Select..." button.
  4. In the drop-down box, select Classic .NET AppPool, then click OK.
  5. Click OK in the Edit Application window to accept the changes.

ShowTo add handlers without configuring IIS 7.x when your Application pool is Classic .NET AppPool (classicMode)

In the <system.web> tag, paste the following code. Copy Code
    <httpHandlers>
      <add verb="*" path="*.rpx" type="DataDynamics.ActiveReports.Web.Handlers.RpxHandler, ActiveReports.Web, Version=6.0.2019.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
      <add verb="*" path="*.ActiveReport" type="DataDynamics.ActiveReports.Web.Handlers.CompiledReportHandler, ActiveReports.Web, Version=6.0.2019.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
      <add verb="*" path="*.ArCacheItem" type="DataDynamics.ActiveReports.Web.Handlers.WebCacheAccessHandler, ActiveReports.Web, Version=6.0.2019.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" />
    </httpHandlers>
IMPORTANT: Change the Version number in the pasted code to match the version installed on your machine.
In <system.webServer> tag, paste the following code. Copy Code
    <handlers>
      <add name="ar rpx" path="*.rpx" verb="*" modules="IsapiModule" scriptProcessor="C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" resourceType="Unspecified" preCondition="classicMode,runtimeVersionv2.0,bitness32" />
      <add name="ar cache" path="*.ArCacheItem" verb="*" modules="IsapiModule" scriptProcessor="C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" resourceType="Unspecified" preCondition="classicMode,runtimeVersionv2.0,bitness32" />
      <add name="AR" path="*.ActiveReport" verb="*" modules="IsapiModule" scriptProcessor="C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" resourceType="Unspecified" preCondition="classicMode,runtimeVersionv2.0,bitness32" />
    </handlers>

Note: If you have a 64 bit machine, you need to update the code in all three handlers above as follows:

  1. Change the scriptProcessor path for the aspnet_isapi.dll to "C:\Windows\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll".
  2. Change the preCondition attribute to "classicMode,runtimeVersionv2.0,bitness64".
  3. In ASP.NET 4 (ClassicMode), change the preCondition attribute to "classicMode,runtimeVersion4.0,bitness64".

IMPORTANT: Ensure that the .NET Framework Version number in the pasted code matches the version installed on your machine.

ShowTo add handlers without configuring IIS 7.x when your Application pool is DefaultAppPool (integratedMode)

In the <system.web> tag, paste the following code. Copy Code
    <handlers>
      <add name="*.ArCacheItem_*" path="*.ArCacheItem" verb="*" type="DataDynamics.ActiveReports.Web.Handlers.WebCacheAccessHandler, ActiveReports.Web, Version=6.0.2019.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" preCondition="integratedMode,runtimeVersionv2.0" />
      <add name="*.ActiveReport_*" path="*.ActiveReport" verb="*" type="DataDynamics.ActiveReports.Web.Handlers.CompiledReportHandler, ActiveReports.Web, Version=6.0.2019.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" preCondition="integratedMode,runtimeVersionv2.0" />
      <add name="*.rpx_*" path="*.rpx" verb="*" type="DataDynamics.ActiveReports.Web.Handlers.RpxHandler, ActiveReports.Web, Version=6.0.2019.0, Culture=neutral, PublicKeyToken=cc4967777c49a3ff" preCondition="integratedMode,runtimeVersionv2.0" />
      <add name="ar rpx" path="*.rpx" verb="*" modules="IsapiModule" scriptProcessor="C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" resourceType="Unspecified" preCondition="classicMode,runtimeVersionv2.0,bitness32" />
      <add name="ar cache" path="*.ArCacheItem" verb="*" modules="IsapiModule" scriptProcessor="C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" resourceType="Unspecified" preCondition="classicMode,runtimeVersionv2.0,bitness32" />
      <add name="AR" path="*.ActiveReport" verb="*" modules="IsapiModule" scriptProcessor="C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" resourceType="Unspecified" preCondition="classicMode,runtimeVersionv2.0,bitness32" />
    </handlers>

Note: If you have a 64 bit machine, you need to update the code in all three handlers above as follows:

  1. Change the scriptProcessor path for the aspnet_isapi.dll to "C:\Windows\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll".
  2. Change the preCondition attribute to "classicMode,runtimeVersionv2.0,bitness64".
  3. In ASP.NET 4 (ClassicMode), change the preCondition attribute to "classicMode,runtimeVersion4.0,bitness64".
IMPORTANT: Change the Version number in the pasted code to match the version installed on your machine.
In the <system.webServer> tag, paste the following code. Copy Code
<handlers>                
      <add name="ar rpx" path="*.rpx" verb="*" modules="IsapiModule" scriptProcessor="C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" resourceType="Unspecified" preCondition="classicMode,runtimeVersionv2.0,bitness32" />
      <add name="ar cache" path="*.ArCacheItem" verb="*" modules="IsapiModule" scriptProcessor="C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" resourceType="Unspecified" preCondition="classicMode,runtimeVersionv2.0,bitness32" />
      <add name="AR" path="*.ActiveReport" verb="*" modules="IsapiModule" scriptProcessor="C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll" resourceType="Unspecified" preCondition="classicMode,runtimeVersionv2.0,bitness32" />
</handlers>

Note: If you have a 64 bit machine, you need to update the code in all three handlers above as follows:

  1. Change the scriptProcessor path for the aspnet_isapi.dll to "C:\Windows\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll".
  2. Change the preCondition attribute to "classicMode,runtimeVersionv2.0,bitness64".
  3. In ASP.NET 4 (ClassicMode), change the preCondition attribute to "classicMode,runtimeVersion4.0,bitness64".

IMPORTANT: Ensure that the .NET Framework Version number in the pasted code matches the version installed on your machine.

See Also