> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/documentations/efalia-compose/mapping-suite/onyx-server/utilisation/rollback-des-formats-designer-et-connect.md).

# Rollback des formats Designer et Connect

## Introduction

Mapping 9.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. 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 10.2.5 ou supérieur (Partiellement disponible depuis la version 9.1 mais avec accès limités)

## Fonctionnement

### Paramétrage

Cinq 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.
* \*\*\[VERSIONING\_LIMIT\_DURATION]:\*\*Indique la période de rétention des formats (en jours).Les versions plus anciennes que cette valeur seront supprimées à aux prochaines importations.
* \*\*\[VERSIONING\_QUOTA\_PER\_PROJECT]:\*\*Indique le nombre de maximum de versions différentes par projet.
* \*\*\[VERSIONING\_QUOTA\_GLOBAL]:\*\*Indique le nombre maximum de version tous projets confondus.

```
 <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>
            <info name="[VERSIONING_LIMIT_DURATION]">5</info>
            <info name="[VERSIONING_QUOTA_PER_PROJECT]">10</info>
            <info name="[VERSIONING_QUOTA_GLOBAL]">30</info>        
            ...
        </element>
    </group>
</block>
```

Ces entrées sont créées automatiquement à l’installation de Mapping 10.2.5 et au delàs

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

* **\[VERSIONING\_TOGGLE]:** NO
* **\[FORMAT\_REPOSITORY\_DIR\_FULLPATH]:**/apps/mapping/map400/repository.
* **\[VERSIONING\_LIMIT\_DURATION]:** : Pas de limite ou 0
* \*\*\[VERSIONING\_QUOTA\_PER\_PROJECT]:\*\*Pas de limite ou 0
* \*\*\[VERSIONING\_QUOTA\_GLOBAL]:\*\*Pas de limite ou 0

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.

<figure><img src="/files/PqKiGXqT6WEOXx1UbRm8" alt="OX S VERSIONING1.jpg"><figcaption></figcaption></figure>

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 :

<figure><img src="/files/lshZ96iynpMzXT7tU1qA" alt="OX S VERSIONING2.jpg"><figcaption></figcaption></figure>

1 : Format concerné\
2 : Numéro de version du format concerné\
3 : Utilisateur ayant procédé à l’importation ou au dernier rollback\
(toujours renseigné sur Auto) 4 : Commentaire saisi lors d’un rollback\
(Non fonctionnel, affiche toujours manual 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** :

<figure><img src="/files/l1PDjqtKP0pVRLsQWYfj" alt="OX S VERSIONING3.jpg"><figcaption></figcaption></figure>

Voici le résultat alors obtenu :

<figure><img src="/files/JDynvUX6JhwF03gWDpCC" alt="OX S VERSIONING4.jpg"><figcaption></figcaption></figure>

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**

<figure><img src="/files/2Zt2gbeQtY6yQE8Yf6QO" alt="OX S VERSIONING5.jpg"><figcaption></figcaption></figure>

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.efalia.com/documentations/efalia-compose/mapping-suite/onyx-server/utilisation/rollback-des-formats-designer-et-connect.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.