Rollback des formats Designer et Connect/en

<languages/>
==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

==Limitations==
Available only from the graphical user interface (not supported using map_import or map_export commands).

==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''

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:
::#Designer Formats Management
::#Formats Management

The list of all available Designer formats is displayed.

[[File:OX_S_VERSIONING1.jpg|1000px|center|sans_cadre]]

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:

[[File:OX_S_VERSIONING2.jpg|1000px|center|sans_cadre]]

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

<u>V4 version rollback</u>:

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

[[File:OX_S_VERSIONING3.jpg|1000px|center|sans_cadre]]

This is the result:

[[File:OX_S_VERSIONING4.jpg|1000px|center|sans_cadre]]

Version 4 of the format is activated.


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

[[File:OX_S_VERSIONING5.jpg|1000px|center|sans_cadre]]

===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.

<u>Example</u>: 
 // 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.