IFS Business Reporter Execution Server

This page describes IFS Business Reporter Execution Server functionality. Prerequisites, installation information, configuration and limitations is also covered.

IFS Business Reporter Execution Server is an application/service running on a Microsoft OS. The main task is to enhance batch processing of IFS Business Reporter reports by uploading the report template, the MS Excel book, as well as the result set and then put it all together to a 100% ready MS Excel report. This means that that when the batch processing is done, the end user can open up the report from the report archive in IFS Applications and get it quickly loaded in MS Excel without having to wait for any processing.

If IFS Business Reporter Execution Server is not installed, all IFS Business Reporter specific reports that ends up in the report archive after a batch execution will be partly ready. When opened from the archive IFS Business Reporter will start and then the report data will be processed in order to render a complete report. Depending on the complexity of the report design and the amount of data the rendering may take a while to complete, something that might regarded as negative/irritating from the end users perspective. The solution is thus to set up and use IFS Business Reporter Execution Server.

Contents

 

Overview of the Solution

This is the architectural overview of IFS Business Reporter Execution Server:

Figure 1:Architectural Overview of IFS Business Reporter Execution Server

In short the process works as follows:

  1. An IFS Business Reporter report is ordered as a batch job.
  2. A background job will execute the data sets relevant for the current report instance and gather all information to a report result set called DSRD. The background job ends but the report execution is however not finalized. It will not be possible to open the report from the archive.
  3. The IFS Business Reporter Execution Server interacts with the Application Server to find out if there are any new reports to process.
  4. IFS Business Reporter Execution Server uploads the report layout and the result set (DSRD) by accessing the Application Server.
  5. Now MS Excel is started in automated mode. The report layout and the result set are processed, leading to a fully rendered report.
  6. The fully rendered report is sent back to the report archive and saved. IFS Business Reporter Execution Server ends it execution and starts looking for next report to process.
  7. Now it is possible to open up the fully rendered report from the report archive

Execution Mode Configuration

IFS Business Reporter Execution Server can be installed in two execution modes.

The default mode is (Microsoft Excel Based) VSTO mode.

Refer to this document for configuration options.

Benefits of Using IFS Business Reporter Execution Server

The main benefits you get by using the IFS Business Reporter Execution Server are:

General Activity Guideline

This section gives an overview of activities to be handled in order to set up and execute IFS Business Reporter Execution Server (BRES). See this as a check list of activities.

  1. Make sure to dedicate a separate computer as the host for the BRES
  2. It is highly recommended that a server OS is used. IFS do not recommend OS versions as e.g. Windows 7, Windows 8, Windows 10.
  3. Make sure that all prerequisites are taken care of
  4. Make sure that default folder is defined
  5. Install the IFS Business Reporter Execution Server
  6. Modify configuration settings if needed; handled in IFS EE
  7. Configure BI Services with respect to IFS Business Reporter Execution Server execution
  8. Start BRES Server Console and log on to the target IFS Applications instance
  9. In the IFS client (IFS EE or Aurena) order a Business Reporter report to be handled by IFS Business Reporter Execution Server; either a scheduled job or via Order Report. Which option to choose depends on how Business Reporting & Analysis services is configured.
  10. Monitor the IFS Business Reporter Execution Server Console and make sure that the ordered report is downloaded, processed and uploaded again successfully.
  11. Log off the IFS Business Reporter Execution Server
  12. Order a new report from the IFS client and make sure that it appears in the Report Archive (when ready)
  13. From the archive, open both instances of the report to make sure that it can be successfully opened (either as an Excel report or a PDF report)

 

Prerequisites

Please refer to the Business Reporting & Analysis Prerequisites page for more information about necessary prerequisites.

Defining Default Folder

The BR Execution Server server automates execution of MS Excel. This way of executing MS Excel is not encouraged by Microsoft.

In most cases the Operation System (OS) running on the server/computer hosting the execution server, will be at least Windows 7 or later. For all these OS versions there is a limitation that the automation does not work by default.

There are two known workarounds. One workaround means defining a folder named Desktop.

It is highly recommended to always define the Desktop folder to make sure that the BR Execution Server runs as expected.

Please read more about how to set this up in the Limitations section.

Installation

Note: It is recommended to install and run the IFS Business Reporter Execution Server on a separate computer. It does not have to be a server but the computer should preferably have as much memory as possible to avoid memory related problems and to be able to run many different Excel threads at the same time.

Before the installation

A detailed installation guideline is available via a separate BRES installation document.

 

Configuration and Startup

For more information how to configure and start the IFS Business Reporter Execution Server, please refer to the Configuration and Startup page.

Functionality

For more information about IFS Business Reporter Execution Server specific functionality, please refer to the Functionality page.

Known Limitations

For more information about IFS Business Reporter Execution Server specific limitations, please refer to the Known Limitations page.

Downloading Report Design and Data

The report template and data associated with a specific IFS Business Reporter report instances, can be downloaded from the IFS client:

  1.  Reports Queue tab in:
    1. BR Execution Server Admin Console - IEE
    2. BR Execution Server Admin Console - Aurena
  2. Reports queue:
    1. BR Execution Server Reports Queue - IEE
    2. BR Execution Server Reports Queue - Aurena
  3. General
    1. In IEE client by using RMB Get XML Data in the Report Archive window

      To be able to use this option it is necessary that the current user is granted the Administrator system privilege.

Being able to download the report design and the data associated with a specific IFS Business Reporter report execution is especially important in support situations, thus making it easy to communicate report details to a support organization.