Using and installing WebReportManX control

Description and use of WebReportManX ActiveX control

WebReportManX control is a plugin for Windows Internet Explorer (also available for Mozilla, maybe downloadable from, it allows you to preview or print server processed reports or Report Manager metafiles stored in web servers. Click here to obtain the plugin and view a sample report embedded in your Internet Explorer. It's about 600Kbytes in size. For the first time you should enable installation of unsigned ActiveX controls option in Internet Explorer, to Ask Permission. Alternatively you can download the WebReportman.ocx file and register it using regsvr32 command line.

You can obtain a Report Metafile using save command in preview window, executing web report server with metafile=1 parameter, executing printreptopdf with -m command line option.

For example you can execute a report using Report Manager web server in a Linux machine and preview it in an Internet explorer window. In the server you should place a html file with this content:

<title>Report Manager ActiveX plugin test</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">

<body bgcolor="#FFFFFF">
<table width="100%" border="0" height="100%">
<table width="100%" border="0" height="100%">
<td>Report Manager Web ActiveX Control Test Version 2.3</td>
<td height="100%"><object
<param name="Preview" value="1">
<param name="Port" value="80">
<param name="ShowProgress" value="1">
<param name="Embedded" value="1">
<param name="Install" value="0">
<param name="PrinterConfig" value="0">
<param name="Caption" value="Printing">
<param name="MetaUrl" value="">

See the codebase property of Object control contains the path to the installable .cab file that contains the .ocx control, ask version information for the .ocx file in windows explorer if you are not sure about the version.

When a Internet Explorer client reads this web page it reads the .cab file (you can also point to the .ocx file if available), looks for authenticode signature (currently the control have a root test signature) and then looks the security configuration, then ask the user to install the .ocx/.cab file in the client computer, take care that if you provide a not signed file, by default Internet explorer will not ask because default configuration does not allow installation of not signed ActiveX controls, so you must go to configuration and allow Downloading of unsigned ActiveX (ask data), see also if you have not Administrator rights it will not ask in some cases and wil not work.

The procedure of Internet explorer client setup happens only once, so when it's installed, all the users are available to use the new Installed ActiveX control, but a version change in the ActiveX control will require same procedure.

Important note: In Winfows XP Service Pack #2, the installation of plugins have limited to certificates provided byreally few entities (expensive ones), the plugin is signed by a Spanish certifier emited certificate, and does Windows Xp SP2 does not allow software install for this entity, you can use a alternative installation program that you can obtain in download program and place a message like: If the report does not print please download and install following software. The software installs and register the plugin.

Installing the WebReportManX control in the web server

Download the WebReportanX Activex component from sourceforge and unpack it to a directory usually windows system directory. It's included also in the Designer installation package.

Then place the .ocx or .cab (same but compressed and signed) in a web directory in the web server, for example in Windows IIS you should place it at c:\inetpub\wwwroot, in Linux in /usr/local/httpd/htdocs


Parameter name Description Default value

"0" To printer

"1" To screen

Port Port for obtaining the metafile "80"

Only valid when Preview="0"

"0" Don't show a dialog with print progress

"1" Show a dialog with the progress


Only valid when Preview="1"

"0" The preview will launch a new window, with a menu

"1" The preview will be embedded inside the defined box


"0" No effect

"1" Instead of printing, shows the Report Manager printers configuration dialog

Caption String showed while obtaining the report from the server ""

"0" No effect

"1" Instead of printing, use the MetaUrl parameter to obtain reportmanres.* localization files and install them in the client computer (must have administrator rights)

MetaUrl The location of the Report Metafile file, this can be a http link to a .rpmf file, generated using any utility or directly executing a Report Manager web report server adding metafile=1 option ""

Before begin printing it shows the standard print dialog to the end user

"0" Don't show the print dialog

"1" Show the print dialog

Copies When output to printer you can specify the number of copies to print "1"


For now WebReportManX component can only use http protocol, but you can change the port (not the protocol). Implementation of https protocol (SSL) can be done but requires some aditional work.