You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.


Blueriq version management helps you keep track of and provide control over changes to your models. Version Control Management (VCM) is the management of changes to projects. It ensures that multiple business engineers can make different changes without interfering with each others work, that there always is a releasable version of the project and that the project can be released, even if not all features have been implemented.

User roles may apply to version management, for instance privileges to create or modify branches.

Please refer to the Version management guide in the Blueriq Knowledge Base to learn more about version management.


Blueriq projects consist of modules and are part of branches, that form a repository. These concepts are explained in the visual shown below.

The visual does not aim to be complete, but to provide insight.

Links in the image
VersioningProject Module

Project distribution: Package


Repository can be viewed upon as a sort of file folder where all your application development is stored.

If you are authorized to do so, you can create, edit and delete a repository. This can all be done from the navigation panel.

Create a repository

To create a repository,

  1. Select the repository menu from the navigation menu ()
  2. Select "+ New repository"
  3. Fill in a repository name, initial branch name, and initial commit message
  4. Select "Create"


NameName of the repository, e.g. the functional name of your application
Initial branch nameThe first branch, e.g. "Trunk"
Initial commit messageMessage to register the creation of the repository, e.g. "Create repository"


A branch is a version or duplication of a certain state of your application, for instance to be able to apply modifications to your application in an isolated environment or to isolate it as a release version. When creating a new repository an initial branch has to be created. 

Create a branch

  • Is done when creating a repository
  • Can be done from the navigation panel, using the context menu (use the three dots or right click on a branch)
    • This duplicates the latest commit of the selected branch. Pending changes will not be available in the new branch.
  • Can be done from the commit history view, using the context menu (use the three dots or right click on a commit)
Branch type (optional)You can define your own branch types. This could be helpful for structuring your repository or for applying user roles.

Import a branch

To import a branch, 

  1. Select a branch in the navigation panel
  2. In the banch menu, select "Import branch"
  3. Select "Upload export", select branch export on your file system, and select "Open"
  4. If you want to remove all existing elements in the branch, check the box preceding "Make the current branch identical to the imported branch"
  5. Select "Import" to import the branch export. 

Export a branch

To export a branch,

  1. Select a branch in the navigation panel
  2. In the banch menu, select "Export branch"
  3. Select the type of export you need.
    1. A data export meant for backup purposes or distribution to other Encore instances, but can not otherwise be interpreted by tools.
    2. A model export contains the model data in a structured form, suitable for tools such as BMA.
  4. Select "Export"
  • No labels