Rendre un projet existant disponible dans l’espace de travail
En un coup d'œil
- Découvrez comment utiliser la boîte de dialogue Make Available Online ou Make Available On Server pour configurer les informations du projet et son dossier dans le Workspace.
- Comprenez les différences entre Simple Sync et le contrôle de version natif du Workspace, notamment en matière de consultation, de commentaires et de modification par plusieurs utilisateurs.
- Explorez la possibilité de migrer un projet géré par un système de contrôle de version externe vers le stockage versionné natif du Workspace.
La méthode recommandée et la plus performante pour travailler avec des projets consiste à créer un nouveau projet directement dans l’espace de travail connecté. Si vous disposez d’un projet existant, vous pouvez l’intégrer à votre espace de travail en le rendant disponible en ligne et en choisissant d’activer le contrôle de version formel. Dans les deux cas, le projet sera stocké et géré par le système de contrôle de version (VCS) natif de l’espace de travail. Vous disposerez ainsi de toutes les fonctionnalités du projet lorsque vous travaillerez dessus dans Altium Designer. La gestion complète de votre projet par le VCS de l’espace de travail est le seul moyen de permettre à plusieurs personnes de modifier ce projet dans Altium Designer (à condition qu’elles soient membres de l’espace de travail) et de bénéficier des fonctionnalités supplémentaires de la plateforme, telles que le suivi de l’historique et le partage avancé des projets.
Pour rendre un projet existant (un projet local ou un projet actuellement soumis à un contrôle de version externe) disponible dans l’espace de travail, soit sous forme de projet miroir (Simple Sync) dans un espace de travail Altium 365, soit sous le contrôle de version Git natif d’un espace de travail, ouvrez le projet comme d’habitude dans Altium Designer, puis faites un clic droit sur son entrée dans le panneau Projects et sélectionnez Make Project Available Online dans le menu contextuel pour accéder à la boîte de dialogue Make Available Online. Lorsque vous utilisez un espace de travail Enterprise Server, la commande Make Project Available on Server ouvre la boîte de dialogue Make Available On Server.

Rendez un projet local existant disponible dans l’espace de travail, ce qui revient à l’y « enregistrer » et à en créer une « copie miroir ».
Options et commandes de la boîte de dialogue Make Available Online
-
Project Name – le nom du projet dans l’espace de travail. Par défaut, il s’agit du nom du projet d’origine.
-
Description – saisissez la description souhaitée pour le projet.
-
Version Control – cochez cette option pour ajouter un projet local au VCS intégré de l’espace de travail (Git). Si cette option est décochée, les fichiers du projet seront simplement stockés dans l’espace de travail pour permettre un accès de base et leur partage avec d’autres personnes, uniquement à des fins de consultation et de commentaire — en quelque sorte, une Simple Sync moins formelle. Il est recommandé d’activer le contrôle de version formel afin d’accéder à l’ensemble des fonctionnalités offertes par l’espace de travail et la plateforme Altium 365. Cette option est disponible uniquement si le projet n’est actuellement soumis à aucun contrôle de version.
-
Migrate to Altium 365 Versioned Storage – activez cette option pour migrer un projet utilisant un VCS externe vers une gestion complète par le VCS de l’espace de travail. Le projet pourra alors bénéficier des fonctionnalités du VCS natif de l’espace de travail. Cette option est disponible uniquement si le projet est actuellement géré par un VCS externe.
-
Advanced – cliquez pour accéder à une option supplémentaire.
-
Folder – ce champ permet de spécifier l’emplacement où créer le dossier du projet en cours de migration dans l’arborescence de l’espace de travail. Le chemin par défaut des nouveaux projets est défini sur la page Admin – Settings – Projects de l’interface Web de l’espace de travail (par défaut, il s’agit de
Projects\<ProjectName>). Cliquez sur
pour ouvrir la boîte de dialogue Choose Folder, qui est une version simplifiée du panneau Explorer, dans laquelle vous pouvez parcourir les dossiers du serveur et en sélectionner un autre si nécessaire.
-
Options et commandes de la boîte de dialogue Make Available On Server
- Project Name – le nom du projet dans l’espace de travail. Par défaut, il s’agit du nom du projet d’origine.
- Description – saisissez la description souhaitée pour le projet.
- Migrate to Altium Versioned Storage – activez cette option pour migrer un projet utilisant un VCS externe vers une gestion complète par le VCS de l’espace de travail. Le projet pourra alors bénéficier des fonctionnalités du VCS natif de l’espace de travail. Cette option est disponible uniquement si le projet est actuellement géré par un VCS externe.
-
Advanced – cliquez pour accéder à des options supplémentaires.
-
Repository – ce menu déroulant (s’il est présent) répertorie tous les dépôts de conception gérés par le service de contrôle de version de l’espace de travail et dont l’utilisation vous a été accordée par partage. Choisissez le dépôt dans lequel stocker le nouveau projet et ses fichiers ; un seul dépôt Git (
Versioned Storage) est disponible par défaut.Un champ Repository Folder supplémentaire permet de spécifier ou de rechercher un autre dossier cible au sein du dépôt lui-même. Cliquez sur
pour ouvrir la boîte de dialogue Add to Version Control, dans laquelle vous pouvez parcourir le dépôt et créer l’arborescence de dossiers requise.
-
Folder – ce champ permet de spécifier où créer le dossier du projet en cours de migration dans l’arborescence des dossiers de l’espace de travail. Le chemin par défaut des nouveaux projets est défini sur la page Admin – Settings – Projects de l’interface Web de l’espace de travail (par défaut, il s’agit de
Projects\<ProjectName>). Cliquez sur
pour ouvrir la boîte de dialogue Choose Folder, une version simplifiée du panneau Explorer, dans laquelle vous pouvez parcourir et sélectionner un autre dossier de l’espace de travail si nécessaire.
-
Utilisez la boîte de dialogue Make Available Online pour modifier le Name du projet et ajouter une Description. Par défaut, le nom est celui du projet d’origine.
Cochez l’option Version Control pour ajouter le projet au système de contrôle de version (VCS) intégré de l’espace de travail (Git). Lorsque cette option est décochée (option disponible uniquement dans un espace de travail Altium 365), les fichiers du projet sont simplement stockés dans l’espace de travail pour permettre un accès de base et le partage avec d’autres utilisateurs à des fins de consultation et de commentaire uniquement : c’est le mode Simple Sync. Il est recommandé d’activer le contrôle de version afin de bénéficier de toutes les fonctionnalités offertes par l’espace de travail et la plateforme Altium 365. Notez que la mise en miroir d’un projet dans un espace de travail (Simple Sync) est disponible uniquement lorsque vous êtes connecté à un espace de travail Altium 365.
Cliquez sur le lien Advanced de la boîte de dialogue pour afficher le champ Folder. Ce champ permet de spécifier où créer le dossier du projet mis en miroir dans l’arborescence des dossiers de l’espace de travail. Le chemin par défaut des nouveaux projets est défini sur la page Admin – Settings – Projects de l’interface Web de l’espace de travail (par défaut, il s’agit de Projects\<ProjectName>). Cliquez sur le bouton
pour parcourir et sélectionner un autre dossier de l’espace de travail si nécessaire.
Une fois les propriétés de transfert du projet définies selon vos besoins dans la boîte de dialogue Make Available Online , cliquez sur OK. Lorsqu’un projet qui n’est pas sous contrôle de version externe est mis à disposition en ligne (dans un espace de travail Altium 365, avec l’option Version Control cochée), le projet et ses fichiers font l’objet d’un commit et sont envoyés vers le dépôt de conception Versioned Storage de l’espace de travail. Le panneau Projects indique alors que le dépôt de conception de l’espace de travail et le dépôt local (copie de travail) sont entièrement synchronisés, comme le signalent les icônes
associées. Le projet devient un véritable projet de l’espace de travail : il n’y est pas simplement « enregistré », mais fait effectivement l’objet d’un commit et est placé sous le contrôle de version de l’espace de travail. Toute modification de la conception doit être enregistrée (par un commit et un envoi) dans le dépôt de l’espace de travail.
Limitations liées à l’utilisation d’un dépôt de contrôle de version externe existant
Comme indiqué précédemment, vos conceptions locales peuvent déjà être suivies dans un système de contrôle de version externe existant (Git, SVN, EPDM, etc.). Lorsque vous utilisez un espace de travail Altium 365, vous pouvez conserver cette configuration et simplement mettre les conceptions à disposition dans votre espace de travail en les y enregistrant à l’aide de la fonctionnalité Make Project Available Online.
Dans ce mode, chaque fois que vous modifiez une conception et effectuez un commit de ces modifications dans votre dépôt VCS externe, les données de conception sont mises en miroir dans l’espace de travail en arrière-plan, et tous les traitements nécessaires sont effectués comme d’habitude : aperçu, cas d’utilisation, etc. Il existe toutefois certaines limitations à prendre en compte :
- La création d’un nouveau projet de conception doit toujours suivre la procédure précédente, c’est-à-dire qu’il doit être créé manuellement dans le système VCS externe. Le projet est ensuite enregistré et mis en miroir dans l’espace de travail à l’aide de la fonctionnalité Make Project Available Online.
-
Si des modifications sont apportées à la conception, mais que le commit et l’envoi sont effectués à l’aide d’outils externes plutôt que depuis Altium Designer, ces modifications n’apparaissent pas dans le projet mis en miroir dans l’espace de travail. Ce problème est corrigé lors de la prochaine réouverture du projet dans Altium Designer, qui synchronise automatiquement le projet local avec la version mise en miroir dans l’espace de travail. Si les modifications ont été apportées par un autre utilisateur, les fichiers du projet rouvert apparaissent à l’état
Out Of Date; vous pouvez remédier à cette situation à l’aide de la commande de contrôle de version Update. - L’ouverture du projet par une deuxième personne nécessite un accès à ce dépôt VCS externe.
- La gestion des droits doit être configurée et maintenue à deux endroits : dans l’espace de travail et dans la source principale (le dépôt VCS externe Git/SVN/etc.).
- Certaines fonctionnalités proposées par la plateforme Altium 365 ne fonctionnent que si le projet est placé sous le système de contrôle de version natif de l’espace de travail. Si vous conservez votre projet sous un système de contrôle de version externe, vous ne pourrez pas bénéficier de ces fonctionnalités lorsqu’elles seront disponibles sur la plateforme. Vous pouvez passer de votre VCS externe au VCS natif de l’espace de travail : consultez la section suivante pour connaître la procédure à suivre.
Travailler avec GitHub
L’utilisation de la plateforme GitHub comme système de gestion de versions (VCS) externe est une méthode courante pour héberger et partager des projets de conception, et les dépôts Git sont pris en charge par Altium Designer. Comme décrit ci-dessus pour un Workspace Altium 365, la configuration VCS externe existante peut être synchronisée avec le Workspace (mise en miroir), ce qui vous permet de bénéficier de ses fonctionnalités avancées de gestion des données et de collaboration.
Votre manière de travailler avec GitHub varie selon les pratiques de votre entreprise ou simplement selon les outils Git dont vous disposez. En général, toutefois, un projet de conception est créé dans un dépôt Git local, puis envoyé vers un dépôt GitHub distant (push), ou un projet existant est cloné depuis GitHub vers un dépôt local. Une fois dans le dépôt Git local, le projet peut être ouvert dans Altium Designer pour être modifié : le logiciel reconnaît et utilise les dépôts GitHub locaux et distants.
Si le projet basé sur Git est mis en miroir dans un Workspace Altium 365 (Make Project Available Online), il peut être géré et modifié dans Altium Designer comme tout autre projet stocké dans le Workspace. Dans cette configuration, le Workspace offre toujours tous les avantages de son système de gestion de projets et communique également de manière transparente avec GitHub pour effectuer les principales opérations VCS : commit, push, pull, etc. Altium Designer vous demande vos identifiants de connexion GitHub et les conserve pour les interactions ultérieures avec GitHub.
Protocoles GitHub
Bien que le système de gestion de versions Git propose plusieurs protocoles de transfert de données, Altium Designer ne prend actuellement en charge que le protocole HTTP/HTTPS pour les connexions entre un dépôt Git local et son dépôt principal distant. En pratique, le protocole utilisé est défini par le préfixe de l’URL spécifiée pour la connexion au dépôt distant : https://<remote repository>, ssh://<remote repository>, git://<remote repository>, etc.
GitHub prend en charge les protocoles SSH et HTTPS et recommande d’utiliser des URL HTTPS pour les connexions.
► Consultez Quelle URL distante dois-je utiliser ? sur GitHub pour plus d’informations.
Si votre système VCS externe utilise un protocole autre que HTTPS, comme une connexion SSH GitHub, ce protocole est prédéfini dans tout dépôt cloné depuis le dépôt distant. Ce protocole étant incompatible avec Altium Designer, une erreur se produit lorsque vous tentez d’intégrer le projet à un Workspace Altium. Dans le cas d’une connexion SSH, il vous sera proposé d’essayer de mettre à jour ce dépôt pour qu’il utilise à la place le protocole de connexion HTTPS pris en charge (à condition que le dépôt lui-même prenne en charge ce protocole). Si vous ne connaissez pas le protocole de l’URL distante utilisé pour un dépôt Git local, vous pouvez le vérifier à l’aide de la commande git remote – v.
Utilisez l’interface en ligne de commande Git Bash pour vérifier l’URL distante configurée pour un dépôt.
Le dépôt peut être reconfiguré avec une autre URL, par exemple avec le protocole HTTPS pour assurer la compatibilité avec Altium Designer, à l’aide de la commande git remote set-url <name> <URL>, où le préfixe de l’URL indique le type de protocole.
Modification du protocole de l’URL de connexion au dépôt distant, puis vérification à l’aide de la commande remote.
Passage d’un VCS externe au VCS natif du Workspace
Lorsqu’il est connecté à un Workspace Altium 365, Altium Designer permet également de migrate fidèlement les projets utilisant un système VCS externe vers un projet entièrement géré par le Workspace, qui héberge les fichiers de conception dans son propre dépôt Git. Le projet de conception converti, qui conserve l’historique des commits VCS antérieurs, peut alors bénéficier des fonctionnalités natives du Workspace reposant sur le VCS, telles que le partage avancé de projets, l’authentification unique et la chronologie de l’historique basée sur les événements.
La fonctionnalité de migration VCS des projets prend en charge les systèmes externes de gestion de versions Git et SVN. Elle est disponible lorsque vous rendez accessible en ligne un projet local basé sur des fichiers, ou lorsque vous convertissez un projet mis en miroir (uniquement synchronisé) en projet géré par le VCS Git propre au Workspace.
Pour migrer simplement un projet stocké sous gestion de versions externe, faites un clic droit sur le nom du projet dans le panneau Projects et choisissez l’option Make Project Available Online dans le menu contextuel, ou sélectionnez Project » Make Available Online dans le menu principal. Dans la boîte de dialogue Make Available Online qui s’affiche, cochez l’option Migrate to Altium 365 Versioned Storage et confirmez l’opération (OK).
L’activation de l’option Migrate to Altium 365 Versioned Storage remplace effectivement le dépôt VCS externe par le dépôt Git du Workspace, convertit le projet en un projet stocké et géré dans le Workspace Altium 365 et, lorsque cela est possible, transfère l’historique des commits du VCS externe. Notez que si l’option de migration reste décochée, le projet est mis en miroir dans le Workspace (configuration Simple Sync), tout en conservant le dépôt externe pour son stockage VCS.
Pour transférer un projet VCS local vers un projet VCS entièrement géré dans votre Workspace Altium 365, cochez l’option de migration VCS lorsque vous le rendez accessible en ligne.
La boîte de dialogue Migrate Project s’ouvre et vous avertit que le projet va être migré pour être entièrement géré par le VCS du Workspace. Cliquez sur le bouton Browse pour sélectionner un dossier sur votre disque dur dans lequel un nouveau dépôt de projet local (basé sur Git) sera créé. Cliquez sur le bouton Migrate pour lancer la migration.

La boîte de dialogue Migrate Project
Une fois que vous avez suivi les instructions, notamment effectué un dernier commit VCS, le projet est désormais sous gestion de versions dans le dépôt Git du Workspace. L’historique des commits du VCS externe et les commentaires/messages associés sont transférés vers le nouveau projet VCS du Workspace. Vous pouvez y accéder dans la vue History d’Altium Designer : faites un clic droit sur le nom du projet dans le panneau Projects et sélectionnez la commande History & Version Control » Show Project History.
Lors de la migration, l’historique des commits du VCS externe du projet (affiché à gauche) est transféré vers la vue History d’Altium Designer (à droite).
Si le projet VCS externe est déjà géré dans l’espace de travail Altium 365 en tant que projet en miroir (fichiers locaux et serveur synchronisés), ses fichiers VCS peuvent être migrés vers le dépôt Git natif du serveur à l’aide de la commande Migrate to Altium Versioned Storage, accessible depuis la vue Project History, la boîte de dialogue Project Options ou le menu contextuel du panneau Projects History & Version Control, accessible par clic droit.
Un projet VCS synchronisé avec votre espace de travail (mis en miroir) est migré à l’aide de l’option Migrate Project to Altium Version Control.
Collaboration après la migration
-
Lorsqu’un membre de l’équipe de l’espace de travail a migré un projet vers Altium Versioned Storage, il doit s’assurer que les autres collaborateurs du projet se connectent à l’espace de travail de l’équipe, puis mettent à jour leurs copies locales (de travail) du projet. La nécessité de cette mise à jour est signalée dans le panneau Projects par l’icône
(obsolète) associée au fichier de projet, et la mise à jour s’effectue à l’aide de la commande Project » History & Version Control » Update Whole Project.
- Une fois le projet migré mis à jour, Altium Designer proposera de mettre à jour les liens vers le nouveau dépôt en reconstruisant le dossier de travail local du projet. Choisissez l’option recommandée dans la boîte de dialogue Fix version control link pour terminer la mise à jour du projet local.
- Notez que si un collaborateur du projet not se connecte pas à l’espace de travail de l’équipe, puis effectue des commits de modifications de conception dans le VCS, ces modifications continueront d’être enregistrées dans le dépôt externe et seront donc désynchronisées du projet VCS migré dans l’espace de travail.
- Pendant la migration, Altium Designer effectue un commit dans le dépôt d’origine afin d’y placer un marqueur de notification permettant aux instances d’Altium Designer des autres membres de l’équipe de reconnaître que le projet a été migré.
Migration manuelle d’un projet d’un VCS externe vers le VCS de l’espace de travail
Dans certains cas, il peut être souhaitable de migrer manuellement un projet utilisant un dépôt VCS externe vers un projet entièrement géré dans un espace de travail Altium et son dépôt VCS Git natif. Pour ce faire, vous pouvez créer un instantané de votre projet, ce qui le déconnecte du VCS externe et de l’espace de travail (s’il y a déjà été mis à disposition), puis le remettre à disposition dans l’espace de travail, mais cette fois sous le contrôle de son VCS, en repartant en quelque sorte de zéro. Pour cela, suivez la procédure ci-dessous :
- Déconnectez (retirez) votre projet du système de contrôle de version externe. Vous pouvez le faire depuis votre outil d’interface externe avec votre VCS actuel, ou dans Altium Designer. Dans ce dernier cas, bien que des commandes permettant de retirer le projet du contrôle de version soient disponibles dans le panneau Projects et le panneau Storage Manager, la méthode la plus propre consiste à utiliser Project Packager. L’utilisation de Project Packager permet de créer un instantané de votre projet, sans les données de contrôle de version et, si vous avez précédemment mis le projet à disposition dans l’espace de travail, de supprimer les liens vers le projet dans cet espace.
- Extrayez votre projet « nettoyé » de l’archive ZIP créée par Project Packager.
- Ouvrez le projet dans Altium Designer : vous constaterez qu’il n’est ni géré (s’il l’était auparavant), ni placé sous contrôle de version. Il s’agit donc d’un projet propre et non géré.
-
L’étape suivante ne s’applique que si vous avez précédemment mis le projet à disposition dans l’espace de travail. La création de l’archive a supprimé le lien du projet, mais le projet en miroir dans l’espace de travail est resté intact. Vous devez d’abord supprimer le projet côté serveur. Accédez à l’interface Web de l’espace de travail (via l’interface de la plateforme Altium 365). Depuis la Projects page, cliquez sur le projet à supprimer pour le sélectionner, puis cliquez sur la commande
et choisissez la commande Delete dans le menu contextuel.
- Mettez maintenant le projet à nouveau à disposition en ligne dans l’espace de travail. Pour ce faire, cliquez avec le bouton droit sur son entrée dans le panneau Projects et sélectionnez Make Project Available Online dans le menu contextuel pour accéder à la boîte de dialogue Make Available Online. Veillez à activer l’option Activer le contrôle de version formel, car c’est elle qui place le projet sous le contrôle du VCS intégré (Git) de l’espace de travail.
Passer du SVN de l’espace de travail au Git de l’espace de travail
Lorsqu’Altium Designer est connecté à un espace de travail Enterprise Server et qu’un projet de conception est stocké dans un dépôt SVN géré par le service de contrôle de version de l’espace de travail, vous pouvez migrer ce projet du dépôt SVN vers le dépôt Git intégré à l’espace de travail (Versioned Storage). Pour ce faire, cliquez avec le bouton droit sur son entrée dans le panneau Projects et sélectionnez la commande History & Version Control » Migrate Project to Altium Versioned Storage dans le menu contextuel. Vous pouvez également cliquer sur le bouton Migrate to Server Versioned Storage dans la boîte de dialogue Project Options.
Après avoir suivi les instructions, qui comprennent un dernier commit dans le VCS, le projet sera migré vers le contrôle de version du dépôt Git de l’espace de travail.
Contrôler la synchronisation du projet
Une fois qu’un projet local a été mis à disposition dans un espace de travail, les commandes permettant de gérer sa disponibilité en ligne et sa synchronisation se trouvent dans l’onglet Général de la boîte de dialogue Project Options.

Les options et commandes relatives à la mise à disposition du projet en ligne sont présentées dans l’onglet General de la boîte de dialogue Project Options.
Utilisez l’option disponible dans la zone General de l’onglet pour modifier la description du projet. Cette modification n’affecte que le projet dans l’espace de travail.
Dans la zone Online Availability and Synchronization de l’onglet, l’option Version Control indique le mode actuel de disponibilité en ligne :
-
Option Enabled – le projet (et ses fichiers sources) est stocké dans le VCS natif de l’espace de travail (Git). Il s’agit de l’approche recommandée, car elle vous donne accès à l’ensemble des fonctionnalités proposées par l’espace de travail et la plateforme Altium 365.
-
Option Disabled – les fichiers du projet sont stockés dans l’espace de travail pour permettre un accès de base et le partage avec d’autres utilisateurs, à des fins de consultation et de commentaire uniquement : il s’agit du mode Simple Sync (uniquement pour un espace de travail Altium 365).
Utilisez cette option pour passer d’un mode à l’autre selon vos besoins.
Si vous souhaitez arrêter la synchronisation entre votre projet local et sa version mise à disposition dans l’espace de travail, cliquez sur le bouton
. La fenêtre Turn off project synchronization s’affiche. Cliquez sur l’option Unlink , puis sur OK dans la boîte de dialogue Project Options. Le projet local ne sera plus associé au projet dans l’espace de travail.
Cela se reflète dans le panneau Projects après l’enregistrement du projet local : celui-ci apparaît sous le groupe de projets actif (*.DsnWrk), et non plus sous l’espace de travail actif. Un enregistrement est nécessaire, car les liens vers le projet dans l’espace de travail sont supprimés du fichier de projet.
Le projet dans l’espace de travail reste inchangé : cette action ne le supprime pas.
Vous pouvez rompre la connexion entre votre projet local et sa version mise à disposition dans l’espace de travail.
Vous pouvez toujours remettre le projet local à disposition en ligne, sous forme de projet en miroir ou de projet entièrement géré par VCS (Version Control). Lorsque vous êtes connecté à un espace de travail Altium 365, l’onglet General de la boîte de dialogue Project Options présente le bouton
, qui permet d’accéder à la boîte de dialogue Make Available Online.
Un projet local peut également être mis à disposition en ligne, dans l’espace de travail, depuis l’onglet General de la boîte de dialogue Project Options.



