La gestion des versions dans le gestionnaire de documents de Tuleap permet de suivre l’historique des documents, de mettre à jour un document tout en conservant ses anciennes versions et de savoir qui a modifié quoi et quand.
Qu’est-ce qu’une version de document ?
Un document versionné est un fichier stocké dans Tuleap pour lequel chaque modification importante est enregistrée comme une nouvelle version.
Cela signifie que :
Tous les changements sont historisés.
On peut consulter des versions antérieures.
On sait qui a fait la modification et quand.
Cette fonctionnalité assure une traçabilité complète de l’évolution d’un document.
Création d’une nouvelle version d’un document
Si on glisse/dépose un fichier dans un dossier au même endroit qu’un document existant, Tuleap ne remplace pas simplement l’ancien fichier : il crée une nouvelle version de ce document existant.
C’est très utile lorsque l’on souhaite mettre à jour le contenu d’un fichier (ex : document Word, PDF, image, etc.), sans perdre le suivi de ce qui existait auparavant.
Consulter l’historique d’un document
Chaque document conserve un journal de versions :
On peut y voir toutes les versions précédentes,
On peut y consulter les détails de chaque version (par exemple date/heure, auteur etc.),
On peut éventuellement télécharger une version précédente du document si nécessaire (selon les permissions), en cliquant sur le numéro de version.
Cette vue d’historique est essentielle pour suivre l’évolution d’un document ou restaurer un contenu antérieur.
Attention
Il est possible de supprimer une version d’un document mais cette action est irréversible. Si vous supprimez une version, elle sera donc définitivement perdue.
Permissions
On doit avoir les permissions appropriées pour créer ou modifier une version :
Le rôle de rédacteur permet de créer une nouvelle version du document.
Le rôle de gestionnaire permet aussi de contrôler les permissions et l’historique du document.
Notifications liées aux versions
Bien que spécifique à l’historique des versions, il est possible de s’abonner aux notifications pour être alerté quand un document est modifié ou qu’une nouvelle version est créée : il suffit de cocher l’option dans les notifications du document ou du dossier (voir l’article dédié).
