Collapse All Expand All

Manually Configuring Web Samples

In order to use ActiveReports HTTPHandlers on the Web with ASP.NET, you must first configure the machine to use the handlers. Please note that HttpHandlers are only enabled if you purchased the Professional Edition.

For information on how to configure ActiveReports handler mappings in IIS 7.x, see the section Configure Handler Mappings in IIS 7.x of this Guide. 

To configure the report layout (RPX) handler

1. In the Control Panel, open Administrative Tools, then Internet Information Services.
2. In the Internet Information Services window that appears, expand the tree view in the left pane until you see the the Web site that you need to configure. Right-click the Web site and select Properties.
3. On the Directory tab of the YourWebSite Properties dialog that appears, click the Configuration button.
4. In the Application Configuration dialog that appears, select the list item with .aspx in the Extension column and click the Edit button.

   Note: If your machine does not have the ASP.NET server components installed, the .aspx handler does not appear in the Application Mappings list.

5. In the Executable field, select and copy all of the text, and click Cancel to return to the Application Configuration dialog.
6. Click the Add button to add a new Application Mapping.
7. In the Add/Edit Application Extension Mapping window that appears, paste the value from the .aspx extension into the Executable field.
8. In the Extension field, enter .rpx.
9. Select the "Check that file exists" checkbox.
10. Click the OK button to add the mapping and return to the Application Configuration dialog.

To configure the compiled report handler

1. In the Application Configuration dialog, click the Add button to add a new Application Mapping.
2. In the Executable field, paste the value copied from .aspx above.
3. In the Extension field, enter .ActiveReport.
4. Clear the Check that file exists check box.
5. Click the OK button to add the mapping and return to the Application Configuration dialog.

To configure the WebCacheAccessHandler

1. In the Application Configuration dialog, click the Add button to add a new Application Mapping.
2. In the Executable field, paste the value copied from .aspx above.
3. In the Extension field, enter .ArCacheItem.
4. Clear the Check that file exists check box. 
5. Click the OK button to add the mapping and return to the Application Configuration dialog.
6. Click OK on the remaining open dialogs to exit the IIS Administrative tool.

See the topic Add Report Links to Web Forms (Pro Edition) for information on enabling the handlers in a Web Form.