Deploy Web Application

In This Topic

Follow this guide to deploy ActiveReports Web projects to your Web server. See the article from MSDN for more details.

To deploy ActiveReports Web projects, you must have access to the Microsoft .NET Framework version 4.6.2 or higher and the coordinating version of ASP.NET, or ASP.NET Core with .NET Core 3.1 and above. You must also have access to Internet Information Services version 8 or higher, and you need administrative access to the server.

It is also good to be sure that all of the packages you need for your reports are included.

Install prerequisites on the server

Follow Microsoft's instructions to install each of the following on your Web server:

The Microsoft .NET Framework version 4.6.2 or higher
ASP.NET version 4.6.2 or higher (must be the same version as the Framework)
ASP.NET Core with .NET Core 3.1 and above.
Internet Information Services (IIS) version 8

Map your application to a virtual directory

Make sure your project is deployed to a virtual directory in IIS.
To map requests from the page with the WebViewer control to your virtual directory, paste the <base> tag with a virtual directory name inside the <head> tag of the page containing the WebViewer control. In this case, all requests to back end assemblies will include the specified virtual directory name. For example,
```
    <head>
     <base href="/VirtDirName/">
    </head>
```

Set permissions on the server

Depending on your project, you may need to set permissions to allow ActiveReports access to data or folders.

Some examples of required permissions on the server:

If you are saving files (e.g. PDF or RDF exports) to a folder on Windows machines, the ASPNET user ID needs Write access to that folder.
Windows is user configurable, so use the name assigned to the ASPNET user instead.
If your application reads anything from any folder, assign Read access to it.
If your reports run on any networked data source (e.g. SQL, Access, etc.) assign Read access to it.

You can also deploy Report Parts by placing your Page and RDLX reports with report parts to the report items library. The path to this library is set in the ReportPartsDirectory property of the ActiveReports.config file; see Configure ActiveReports topic.

Report Parts is a Professional Edition feature that provides you with the possibility to reuse report parts (groups of controls with data and settings) from one report in other reports. For example, you can use Chart and Tablix data regions from Report1, and a Table data region from Report2 to create a new report.