Versionner un Projet

Logo GenericsData GenericsData & Logo HandleData HandleData - Version 9.2.0

Le versionnement permet de faire évoluer un Projet en conservant plusieurs versions de ses éléments. Chaque version est utilisée, exportée, importée et dupliquée indépendamment.

Un même Projet peut, par exemple, conserver une version 1.0 utilisée par des consommateurs pendant que sa version 2.0 est préparée. Le choix de la version de travail et l’activation d’une version sont deux actions distinctes.

En résumé

Comprendre les versions

Versionnement des Projets -Notions de versionnement
Notion Description

Projet

Ensemble de versions regroupées sous une même identité. L’identifiant commun permet notamment de reconnaître le Projet à l’import.

Version du Projet

Version identifiée par un numéro unique au sein du Projet. Elle possède ses propres éléments et sa description.

Version courante ou version de travail

Version actuellement ouverte par l’utilisateur.

Version par défaut

Version de référence du Projet dans l’instance. Un Projet possède une seule version par défaut à la fois.

Version

Autre version du même Projet. Qu’elle ne soit pas la version par défaut ne signifie pas que ses éléments sont indisponibles : ils peuvent continuer à être utilisés et configurés.

Paramètres communs à toutes les versions

Les métadonnées, le code racine, la confidentialité, les utilisateurs (et leur éventuel rôle de gestionnaire), le template de droit et la criticité sont communs à toutes les versions du Projet. Ils constituent les paramètres de son enveloppe.

Ces paramètres sont disponibles dans la page d'édition du Projet. Leur modification, une fois enregistrée, s’applique immédiatement à toutes ses versions.

Lors de l’import ou de la duplication d’une version dans un Projet existant, les paramètres de l’enveloppe existante sont repris. Ils ne peuvent pas être redéfinis dans le formulaire de création de la version.

La modification du code racine impacte l’URL des DataAPIs de toutes les versions et entrainera ainsi la perte d’accès aux données partagées pour les consommateurs. À utiliser avec anticipation et prudence.

Numéro et description de version

Le numéro de version doit :

  • contenir uniquement des groupes de chiffres séparés par des points ;

  • commencer et se terminer par un chiffre ;

  • comporter au maximum 32 caractères ;

  • être unique parmi les versions du même Projet.

Exemples valides : 1, 1.1, 1.0.0, 1.1.20260909.
Exemples invalides : v1, 1., .1, 1..2, 1.0-beta.

Le champ Version est modifiable lors d’une duplication ou d’une création de Projet en tant que nouveau Projet. Lors d’un import, il est affiché en lecture seule.

Il est également modifiable lors de la création d’une Nouvelle version d’un Projet existant par duplication de sa version courante.

Il n’est pas possible d’importer plus d’une fois la même version dans un Projet existant. Si la version existe dans le Projet, son numéro de version est automatiquement modifié par le système.

L’onglet Versions de la configuration du Projet permet de consulter, modifier, gérer les permissions sur les éléments et supprimer les versions du Projet dans un tableau.

Les actions possibles sur une version dépendent de la version courante, de la version par défaut et du statut de la version considérée à l’ouverture de l’onglet. Un bouton d’information permet d’afficher le détail des conditions d’exécution de ces actions sur les versions du Projet.

La matrice ci-après permet de vérifier en un coup d’œil quelles actions sont disponibles sur les versions en fonction des cas.

Version affichée dans le tableau Configuration Gestion des droits Définir par défaut Désactiver Réactiver Supprimer

Courante + par défaut

✓

✓

—

—

—

—

Courante + non par défaut

✓

✓

✓

—

—

—

Non courante + par défaut

—

—

—

—

—

—

Non courante + non par défaut + activée

—

—

✓

✓

—

✓

Non courante + non par défaut + désactivée

—

—

—

—

✓

✓

Ouvrir sa version de travail

La version utilisée est indiquée à côté du nom du Projet dans le menu supérieur de DataChain.

  1. Ouvrir la liste des versions à côté du nom du Projet.

  2. Repérer la version souhaitée

  3. Sélectionner cette version pour en ouvrir les éléments.

Toutes les versions d’un Projet sont accessibles à chacun de ses utilisateurs.

Sélectionner une version de travail ne change rien à la version par défaut du Projet.

Créer une nouvelle version

La gestion des versions d’un Projet nécessite d’en être gestionnaire

Deux possibilités sont disponibles : dupliquer la version de travail ou importer une version disponible au format .dca.

Dupliquer la version de travail

  1. Ouvrir la version du Projet à prendre comme base.

  2. Dans le menu d’actions de la page du Projet, sélectionner Nouvelle version.

  3. Renseigner un numéro de version unique respectant le format attendu et compléter sa description (facultative).

  4. Configurer les autres options de la duplication.

  5. Cliquer sur Dupliquer le projet : au clic, la production d’un clone de la version de travail qui deviendra la nouvelle version du projet démarrera.

  6. À la fin du traitement, vérifier sa configuration.

Si le numéro de version n’est pas renseigné, le système se chargera du nommage de la version en suffixant le numéro de la version de travail d’un tiret suivi du nombre de versions partageant ce numéro dans le Projet.
Exemple : version de travail : 1.1 ; version créée par duplication : 1.1-1

Les paramètres communs du Projet sont repris automatiquement.

Depuis le menu d’actions de la page du Projet, Nouvelle version crée une version du même Projet par duplication de la version courante. Dupliquer crée un Projet distinct. Choisir l’action correspondant au résultat recherché.

Importer une version d’un Projet existant

  1. Ouvrir le Projet destinataire.

  2. Dans son menu d’actions, sélectionner Importer une version.

  3. Sélectionner le fichier .dca exporté depuis ce Projet.

  4. Vérifier le numéro de version affiché, les éléments à importer, les contextes et les associations des membres.

  5. Cliquer sur Créer le projet : au clic, le Projet stocké dans le fichier .dca sera créé comme nouvelle version du Projet courant

  6. À la fin du traitement, vérifier les éléments importés.

Si le numéro de version existe déjà dans le Projet destinataire, le système se chargera du renommage de la version en suffixant ce numéro d’un tiret suivi du nombre de versions partageant ce numéro dans le Projet.
Exemple : version déjà présente dans le projet : 1.1 ; version affectée par renommage : 1.1-1

Le Projet importé dans le fichier doit correspondre au même Projet que le destinataire pour que l’opération réussisse.
Un Projet possédant un autre identifiant de Projet ne peut pas être importé comme version de ce Projet.

Lorsqu’un import est lancé depuis la liste des Projets et que l’instance contient déjà ce Projet, DataChain propose de l’importer en tant que version du Projet existant.

Cette proposition peut être refusée pour créer un nouveau Projet indépendant à partir du fichier.
Une nouvelle identité de Projet est alors créée.

Les options générales d’import sont décrites dans Importer un Projet.

Exporter une version

  1. Ouvrir la version du Projet à exporter.

  2. Vérifier le numéro de la version de travail dans le menu supérieur.

  3. Lancer Exporter depuis le menu d’actions du Projet.

  4. Choisir le contenu du fichier .dca, puis lancer l’export.

L’export porte sur la version de travail. Il ne regroupe pas toutes les versions du Projet et ne concerne pas nécessairement la version par défaut.

L’archive créée conserve dans ses données le numéro de la version du Projet exportée.

Consulter Exporter un Projet pour le détail des options et du téléchargement.

Changer la version par défaut

La version par défaut est celle qui est ouverte quand on clique sur la carte d’un Projet contenant plusieurs versions depuis la liste des Projets. Les DataAPIs de cette version du Projet sont celle qui seront consommées par défaut par les utilisateurs de la Marketplace.

Rendre une version par défaut en fait la version de référence du Projet et retire ce statut à l’ancienne version par défaut.

Avant cette action :

  • vérifier les éléments et les données de la version à rendre par défaut ;

  • initialiser ou publier, dans cette version, les DataLinks et DataAPIs et plus généralement, les partages qui sont consommés dans la version actuellement par défaut ;

  • identifier les consommateurs des DataLinks à basculer vers la future version par défaut et effectuer la bascule ;

Pour rendre une version par défaut :

  1. Ouvrir la liste des versions du Projet dans le menu supérieur.

  2. Utiliser l’action Définir cette version par défaut (illustrée par une icône "play") associée à la version souhaitée comme version de référence.

La version par défaut est indiquée dans cette liste déroulante par une icône dédiée.

Supprimer une version

La suppression d’une version est définitive et supprime les éléments qu’elle contient. Elle nécessite les droits de gestionnaire du Projet concerné.

  1. Vérifier les DataLinks et DataAPIs encore consommés depuis cette version.

  2. Effectuer un export de sauvegarde si nécessaire.

  3. Ouvrir l’onglet Versions de la configuration du Projet.

  4. Utiliser l’action Supprimer la version sur la ligne concernée.

  5. Vérifier le récapitulatif et suivre les étapes de confirmation.

La version par défaut ne peut pas être supprimée tant que le Projet possède d’autres versions. Pour supprimer cette version tout en conservant le Projet, créer d’abord une nouvelle version du Projet puis en faire la nouvelle version par défaut.

Pour supprimer la dernière version d’un Projet, procéder en supprimant le Projet dans son entièreté, comme décrit dans la documentation de la gestion des Projets.

La suppression des versions s’effectue individuellement. Pour un Projet critique, effectuer la validation via le code reçu par mail.

La suppression d’une version contenant des DataLinks peut priver de leur source les dépôts consommateurs d’autres Projets. Avant de supprimer la version, vérifier la présence de consommateurs de ses éléments partagés.

Dernière mise à jour le 28 octobre 2026 à 18:35