Versions (Master Data Services)

In Master Data Services, you can create multiple versions of the master data within a model. Each version you create contains all members, attribute values, hierarchy members, hierarchy relationships, and collections for the model.

Use versions to:

  • Maintain an auditable record of your master data as it changes over time.

  • Prevent users from making changes while you ensure all data validates successfully against business rules.

  • Lock down a model for use by subscribing systems.

  • Test different hierarchies without implementing them right away.


When you change the structure of your model, for example you create a new entity or domain-based attribute, this change applies to all versions. If you view an earlier version of the model, the entity or attribute is displayed, but no data exists.

When a version is ready for users or for a subscribing system, you can set a flag to identify the version. You can move this flag from version to version as needed. Flags help users and subscribing systems identify which version of a model to use.


Master Data Services uses the following workflow for version management:

  1. An initial version is created automatically when you create a model and populate the Master Data Services database with your company's master data. Based on permissions, users can make changes to this version as needed.

  2. When you want to commit a version of a model, lock the version so that only model administrators can update the data. For more information, see Administrators (Master Data Services).


    If notifications are configured, an e-mail notification is sent to model administrators each time the version's status changes. For more information, see How to: Configure E-Mail Notifications (Master Data Services).

  3. Apply business rules to the locked version's data and review any validation issues. If necessary, you can fill in missing information or revert the transaction that caused the issue. You can also unlock the version for users to make changes.

  4. When all the data passes validation, commit the version and flag it for use by subscribing systems. Changes cannot be made to a committed version.

  5. Copy the committed version and notify users that they can begin working in a new version of the model.


    A setting in Master Data Services Configuration Manager determines whether or not you can copy all versions or only those that are committed. This setting is also available in the System Settings table. For more information, see System Settings (Master Data Services).

You can create sequential or simultaneous versions of your model.

Sequential Versions

Each time you commit a version, you can create a new copy and give the version the next sequential number. For example, you can copy Version 7 of your model and name the copy Version 8.

Simultaneous Versions

You can create simultaneous versions of your model when you want to work on two or more versions of your data at once. This is useful when your company has reorganizations or mergers that coincide with the normal course of business and you want to determine how the new master data might fit into your existing structures.