Différence entre versions

Version du 4 mai 2020 à 08:11

Autres langues :

English • ‎français

Sommaire

1 Introduction
2 Prérequis
3 Limites
4 Fonctionnement
5 Ligne de commandes
6 Cas particulier
- 6.1 Cas des formats déjà présents

Introduction

Mapping donne la possibilité de signer les PDfs qu'il génère. Pour cela, des certificats électroniques associés à des clés privés sont utilisés.

Prérequis

Mapping Onyx 9.1 ou supérieur

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

Deux nouveaux paramètres sont apparus dans le mapping.conf:

[VERSIONING_TOGGLE]: Permet d'activer le système de rollback.
[FORMAT_REPOSITORY_DIR_FULLPATH]: Indique 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>
...
<block name="OTHERS">
    <group>
        <element>
            ...
            <info name="[VERSIONING_TOGGLE]">YES</info>
            ...
        </element>
    </group>
</block>

Ces entrées sont créées automatiquement à l'installation de Mapping 9.1.

Les valeurs par défaut à l'installation sont NO pour VERSIONING_TOGGLE et /apps/mapping/map400/repository pour FORMAT_REPOSITORY_DIR_FULLPATH.

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

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à, aller dans la Gestion des formats Designer:

Sur le menu Mapping, cliquer sur :

Gestion de formats Designer
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 du format concerné
3 : Utilisateur ayant procédé à l'importation ou au dernier rollback
4 : Commentaire saisi 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 cet 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ée.

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 formats Designer. Nous vous invitons à vous référer à la partie des formats Designer.

Ligne de commandes

Il est également possible de faire du versioning 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"

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

mapobjectversioncontrol list

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

Il sera bientôt possible de restaurer grâce au numéro de version :

 mapobjectversioncontrol restore "KUHN" "00010" v3

Cas particulier

Cas des formats déjà présents

Dans le cas où des formats sont déjà présents dans l'environnement (créés grâce à la copie du contenu du répertoire MAP400 à partir d'un environnement sans mécanisme de versioning ou lors de l'upgrade d'une version antérieure à la V9.1), la version V0 de ce format ne sera pas sauvegardée dans le mécanisme de versioning.

Par conséquent, lors de l'import de la prochaine version V1 de ce format, la version V1 sera bien sauvegardée mais la V0 sera perdue.

Afin d'éviter cela, avant d'importer la V1 du format, il faut exécuter la commande suivante :

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

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

@@ Ligne 1 : / Ligne 1 : @@
 <languages/>
 <translate>
-==Introduction== <!--T:1-->
+==Introduction==
 Mapping donne la possibilité de signer les PDfs qu'il génère. Pour cela, des certificats électroniques associés à des clés privés sont utilisés.
-==Prérequis== <!--T:2-->
+==Prérequis==
 Mapping Onyx 9.1 ou supérieur
-==Limites== <!--T:3-->
+==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== <!--T:4-->
+==Fonctionnement==
 ===Paramétrage===
-<!--T:5-->
 Deux nouveaux paramètres sont apparus dans le mapping.conf:
 # '''[VERSIONING_TOGGLE]: ''' Permet d'activer le système de rollback.
 # '''[FORMAT_REPOSITORY_DIR_FULLPATH]: ''' Indique le chemin et le nom du répertoire contenant les différentes versions des formats.
- <!--T:6-->
   <block name="EXPERT PATH">
       <group>
@@ Ligne 40 : / Ligne 40 : @@
   </block>
-<!--T:7-->
 Ces entrées sont créées automatiquement à l'installation de Mapping 9.1.
 Les valeurs par défaut à l'installation sont ''NO'' pour '''VERSIONING_TOGGLE''' et ''/apps/mapping/map400/repository'' pour '''FORMAT_REPOSITORY_DIR_FULLPATH'''.
-<!--T:8-->
 Le répertoire repository est également créé automatiquement.
-===Interface=== <!--T:9-->
+===Interface===
 Le versioning est disponible pour les formats importés de Designer et de Connect.
@@ Ligne 54 : / Ligne 54 : @@
 Sur le serveur Mapping 9.1 et au-delà, aller dans la '''Gestion des formats Designer''':
-<!--T:11-->
 :Sur le menu Mapping, cliquer sur :
 ::#Gestion de formats Designer
 ::#Gestion des formats
-<!--T:12-->
 La liste de formats Designer opérationnels s'affiche alors.
-<!--T:13-->
 [[File:OX_S_VERSIONING1.jpg|1000px|center|sans_cadre]]
-<!--T:14-->
 Il est alors possible de rentrer dans la gestion des différentes versions d'un format donné en cliquant sur le '''i''' correspondant.
-<!--T:15-->
 La fenêtre suivante listant toutes les versions et l'historique de toutes les activations du format s'ouvre alors :
-<!--T:16-->
 [[File:OX_S_VERSIONING2.jpg|1000px|center|sans_cadre]]
-<!--T:17-->
 : Format concerné<br>
 : Numéro de version du format concerné<br>
@@ Ligne 83 : / Ligne 83 : @@
 : Bouton de rollback<br>
-<!--T:18-->
 <u>Rollback de la version V4</u> :
-<!--T:19-->
 Dans cet exemple, nous allons réactiver la version V4 en cliquant sur son bouton '''Rollback''' :
-<!--T:20-->
 [[File:OX_S_VERSIONING3.jpg|1000px|center|sans_cadre]]
-<!--T:21-->
 Voici le résultat alors obtenu :
-<!--T:22-->
 [[File:OX_S_VERSIONING4.jpg|1000px|center|sans_cadre]]
-<!--T:23-->
 La version 4 du format est alors activée.
-<!--T:24-->
 <u>Remarque</u> : 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'''
-<!--T:25-->
 [[File:OX_S_VERSIONING5.jpg|1000px|center|sans_cadre]]
@@ Ligne 114 : / Ligne 114 : @@
 Il est également possible de faire du versioning en ligne de commande en utilisant le binaire '''mapobjectversioncontrol'''
-<!--T:28-->
 <u>Exemple d'utilisation</u> :
   // Sauvegarde le projet KUHN en séquence 20 actuellement en production
   mapobjectversioncontrol backup "KUHN" "00020"
- <!--T:29-->
 // 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"
- <!--T:30-->
 // Liste les projets déjà versionnés
   mapobjectversioncontrol list
-<!--T:31-->
 Toutes les actions ayant un impact sur le repository sont versionnées automatiquement.
-<!--T:32-->
 Il sera bientôt possible de restaurer grâce au numéro de version :
    mapobjectversioncontrol restore "KUHN" "00010" v3
-==Cas particulier== <!--T:33-->
+==Cas particulier==
 ===Cas des formats déjà présents===
-<!--T:34-->
 Dans le cas où des formats sont déjà présents dans l'environnement (créés grâce à la copie du contenu du répertoire MAP400 à partir d'un environnement sans mécanisme de versioning ou lors de l'upgrade d'une version antérieure à la V9.1), la version V0 de ce format ne sera pas sauvegardée dans le mécanisme de versioning.
-<!--T:35-->
 Par conséquent, lors de l'import de la prochaine version V1 de ce format, la version V1 sera bien sauvegardée mais la V0 sera perdue.
-<!--T:36-->
 Afin d'éviter cela, avant d'importer la V1 du format, il faut exécuter la commande suivante :
   /apps/mapping/bin/mapobjectversioncontrol backup "format" "sequence"
-<!--T:37-->
 Cela aura pour effet de créer une entrée de la version V0 dans le mécanisme de versioning.
 Cette version sera alors disponible dans l'interface de rollback des formats.
 </translate>