ONYX:9.1:Utilisation:Rollback des formats Designer et Connect

Introduction

Mapping 9.1 et au delàs intègre dans les écrans des formats Designer et Connect un module permettant la gestion de leurs différentes versions. Cette fonctionnalité donne la possibilité à l'utilisateur de mettre en action des versions anciennes de templates Designer et Connect. Cela peut être très utile, par exemple, en cas de necessité de faire un rollback vers une version précédente d'un template Designer.

Prérequis

Mapping Onyx 9.1

Limites

Cette fonctionnalité est disponible uniquement pour les actions de rollbacks effectuées via l'interface. (Non disponible lors d'utilisation des commandes map_import et map_export)

Fonctionnement

Paramétrage

Une nouveau paramètre est apparu dans le mapping.conf [FORMAT_REPOSITORY_DIR_FULLPATH] ayant pour valeur le chemin et le nom du répertoire contenant les différentes versions des formats :

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

Cette entrée est automatiquement créée à l'installation de Mapping 9.1 et à pour valeur par défaut /home/mapping/map400/repository

Le répertoire repository est également automatiquement créé.

Interface

Le versioning est disponible pour les formats importés de Designer et de Connect.

Formats Designer

Sur le serveur Mapping 9.1 et au delàs, aller dans la gestion des formats Designer:

Sur le menu Mapping cliquer sur :

1. Gestion de formats Designer
2. Gestion des formats

La liste de formats Designer opérationnels s'affiche alors.

Il est alors possible de rentrer dans la gestion des différentes versions d'un format donné en cliquant sur le i correspondant.

La fenêtre suivante listant toutes les versions et l'historique de toutes les activations du format s'ouvre alors

1 : Format concerné
2 : Numéro de version pour le format concerné
3 : Utilisateur ayant procéder à l'importation ou au dernier rollback
4 : Commentaire saisie lors d'un rollback
5 : Date et heure de l'activation de la version
6 : Date et heure de jusqu'à quand la version était active
7 : Bouton de rollback

Rollback de la version V4 :

Dans notre exemple, nous allons réactiver la version V4 en cliquant sur son bouton rollback :

Voici le résultat alors obtenu :

La version 4 du format est alors activé.

Remarque : Il est également possible d'avoir une vue d'ensemble sur tous les formats et de toutes leurs versions. Pour cela, il faut aller sur le sous menu Historique des formats du menu Gestion des formats Designer

Format Connect

Le fonctionnement avec les formats Connect est le même qu'avec les format Designer. Nous vous invitons à vous référer à la partie des format Designer.

Ligne de commandes

Il est également possible de faire du versionong en ligne de commande en utilisant le binaire mapobjectversioncontrol

Exemple d'utilisation :

// Sauvegarde le projet KUHN en séquence 20 actuellement en production
mapobjectversioncontrol backup "KUHN" "00020"

// Restaure le projet KUHN en séquence 10 comme il était en production le 27 avril
mapobjectversioncontrol restore "2019-04-27T23:59:59.000Z" "KUHN" "00010"

// Restaure le projet identifié par le crc32 de son fichier d'archive
mapobjectversioncontrol restore 0xFEEEFEEE 

// Liste les projets déjà versionnés
mapobjectversioncontrol list

Toutes les actions qui ont un impact sur le repository sont versionnées automatiquement.

Cas particulier

copie du contenu du répertoire map400 sans importation

Dans le cas où les formats sont créés grace à la copie du contenu du répertoire MAP400 d'un environnement sans roolback vers un environnement avec rollback (lors d'un upgrade de V7, 8 ou 9.0 vers 9.1 et au delàs par exemple), la phase d'importation actionnant le mécanisme de rollback ne sera pas exécutée. De ce fait, la version V0 de ce format n'aura pas sa version sauvegardé dans le mécanisme de rollback. Lors de l'import de la prochaine version V1 de ce format, cette version V1 sera bien sauvegardée mais nous perdrons la V0. Afin d'éviter cela, avant d'importer la V1 du format, il faudra exécuter la commande suivante :

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

Cela aura pour effet de mettre une entrée de la version V0 dans le mécanisme de versioning. Cette version sera alors disponible dans l'interface des rollbacks des formats