How to import the latest BPC version into Mavim

Introduction

The Microsoft Business Process Catalog (BPC) is a set of business processes that describes what the Dynamics 365 applications support. Microsoft maintains and updates the BPC several times a year.
Mavim provides each new BPC release as an importable .mtdx file so you can use the catalog directly in your Mavim environment.

This article walks you through the steps to obtain the latest BPC version and import it into your Mavim database.

Step 1: Get the Mavim import file

To receive the newest BPC .mtdx file, contact your Mavim partner or account manager.
The file is roughly 600 MB. Once received, you can begin the import process.

Do this first if you already have a previous BPC version in your environment:

The December release introduces new fieldsets. Before importing, you must remove fieldset assignments from several topic types.

Follow these steps:

Open Mavim Manager and go to the Administration tab.
Select Administration Topic Types.
For the topic types Process, Task, Module, Primary Topic, and Meaning, remove the Assigned Fieldsets.
You can select multiple fieldsets within a topic type and remove them at once.
This may take a few minutes.

Step 2: Import the BPC into your Mavim environment

Download the .mtdx file shared with you. (Or download the latest version here)
Open Mavim Manager and select the database where you want to import the BPC.
In the blue top header, open the action toolbar and select File Transfer → Upload.
Upload the .mtdx file and wait for the upload to complete.
Go to the Modeling tab, select Import → Version, and locate the uploaded file.
Uploaded files appear on the TempDisk drive under This PC.
Select the file and choose Open.
Mavim will load the BPC into your purple cabinet under Imported Versions.
This may take a few minutes.
After import, you will see the BPC structure in the cabinet.
To start working with the process model, copy it into your yellow cabinet.
Right‑click the purple Business Process Catalog Export … topic and select Copy.
(* It is important that you select the purple, highest topic to transfer all the elements to your yellow cabinet)
Navigate to your yellow cabinet and paste it where you want it.
A good place is directly under the Relationship Categories topic.
Wait for the paste action to complete.
You now have the latest BPC available in your environment.
You can create a new version definition and publish it to your Mavim Portal or customize it further by adding fieldsets or processes.

What is included in the latest BPC version

The December release includes three main process structures.
You will also see two additional structures:

Dynamics 365 related categories: Includes security roles, applications, products, and other category information.
Navigation: Includes navigation pages such as the main Business Process Catalog start page.

Important notes

Removing old fieldsets is required only if your database already contains a previous BPC version.
Import and copy actions can take several minutes depending on environment size.
The .mtdx file must be uploaded before you can perform the version import.