Skip to main content
Matrix42 Self-Service Help Center

Important or Breaking Changes

Please ensure to review all information about important or breaking changes provided with all versions that have been released since the version your are updating. 

Version 10.0

.NET Framework Version Update to 4.7.2 

The Product .NET framework version is elevated to the latest released version 4.7.2.  This change could impact the custom assemblies which have been previously installed on Product and reference the Product assemblies of the strict version. To avoid potential problems it is recommended to at least to check the custom assemblies still working on a version 10 and above, or better, rebuild all such assemblies with .NET 4.7.2 Framework.

Also in a new Product version, some 3d Party libraries (Nuget packages) has been updated to a newer version.  If you using these libraries in your Projects please recompile these assemblies to guarantee they are compatible with the new Product. 


Previous Version

Version in 10.0.0








Version 9.1 Update 3

Workflow Worker

Workflow Worker is a Windows Service introduced in the version 9.1.2 as Technical Preview. More details can be found in Workflow Engine.

By default, the Workflow Worker is not installed by the Setup, and in case it was not installed manually the breaking change is not affected, and the actions list can be ignored. Otherwise, the Worker needs to be manually updated.

  1. Stop "Matrix42 Workflow Workers" Windows Service before Matrix42 Workplace Management update.
  2. Update Matrix42 Workplace Management.
  3. Clean up Workflow Worker directory
  4. Follow the Install Worker instructions to  install new version of the Worker

The concept of the Workflow Worker presumes the Workflow Worker is self updated whenever the relevant resources on the Application Server are updated,  means in future Product updates the Workers will be updated automatically regardless of the way they have been installed. 

Version 9.1 Update 2

License Metering

With this new release, our software supports you in auditing your Matrix42 software licenses. The software now has a function that requests information about the licensing of the Matrix42 software at regular intervals and transmits the number of licenses used (by devices and users) to us. Personal data is not collected. The data transmitted with each process can be viewed on the server in the 'metering' sub-directory.

Further details can be found in the product documentation.

Version 9.1 Update 1

SaaS Compliance Data Provider

Installed data provider from SaaS Compliance subscription (Office 365 and Adobe Creative Cloud) needs to be updated after upgrading your environment to version 9.1.1.

Configuration of Remote Usage Tracking

Configuration of Remote Usage Tracking Agent is now made in settings for "License" application and not directly in config-files anymore. Accordingly make sure that your settings are correct, if you are using Remote Use Tracking Agent in your environment.

Please refer to online help for details about configuration.

Compatibility of Empirum SDK

Due to a breaking change in Empirum SDK v1.20 compatibility with earlier versions is affected.

Be careful when using Empirum SDK of earlier versions with PowerShell activities in workflows! 

Since Software Asset & Service Management 9.1 Update 1 installs Empirum SDK version 1.20 coexistence with previous version may lead to execution errors!
Don't be confused if your scripts run nicely inside PowerShell IDE. This is misleading.



  1. Adjust your PowerShell scripts to match with SDK 1.20 and remove old SDK-version (recommended!)
  2. Manually remove SDK 1.20 after updating to Software Asset & Service Management 9.1 Update 1

Version 9.1

.NET Framework changed

Please note that this version was compiled with .NET Framework 4.6.1 for the first time. Please ensure it is available on your server prior to installing the product. Setup of the .NET Framework is contained in the REDIST file provided with this release. Please note that users of Workflow Studio need this .NET version also on their client device.

Service Desk – 2 new configurations added

Two new configuration settings have been added to allow better information handling on new received data. The two options, defined in the Service Desk – Settings area, are

  1. Mark ticket as "New information received" when adding Journal entry (enabled by default)
  2. Mark ticket as "New information received" when adding Journal entry by responsible person (disabled by default)

Especially the second option might result in changed behavior on filters checking the new information status.

Version 9.0 Update 4

Removed Exception (for Developers only)

“PandoraException” was moved from Matrix42.Pandora.Contracts to Matrix42.Common. If you have already used “PandoraException” in your projects, please change the namespaces in all usages.

Version 9.0 Update 2

User Profile

"Users are not able to change their data in User Profile"

This change comes from a bug fix. Setting, that was always present, saying "Allow Users to Change Personal Data" was not working in UUX. Now it is considered, and can be changed by customer

Workflows will be validated during update

Setup contains new feature validating existing workflows to avoid unexpected failures during their execution. This validation checks if workflows have references to components that are missing on the environment or have a wrong version.

If validation detects a corresponding issue, a message is displayed:


There are two options to deal with this issue:

  • Instant Fix
    • Keep small message box with caption “Skip” open
    • Deploy required but missing component
    • Click ‘No’ on small message box to repeat validation
  • Subsequent Fix
    • Click ‘Yes’ on small message box with caption “Skip” to skip validation
    • Continue with the setup
    • Deploy required but missing component after the setup has finished

We recommend first option.

More details can be found in online help.

Office 365 Data Provider

In case you have installed the data provider for Office 365, please download new version of this data provider from Matrix42 Marketplace and install it after updating your environment.

Version 9.0 Update 1

Auto-Migration of Volume License Agreements

Please note that with upgrading your environment to this version, existing volume license agreements of following types are automatically migrated to CI “Volume License Agreement”:

  • Microsoft Enterprise Agreement
  • Microsoft Enterprise Enrolment
  • Microsoft Select Agreement
  • Microsoft Select Enrolment
  • Adobe CLP Agreement
  • General Volume License Agreement

Automatic migration will not copy data records, but just change the type (Configuration Item). Object-ID and any other data remains untouched.

In case obsolete Configuration Items from above have been customized, having added Data Definitions to them, make sure that these Data Definitions are also present in CI “Volume License Agreements” prior to updating. Otherwise migration will fail for those records.

Version 9.0

SQL Server 2008 R2 not supported anymore

With product version 9.0 we do not support SQL Server 2008 R2 anymore. If you operate your environment on this SQL Server make sure you update your SQL Server to one of the supported versions prior to updating your environment to this product version.

Also please check system requirements in our online help.

Version 8.1 Update 7

Workflow Activity "UpdateObjects"

Implementation of workflow activity "UpdateObjects" was changed. Parameters validation becomes stricter so custom workflows that use this activity may fail in case of passed "Object IDs" is not related to specified "CI Type". Please review your custom workflows before updating to version 8.1.7 or higher.

Filter in UUX Navigation

With previous product version 8.1.7 we changed behavior of filters in UUX navigation.

New Behavior:

If a user, who belongs to Administrators role, creates new navigation filter:

  • This user will not be set as Owner of this filter anymore
  • This user will now be added to the Audience that is able to see that filter

Previous Behavior:

  • Any user sees all filters in navigation that are marked as “to-be-shown in navigation” where user has access through the Audience setting or the user is the owner of respective filters.
  • If a user creates a new filter for navigation, this user was previously automatically set as “Owner” of that filter.
  • In case that a user creates a filter as an administrator and shares it with all other users – there was previously no way to hide this filter from his personal navigation.
  • Migration:

If you update an existing system with product version 8.1.7, all owners are removed from those navigation filters where the current owner is in role Administrators. In addition, the corresponding user will be added to the audience entry. As a result, member of role Administrator will still see same filters in navigation as before update, but he will be able to hide for himself specific one using action Audience.

In addition, Administrator can use Administration => Search Filters to create new or configure existing filters.

Version 8.1 Update 4

CI Approval and ChangeApproval

With previous product version 8.1.4, the structure of “Approval” and “ChangeApproval” CI have been changed for performance improvement reasons. Both CI do not include Data Definition SPSActivityClassBase anymore.

Relevant attributes have been moved to SVCApprovalTaskClassBase instead: 

Data Definition
















Version 8.1

Deny Logon

Since product version 8.1.0, only accounts with a status that is equal to Active (2001) and with the unselected Deny Workspace Management Logon checkbox are allowed to log in toMatrix42 Workspace Management. Prior to that version, all accounts with a status value other than Deleted (2004) and with the unselected Deny Workspace Management Logon checkbox were allowed to log in to Matrix42 Workspace Management.


  • Was this article helpful?