Designer and Connect Format Rollback

Introduction

Mapping 9.1 and higher includes a graphical interface to rollback Designer and Connect formats to a previous version. Using this feature, the user can easily restore a previous version of a Designer or Connect format in production.

Requirements

Mapping Onyx 9.1 or higher

How it works

Configuration

A new parameter called [FORMAT_REPOSITORY_DIR_FULLPATH] can be found in the general application settings (mapping.conf). It includes the path and name of the folder where the different versions of the formats are saved:

<block name="EXPERT PATH">

   <group>
      <element>
         ...
         <info name="[FORMAT_REPOSITORY_DIR_FULLPATH]">/apps/mapping/map400/repository</info>
         ...		
      </element>
   </group>
</block>

This entry is created automatically when Mapping 9.1 is installed and its default value is /home/mapping/map400/repository

Les valeurs par défaut à l'installation sont :

1. [VERSIONING_TOGGLE]: NO
2. [FORMAT_REPOSITORY_DIR_FULLPATH]: /apps/mapping/map400/repository.
3. [VERSIONING_LIMIT_DURATION]:  : Pas de limite ou 0
4. [VERSIONING_QUOTA_PER_PROJECT]: Pas de limite ou 0
5. [VERSIONING_QUOTA_GLOBAL]: Pas de limite ou 0

The "repository" folder is also created automatically.

Interface

Format versioning is available for Designer and Connect.

Designer Formats

In Mapping 9.1 and higher, go to Designer Formats Management:

In the Mapping menu, click on:

1. Designer Formats Management
2. Formats Management

The list of all available Designer formats is displayed.

There you can manage the different versions of each given format by clicking on the i icon at the end of the line of icons.

The window below is displayed presenting all versions and the history of versions used:

1 : Format
2 : Format version number
3 : User who last imported the format or used the rollback feature
4 : Comment written during last rollback
5 : Date and time the version was activated for the last time
6 : Date and time until which the version was last active
7 : Rollback button

V4 version rollback:

In this example, we want to restore version V4 by clicking on the Rollback button:

This is the result:

Version 4 of the format is activated.

Note: You can have a view of all formats and all versions. To do so, open the Formats History sub-menu under Designer Formats Management

Connect Formats

Connect formats work the same as Designer formats. Please check the Designer formats section above.

Command Line

You can also manage format versions from the command line using the mapobjectversioncontrol binary.

Example:

// Save project KUHN with sequence 20 currently in production
mapobjectversioncontrol backup "KUHN" "00020"

// Restore project KUHN wit sequence 10 as it was in production on 27 April
mapobjectversioncontrol restore "2019-04-27T23:59:59.000Z" "KUHN" "00010"

// List of projects where different versions are available
mapobjectversioncontrol list

All actions that have an impact on the repository are versioned automatically.

Soon you will be able to restore using the version number like this:

 mapobjectversioncontrol restore "KUHN" "00010" v3

Special Case

Existing Formats

If there are existing formats in the environment (created through copying the contents of the MAP400 folder from an environment where there is no versioning system, or when upgrading from a version older than 9.1), version V0 of each format will not be saved in the versioning mechanism.

As a result, when importing the next version V1 of the format, version V1 will be saved but V0 will be lost.

To prevent this, before importing version V1, run the command below:

/apps/mapping/bin/mapobjectversioncontrol backup "format" "sequence"

This will create an entry for version V0 in the versioning system. The version will then be available in the Rollback management interface.