Différence entre versions

Version actuelle datée du 21 avril 2020 à 12:01

Autres langues :

English • ‎français

Sommaire

1 Introduction
2 Prérequis
3 Limites
4 Fonctionnement
- 4.1 Paramétrage
- 4.2 Interface

Introduction

Mapping 10.1 et au-delà intègre la possibilité de copier une queue d'un site modèle.

Prérequis

Mapping Onyx 10.1 ou supérieur

Limites

Dans le cas où la queue à copier comporte plusieurs devices, uniquement la première sera copiée.

Fonctionnement

Paramétrage

un nouveau paramètre est apparu dans le mapping.conf (section Expert path) :

[PATH_SITE_MODEL]:  Permet de donner le nom du site ayant toutes les queues pouvant être copiées. (Site modèle).

<block name="EXPERT PATH">
    <group>
       <element>
          ...
          <info name="[PATH_SITE_MODEL]">queue_models</info>
          ...		
       </element>
    </group>
 </block>

Cet entrée est créée automatiquement à l'installation de Mapping 10.1.

La valeur par défaut à l'installation est queue_models

Le site en question n'est quand à lui pas créé.

Il faudra le créer ainsi que créer les modèles de queues.

Interface

Un nouveau bouton est apparu dans la gestion des sites, imprimantes et points d'entrée.

Création du site modèle

La première chose à faire est de créer le site modèle (portant par défaut le nom queue_models Il faut également créer des modèles de queue à l'intérieur de celui-ci.

Dans notre exemple, le site modèle se nomme queue_models et ses queues queue1, queue2, queue3.

Création d'une queue dans le site principal via la nouvelle fonctionnalité

A partir de maintenant, nous pouvons utiliser la nouvelle fonctionnalité de duplication de queues.

Mettez vous au niveau du site principal (ou MAIN)
Cliquer sur l'icone Duplicate queue du site principal (le site principal est alors la destination de la copie)
L'écran suivant apparait alors :

1 : Nom de la queue à créer (Obligatoire)

2 : Description de la queue à créer (Facultatif) Si vide alors on prends la valeur du nom de la queue et de la device 

3 : Queue à copier (queue présente dans le site modèle)

4 : Bouton de création de la queue

Dans notre exemple, nous entrons

1 : copyqueue1
2 : (vide)
3 : queue1

La validation de cette écran créerai instantanément la queue copyqueue1 à partir de la queue modèle queue1 et vous serai redirigé vers l’écran de modification.

Le nom de la queue et la description correspondent aux informations entrées dans l'écran précédent. La device (Printer) reprend les caractéristiques de la queue copiée. (queue1)

Vous pouvez apporter les modifications que vous souhaitez et cliquer sur OK pour revenir sur la page principale.

La queue copyqueue1 avec sa device est créé dans le site MAIN.

Création de queues dans d'autres sites

Il est également possible d'utiliser cette fonctionnalité à partir d'un autre site se situant dans le site principal (SITE1 dans mon exemple) ou dans un site situé dans ce site 1 (SITE11 dans mon exemple)

@@ Ligne 1 : / Ligne 1 : @@
 <languages/>
 <translate>
-==Introduction==
+==Introduction== <!--T:1-->
-Mapping 10.1 et au-delà 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 remettre en action des versions précédentes de templates Designer et Connect.
+Mapping 10.1 et au-delà intègre la possibilité de copier une queue d'un site modèle.
-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==
+==Prérequis== <!--T:2-->
-Mapping Onyx 9.1 ou supérieur
+Mapping Onyx 10.1 ou supérieur
-==Limites==
+==Limites== <!--T:3-->
-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).
+Dans le cas où la queue à copier comporte plusieurs devices, uniquement la première sera copiée.
-==Fonctionnement==
+==Fonctionnement== <!--T:4-->
 ===Paramétrage===
-Deux nouveaux paramètres sont apparus dans le mapping.conf:
+<!--T:5-->
-# '''[VERSIONING_TOGGLE]: ''' Permet d'activer le système de rollback.
+un nouveau paramètre est apparu dans le mapping.conf (section Expert path) :
-# '''[FORMAT_REPOSITORY_DIR_FULLPATH]: ''' Indique le chemin et le nom du répertoire contenant les différentes versions des formats.
+ '''[PATH_SITE_MODEL]: ''' Permet de donner le nom du site ayant toutes les queues pouvant être copiées. (Site modèle).
-  <block name="EXPERT PATH">
+  <!--T:6-->
+<block name="EXPERT PATH">
       <group>
          <element>
             ...
-            '''<info name="[FORMAT_REPOSITORY_DIR_FULLPATH]">/apps/mapping/map400/repository</info>'''
+            '''<info name="[PATH_SITE_MODEL]">queue_models</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.
-[[File:OX_S_VERSIONING1.jpg|1000px|center|sans_cadre]]
-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 :
-[[File:OX_S_VERSIONING2.jpg|1000px|center|sans_cadre]]
-: Format concerné<br>
-: Numéro de version du format concerné<br>
-: Utilisateur ayant procédé à l'importation ou au dernier rollback<br>
-: Commentaire saisi lors d'un rollback<br>
-: Date et heure de l'activation de la version<br>
-: Date et heure de jusqu'à quand la version était active<br>
-: Bouton de rollback<br>
-<u>Rollback de la version V4</u> :
-Dans cet exemple, nous allons réactiver la version V4 en cliquant sur son bouton '''Rollback''' :
-[[File:OX_S_VERSIONING3.jpg|1000px|center|sans_cadre]]
-Voici le résultat alors obtenu :
-[[File:OX_S_VERSIONING4.jpg|1000px|center|sans_cadre]]
-La version 4 du format est alors activée.
+<!--T:7-->
+Cet entrée est créée automatiquement à l'installation de Mapping 10.1.
+<!--T:8-->
+La valeur par défaut à l'installation est ''queue_models''
-<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:9-->
+Le site en question n'est quand à lui pas créé.
+<!--T:10-->
+Il faudra le créer ainsi que créer les modèles de queues.
-[[File:OX_S_VERSIONING5.jpg|1000px|center|sans_cadre]]
+===Interface=== <!--T:11-->
+Un nouveau bouton est apparu dans la '''gestion des sites, imprimantes et points d'entrée'''.
-===Format Connect=== <!--T:26-->
+<!--T:12-->
-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.
+[[File:OX_S_CLONEQUEUE1.jpg|1000px|center|sans_cadre]]
-==Ligne de commandes== <!--T:27-->
+====Création du site modèle==== <!--T:13-->
-Il est également possible de faire du versioning en ligne de commande en utilisant le binaire '''mapobjectversioncontrol'''
+La première chose à faire est de créer le site modèle (portant par défaut le nom '''queue_models'''
+Il faut également créer des modèles de queue à l'intérieur de celui-ci.
+<!--T:14-->
+Dans notre exemple, le site modèle se nomme '''queue_models''' et ses queues '''queue1''', '''queue2''', '''queue3'''.
-<u>Exemple d'utilisation</u> :
+<!--T:15-->
- // Sauvegarde le projet KUHN en séquence 20 actuellement en production
+[[File:OX_S_CLONEQUEUE2.jpg|1000px|center|sans_cadre]]
- mapobjectversioncontrol backup "KUHN" "00020"
+====Création d'une queue dans le site principal via la nouvelle fonctionnalité==== <!--T:16-->
-// Restaure le projet KUHN en séquence 10 comme il était en production le 27 avril
+<!--T:17-->
- mapobjectversioncontrol restore "2019-04-27T23:59:59.000Z" "KUHN" "00010"
+A partir de maintenant, nous pouvons utiliser la nouvelle fonctionnalité de duplication de queues.
+<!--T:18-->
+#Mettez vous au niveau du site principal (ou MAIN)
+#Cliquer sur l'icone '''Duplicate queue''' du site principal (le site principal est alors la destination de la copie)
+#L'écran suivant apparait alors :
-// Liste les projets déjà versionnés
+<!--T:19-->
- mapobjectversioncontrol list
+[[File:OX_S_CLONEQUEUE3.jpg|1000px|center|sans_cadre]]
+ <!--T:20-->
+: Nom de la queue à créer (Obligatoire)<br>
+: Description de la queue à créer (Facultatif) Si vide alors on prends la valeur du nom de la queue et de la device <br>
+: Queue à copier (queue présente dans le site modèle)<br>
+: Bouton de création de la queue<br>
-Toutes les actions ayant un impact sur le repository sont versionnées automatiquement.
+<!--T:21-->
+Dans notre exemple, nous entrons
+<!--T:22-->
+: copyqueue1<br>
+: (vide)<br>
+: queue1<br>
+<br>
+La validation de cette écran créerai instantanément la queue '''copyqueue1''' à partir de la queue modèle '''queue1''' et vous serai redirigé vers l’écran de modification.
-Il sera bientôt possible de restaurer grâce au numéro de version :
+<!--T:23-->
-  mapobjectversioncontrol restore "KUHN" "00010" v3
+[[File:OX_S_CLONEQUEUE4.jpg|1000px|center|sans_cadre]]
-==Cas particulier== <!--T:33-->
+<!--T:24-->
-===Cas des formats déjà présents===
+Le nom de la queue et la description correspondent aux informations entrées dans l'écran précédent.
+La device (Printer) reprend les caractéristiques de la queue copiée. (queue1)
+<!--T:25-->
+Vous pouvez apporter les modifications que vous souhaitez et cliquer sur OK pour revenir sur la page principale.
-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:26-->
+[[File:OX_S_CLONEQUEUE5.jpg|1000px|center|sans_cadre]]
-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:27-->
+La queue copyqueue1 avec sa device est créé dans le site MAIN.
+====Création de queues dans d'autres sites==== <!--T:28-->
-Afin d'éviter cela, avant d'importer la V1 du format, il faut exécuter la commande suivante :
+<!--T:29-->
- /apps/mapping/bin/mapobjectversioncontrol backup "format" "sequence"
+Il est également possible d'utiliser cette fonctionnalité à partir d'un autre site se situant dans le site principal (SITE1 dans mon exemple) ou dans un site situé dans ce site 1 (SITE11 dans mon exemple)
+<!--T:30-->
+[[File:OX_S_CLONEQUEUE6.jpg|1000px|center|sans_cadre]]
-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>