BPM Country Reports

Reports Setup

To use statutory reports for any country, you must first set them up using the instructions below.

Beginning with 2.4.3, you must set up the Maconomy system parameters and coupling service to run all statutory reports.
Note: Proper setup must be followed or statutory reports will not work as intended.

Workflow for Setup

Set data export path and server timeout
Update system parameters for BPM
Enable Background Task
Additional SSI Setup
Restart programs
Follow country-specific instructions
Set Data Export Path and Server Timeout
  1. In the Maconomy installation folder, go to the designated Coupling Service configuration folder in relation to the Maconomy shortname. (that is, C:\Maconomy\<Maconomy Install DIR>\CouplingService\Configuration\Settings).
  2. Select and open the Extension.ini file.
  3. Locate server.timeout and change the value from 600 (default for 10 minutes) to 2400 (40 minutes).
  4. Locate filepath.<file-path-id> = <file path>. This will serve as a template to the BPM export path.
  5. Create a new uncommented line following the template above and with the file path ID as bpmexportpath (for example, filepath.bpmexportpath.<Shortname of Maconomy installation>=C:\BPMSTATFOLDER).
  6. Make sure that system.maintenance is set to false.
  7. Save the file.
  8. Restart the coupling service.

For Maconomy versions 2.4.5, 2.5, and 2.5.1, you may encounter an error ("The system cannot find the path specified.") while trying to generate a report. The background task does not create the BPMSTATFOLDER folder automatically.

To manually create the export folder:

  1. On the system where the coupling server is hosted, locate the Maconomy folder.

    For example on a Windows system, go to C:\Maconomy.

  2. Create the folder BPMSTATFOLDER.

    Stick to upper case or lower case for the folder name to make sure it runs properly across operating systems.

Update System Parameters for BPM

The statutory reports need to connect to a SAP BusinessObjects Server with the installed BPM package to be able to run.

To set up these system parameters:

  1. Open the Setup » System Setup workspace.
  2. Go to the Parameters and Numbers » System Parameters to view the System Parameters tab.
  3. Look for two BPM parameters. They should have 'BPM' in the Description text.
  4. Select each parameter and update the URL textbox with the appropriate http://Servername:Port.
  5. Save both parameters.
  6. Restart the Workspace Client.
  7. BPM Statutory reports can now be seen on the path: Reporting » Statutory Reporting.
Enable Background Task

The statutory reports run as background tasks to extract huge amounts of data without compromising simultaneous entry in the Workspace Client. Background Tasks are enabled by default. Set the task duration as described below.

To set the Task Duration:

  1. Go to Setup » Background Tasks » Management » System Defaults.
  2. In Default Max. Task Duration, enter 40 minutes.
Additional SSI Setup

In addition to the Silent Sign In (SSI) Setup detailed in the Maconomy System Admin Guide, additional steps are necessary to allow Trusted Authentication in REST API to run the statutory reports.

To configure Trusted Authentication for statutory reports:

  1. On the BO server, log in to the Central Management Console (CMC) with administrative rights.
  2. Go to Servers area of the CMC Client and open the properties for the Web Application Server.
  3. In the Command Line Parameters textbox, look for the parameter -Dbobj.trustedauth.home and note down its corresponding value. (for example, "-Dbobj.trustedauth.home=C:/Program Files (x86)/SAP BusinessObjects/SAP BusinessObjects Enterprise XI 4.0/java/pjs/container/bin")
  4. Go to the Authentication Management area of the CMC Client, and on the Enterprise tab, scroll down to the Trusted Authentication section.
  5. Under Trusted Authentication:
    1. Click Trusted Authentication is enabled.
    2. Click New Shared Secret.
    3. Enter the number of days for the Shared Secret Validation Period and timeout for the Trusted Authentication request.
    4. Click Update to save the settings.
    5. Reopen the Enterprise tab.
    6. Click Download Shared Secret. The File Download dialog box displays.
    7. Click Save and copy the TrustedPrincipal.conf file to:

      <INSTALLDIR>\SAP BusinessObjects Enterprise XI 4.0\win32_x86\
      <INSTALLDIR>\SAP BusinessObjects Enterprise XI 4.0\win64_x64\
      The Trusted Authentication Home folder as mentioned in Step 3 (for example C:/Program Files (x86)/SAP BusinessObjects/SAP BusinessObjects Enterprise XI 4.0/java/pjs/container/bin).

    8. Restart the SIA.
Note: There is a chance the generated Shared Secret will be too long and will cause an unnecessary line break. If this happens, generate a new Shared Secret.

After this is completed, you must enable Trusted Authentication on the Coupling Service. To do so:

  1. Update the OSGi settings in MConfig.
  2. Select the Trusted Authentication check box, and then copy the value of the shared secret inside TrustedPrincipal.conf to the Password from the preceding list.
Restart Programs

After SSI setup, you must restart the following programs:

  1. Tomcat
  2. Server Intelligence Agent (SIA)
Follow Country-Specific Instructions
  1. Click Ctrl + F to search for the country.
  2. Follow the country-specific setup instructions as needed.