BPM Country Reports

Reports Upgrade

This section is valid through Maconomy 2.4.5. From Maconomy 2.4.6 APU and higher, ensure that the Maconomy standard extension is installed and go to Reports Setup section.

Note: This only applies to upgrades from IA SPU to another SPU version or from SPU to APU version.

To upgrade the Statutory Reports from either a major or a CU version, follow the instructions below:

Workflow of Upgrade

Uninstallation of BPM IA SPUs
Update Registry for Maconomy
Reinstallation of Standard Extensions

Uninstallation of Existing BPM IA SPUs

To be able to fully uninstall BPM Statutory Reporting extensions, please note the following parameters:

  • “ - -uninstall-extensions” - This Command only uninstalls custom extensions.
  • “ - - override-extension-features” - This Command used in conjunction with the above command but has the <feature_id> parameter.
  • “<feature_id> parameter” - This is used to get the feature ID of the IA SPU, we need to:
    1. Extract the SPU itself to .tar then to folder level.
    2. Go to the path and unzip “..\CustomInstallation\JavaExtensions\ia.UKTaxSubmission.extensions.zip”.
    3. In the folder, open content.xml.
    4. Copy the unit ID with the feature.group suffix.

      For example: "com.maconomy.ia.UKTaxSubmission.container.extensions.feature.group"

      Note: There will be other unit IDs per project; we need the unit ID of the whole feature.
    5. Once done, follow the instructions below.

Example of uninstallation of an IA SPU (UK MTD statutory):

  1. Run the command prompt as administrator.
  2. Go to <Maconomy_INST_DIR>\<shortname>\CouplingService (Or where the CouplingService of the said Maconomy installation is located).

  3. Run this command (feature ID is only an example):

    “CouplingService.exe --uninstall-extensions --override-extension-features com.maconomy.ia.UKTaxSubmission.container.extensions.feature.group -console –noexit”

  4. Check if the plugins are already removed in the plugins folder. Otherwise, remove the uktaxsubmission and reporting.bpm.util in the plugins folder. Remove other files and folders related to the IA SPU (UK MTD statutory):
    1. Delete the .zip package in the \CustomInstallation\JavaExtensions directory of the SPU, for example, ia.UKTaxSubmission.extensions.zip.
    2. Go to <Maconomy_INST_DIR>\<shortname>, and delete the folder with the same name as the .zip package, for example, ia.UKTaxSubmission.extensions.
    3. Go to <Maconomy_INST_DIR>\<shortname>\CustomizationDir, and delete the Custom folder.
  5. Restart the Coupling Service.
    Note: The IA SPU name would be the same as the unit ID of the released BPM IA SPU. So for example the file spu.20_0.ia_BPMStatutoryReporting244CU13.sp104.tgz would have a feature ID of com.maconomy.ia.BPMStatutoryReporting244CU13.container.extensions.feature.group.

    This only pertains to removing the Java Extensions. The manual deletion of Workspace definition files and Dialog Layouts is a different story. You would still need to do that to completely wipe out remnants of the SPU.

  6. Make sure that Workspace Definition and Dialog Layout files for BPM Statutory and UK Tax Submission are removed.
  7. In the Maconomy Workspace Client, clear the Client Caching under Preferences.
  8. Restart the Workspace Client.

Update Registry of BPM IA SPUs for Maconomy

To remove further remnants of old version of BPM Statutory or UK MTD IA SPUs, follow the instructions below:

  1. Run the Registry Editor.
  2. Navigate to the folder: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PPU Maconomy\MaconomyInstallation\Server\Applications\<maconomy shortname>\OSGiProducts\Setup\<Coupling Service name>
  3. Find the InstalledJavaExtensions key value and edit.
  4. Remove all instances of previous versions for BPMStatutoryReporting and/or UKTaxSubmission.

Installation of New BPM IA SPUs (SPU to SPU)

This is only applicable until 2.4.4 CU 22 and 2.4.5 CU 25.

For upgrading to versions 2.4.4 CU 21 and lower, and 2.4.5CU24 and lower, follow the steps below:

  1. Run MConfig as Administrator.
  2. Select the shortname from which you want to install the new BPM IA SPUs.
    Note: Installation of both BPMStatutoryReporting and UKTaxSubmission would require doing the succeeding steps twice.
  3. Install the new version of BPMStatutoryReporting or UKTaxSubmission IA SPU.
  4. Verify that the BPM Statutory Reporting and/or UKTaxSubmission jar files has been installed:

    For BPM Statutory Reporting:

    com.deltek.maconomy.bpm.belgium.ico_<automatically_generated_version_number>.jar
    com.deltek.maconomy.bpm.belgium.lk_<automatically_generated_version_number>.jar
    com.deltek.maconomy.bpm.belgium.tva_<automatically_generated_version_number>.jar
    com.deltek.maconomy.bpm.france.aef_<automatically_generated_version_number>.jar
    com.deltek.maconomy.bpm.norway.nsaft_<automatically_generated_version_number>.jar
    com.deltek.maconomy.bpm.sweden.sie_<automatically_generated_version_number>.jar
    com.deltek.maconomy.bpm.util_<automatically_generated_version_number>.jar

    For UK Tax Submission:

    com.deltek.maconomy.bpm.uktaxsubmission_<automatically_generated_version_number>.jar
    com.deltek.maconomy.reporting.bpm.util_<automatically_generated_version_number>.jar

  5. Verify that the Dialog Layouts and Workspace Definition files have been installed successfully under the CustomizationDir/Extension folder.

Upgrade from SPU to APU

For versions 2.4.4 CU 21 and lower, and 2.4.5 CU 24 and lower upgrading to 2.4.6 or higher of standard extensions, follow the instructions below.

  1. Run MConfig as Administrator.
  2. Edit the application name.
  3. Scroll down and click OSGI Products.
  4. Edit the Coupling Service used by the application.
  5. Scroll down to (Re) install Java Extensions and select MaconomyDir\JavaExtensions.
  6. Click OK up until the top dialog.
  7. Click Next » Next to install the changes.