Historique du projet
En un coup d'œil
- Apprenez à ouvrir l’historique des projets et des fichiers, à parcourir les événements et à filtrer la chronologie à l’aide de la recherche.
- Comprenez les prérequis de configuration, notamment l’extension Project History et le contrôle de version Git natif du Workspace.
- Découvrez comment examiner les modifications d’un commit, ouvrir des révisions en lecture seule, comparer les données de schéma, de PCB et de nomenclature, et gérer les étiquettes des commits.
Altium Designer, associé à un espace de travail connecté, vous permet de consulter et d’utiliser une Project History chronologie graphique avancée. La vue History dédiée présente une chronologie des événements majeurs liés au projet de PCB, de système multi-cartes ou de faisceau de câbles : création, commits, publications, copies et échanges MCAD. Diverses actions sont disponibles selon le contexte.
Accéder à l’historique du projet
Pour accéder à la vue History d’un projet de l’espace de travail depuis Altium Designer, faites un clic droit sur son entrée dans le panneau Projects et choisissez la commande History & Version Contol » Show Project History dans le menu contextuel. Vous pouvez également sélectionner la commande History & Version Control » Show Project History dans le menu principal Project pour ouvrir la vue Historique du projet actif de l’espace de travail. La vue History se présente sous la forme d’un document à onglet distinct (<ProjectName>.PrjPcb History).
Chronologie de l’historique – Présentation
La vue History présente une chronologie des événements de base survenus au cours de l’évolution du projet. Elle se compose essentiellement de trois éléments clés, comme le montrent l’image et les détails ci-dessous.
Identification des trois éléments clés de la vue History .
- Main trunk of the timeline. Les événements sont classés chronologiquement de bas en haut. Le premier événement, la création du projet, apparaît au bas de la chronologie. Les événements suivants apparaissent au-dessus, le plus récent figurant tout en haut.
- Events. Chaque fois qu’un événement pris en charge (voir ci-dessous) se produit en lien avec le projet, il est ajouté à la chronologie sous la forme d’une vignette dédiée. Chaque type d’événement possède une vignette de couleur différente, qui est soit directement reliée à l’axe principal de la chronologie, soit accompagnée d’une icône supplémentaire (comme pour les événements d’échange MCAD).
-
Search. Cliquez sur la commande
en haut à droite de la vue pour accéder à un champ permettant d’effectuer une recherche simple dans l’historique du projet. À mesure que vous saisissez votre recherche, la chronologie est filtrée pour n’afficher que les événements correspondants. Pour plus d’informations, consultez Recherche filtrée.
Événements pris en charge
La chronologie présente la succession des événements survenant au cours de la vie d’un projet. Chacun de ces événements apparaît dans la chronologie sous la forme d’une « vignette d’événement » dédiée. Les sections dépliables suivantes décrivent les différents événements actuellement pris en charge et pouvant figurer dans la chronologie de l’historique d’un projet.
Création du projet
Refer to: Créer un projet, Rendre un projet existant disponible en ligne
Lorsqu’un projet est créé, la vignette d’événement Project Created est ajoutée à la chronologie. Cet événement marque le début de l’historique du projet. Il figure donc toujours au bas de la chronologie. La vignette de cet événement peut se présenter sous deux formes distinctes :
- Lorsqu’un nouveau projet est créé dans l’espace de travail. Le nom (et la photo) du créateur du projet sont affichés, ainsi que la date et l’heure de création du projet. La description du projet apparaît également dans la vignette si elle a été renseignée lors de la création.
- Lorsque le projet est une copie d’un projet existant. Le nom de la personne ayant créé la copie du projet est affiché, ainsi que la date et l’heure de création du projet. La description du projet apparaît également dans la vignette si elle a été renseignée lors de la copie. Un lien vers le projet d’origine est fourni ; cliquez dessus pour accéder à la page de gestion détaillée de ce projet dans l’interface Web de l’espace de travail.
Commit du projet
Chaque fois que vous effectuez un commit d’un projet dans l’espace de travail (où le projet est géré dans le dépôt Git interne Versioned Storage de l’espace de travail), une tuile d’événement Project Committed est ajoutée à la chronologie. La personne ayant effectué le commit (enregistrement sur le serveur) est identifiée par son nom (et sa photo), accompagnés de la date et de l’heure. Si un commentaire a été ajouté lors du commit et envoyé au serveur à l’aide de la boîte de dialogue Commit to Version Control, il est également affiché dans la tuile.
Exemple de tuile d’événement initiale Project Committed.
La tuile prend également en charge et présente les informations de comparaison de conception, en détaillant ce qui a changé entre le commit actuel et le précédent. Les éléments pris en charge comprennent les fichiers, les composants, les nets, les variantes et la structure du PCB. La section de comparaison de la tuile résume les différents éléments concernés par le commit, regroupés selon les états suivants :
– élément ajouté.
– élément supprimé.
– élément modifié.
Un clic sur la commande
dans la tuile développe cette section de comparaison pour afficher le nom des éléments concernés.
Cliquez sur la commande
dans le coin supérieur droit de la tuile pour accéder à un menu proposant les commandes suivantes :
-
Download Sources - upermet de télécharger et d’ouvrir cette révision précise du projet PCB ou de faisceau dans le panneau Projects. Le nom du projet inclura la date et l’heure du commit de cette révision. Notez que cette révision est en lecture seule : vous pouvez la consulter, mais pas la modifier.

Vous pouvez ouvrir (pour consultation uniquement) n’importe quelle révision du projet directement depuis la tuile d’événement Project Committed correspondant à cette révision. -
Compare: Schematic to, PCB to, BOM to – permet de comparer les données de schéma, de PCB ou de nomenclature du projet PCB de ce commit avec celles d’un autre commit ou d’un événement de publication. Utilisez le sous-menu pour effectuer une comparaison avec le commit précédent ou sélectionner un élément parmi toutes les publications et tous les commits disponibles. Une fois les données à comparer choisies, les résultats de la comparaison sont présentés dans la vue des différences correspondante, qui s’ouvre dans un nouvel onglet de votre navigateur par défaut. Pour en savoir plus, consultez Design Data Comparisons (Espace de travail Altium 365, Espace de travail Enterprise Server).
-
Create Tag – permet d’ajouter une étiquette unique, avec un nom personnalisé, à n’importe quel commit d’un projet de conception (uniquement si ce projet est stocké dans un espace de travail sous son système VCS Git interne). Vous ne pouvez créer une étiquette que pour un commit déjà enregistré dans l’espace de travail. Après l’exécution de la commande, la boîte de dialogue Create Tag s’ouvre. Saisissez l’étiquette souhaitée, puis cliquez sur Create.
Lorsqu’une étiquette saisie contient un caractère non autorisé, l’icône
apparaît dans la boîte de dialogue Create Tag. Survolez l’icône pour afficher une infobulle indiquant les caractères autorisés, à savoir les lettres, les chiffres, le point (« . »), le tiret (« - »), le dièse (« # ») et le trait de soulignement (« _ ») ; modifiez l’étiquette si nécessaire.
Lorsque le projet est publié à l’aide de Project Releaser et que son dernier commit ne possède pas encore d’étiquette, une étiquette lui est automatiquement attribuée. Cette étiquette prend la forme RELEASE_<RevisionID>, où <RevisionID> est le numéro de révision des sources du projet publié (A.1, A.2, etc.), par exemple, RELEASE_A.3.
Pour renommer ou supprimer une étiquette, cliquez sur
puis survolez l’entrée Tag . Une boîte de dialogue s’ouvre pour vous permettre de saisir le nouveau nom de l’étiquette. Si Remove est sélectionné, l’étiquette est immédiatement supprimée.
- Créer une copie – permet de créer une copie à partir de cette révision précise du projet. La boîte de dialogue Create Project Copy s’ouvre pour vous permettre de saisir un Project Name (par défaut, il s’agit du nom du projet d’origine suivi du suffixe « - Copy »), Description (qui n’est pas prérempli), le chemin Folder (dans l’espace de travail) et le chemin Local Storage (vers la copie de travail). Le projet est créé et une tuile d’événement Project Copied est ajoutée à la chronologie.
-
Revert to – utilisez cette commande pour rétablir les données de cette révision précise du projet. Les données des documents sources du projet de cette révision remplacent celles de votre copie de travail locale du projet. En pratique, le projet est momentanément fermé, puis rouvert avec les données rétablies. Pour finaliser le rétablissement et faire de ces données la révision de tête (version actuelle), vous devez effectuer un commit du projet et le pousser vers l'espace de travail.
Vous pouvez revenir à n'importe quelle révision précise du projet directement à partir de la vignette d'événement Project Committed correspondant à cette révision.
Publication du projet
Related page: Publication du projet de conception
Chaque fois que vous publiez le projet PCB à l'aide de Project Releaser d'Altium Designer, une vignette d'événement Project Released est ajoutée à la chronologie. La personne ayant effectué la publication est identifiée par son nom (et sa photo), accompagnés de la date et de l'heure. Si une note de publication a été ajoutée lors de la publication des données générées dans l'espace de travail, via la boîte de dialogue Confirm Release, elle apparaît également dans la vignette. Chacun des jeux de données inclus dans la publication est également répertorié.
Exemple de vignette d'événement Project Released.
Cliquez sur la commande
dans le coin supérieur droit de la vignette pour accéder à un menu proposant les commandes suivantes :
- Download Sources – utilisez cette commande pour télécharger, puis ouvrir (dans le panneau Projects ) la révision précise du projet à partir de laquelle ce package de publication a été généré. Le nom du projet inclut la version de publication. Notez que cette révision est en lecture seule : vous pouvez la consulter, mais vous ne pouvez la modifier d'aucune manière.
- Compare : Schematic to, PCB to, Gerber to, BOM to – permet de comparer les données de schéma, de PCB ou de nomenclature de cette publication avec celles d'une autre publication ou d'un événement de commit. Pour les fichiers Gerber générés, vous pouvez comparer les données de cette publication avec celles d'une autre publication ou, si vous utilisez un espace de travail Altium 365, avec un jeu de fichiers Gerber importé. Utilisez le sous-menu pour sélectionner le jeu de données à comparer. Une fois les données sélectionnées, les résultats de la comparaison s'affichent dans la vue des différences correspondante, qui s'ouvre dans un nouvel onglet de votre navigateur par défaut. Pour plus d'informations, consultez Design Data Comparisons (Espace de travail Altium 365, Espace de travail Enterprise Server).
Copie d'un projet
Chaque fois que vous copiez le projet, depuis l'interface Web de l'espace de travail ou depuis Altium Designer, une vignette d'événement Project Copied est ajoutée à la chronologie. La personne ayant effectué la copie est identifiée par son nom et sa photo, accompagnés de la date et de l'heure. Si une description a été ajoutée lors de la copie via la fenêtre Clone Project (dans le navigateur) ou la boîte de dialogue Create Project Copy (dans Altium Designer), elle apparaît également dans la vignette. Un lien vers le projet copié est fourni. Cliquez dessus pour accéder à la page de gestion détaillée de ce projet dans l'interface Web de l'espace de travail.
Exemple de vignette d'événement Project Copied.
Échanges MCAD
Related page: Altium MCAD CoDesigner
Lorsque vous travaillez entre les domaines de la conception électronique et de la conception mécanique, l'espace de travail sert de passerelle entre les deux, facilitant la coconception directe ECAD-MCAD. Chaque fois que la conception PCB du projet est modifiée et que ces modifications sont poussées vers l'espace de travail via le panneau CoDesigner correspondant, une vignette d'événement MCAD Changes Suggested est ajoutée à la chronologie. La personne ayant effectué l'envoi est identifiée par son nom (et sa photo), accompagnés de la date et de l'heure. Si un message a été ajouté au moment de l'envoi, via le panneau MCAD CoDesigner (dans Altium Designer) ou le panneau Altium CoDesigner (dans le logiciel MCAD pris en charge), il apparaît également dans la vignette.
Exemple de vignette d'événement MCAD Changes Suggested.
Lorsque l'ingénieur MCAD modifie le PCB dans son logiciel MCAD pris en charge et pousse ces modifications vers l'espace de travail, l'événement d'envoi correspondant apparaît dans la chronologie de l'historique du projet only après récupération des modifications de l'espace de travail dans Altium Designer.
Exemple montrant deux événements liés à la MCAD. À gauche de l'axe de la chronologie, l'événement d'envoi côté ECAD et, à droite, l'événement d'envoi côté MCAD.
Modifications locales
Lorsque des documents du projet PCB sont enregistrés localement, mais pas encore dans l’espace de travail, une vignette d’événement Local Changes est ajoutée en haut de la chronologie. La personne ayant effectué l’enregistrement local (c’est-à-dire l’utilisateur actuel) est identifiée par son nom (et sa photo).

Exemple de vignette d’événement Local Changes.
Cliquez sur la commande
dans le coin supérieur droit de la vignette pour accéder à un menu proposant la commande suivante :
- Compare : Schematic to, PCB to, BOM to – permet de comparer les données de schéma, de PCB ou de nomenclature enregistrées localement dans ce commit avec celles d’un événement de commit ou de publication. Utilisez le sous-menu pour les comparer aux données sources de la publication précédente, à celles du commit précédent, ou pour faire votre choix parmi toutes les publications et tous les commits disponibles. Une fois les données à comparer choisies, les résultats s’affichent dans la vue des différences correspondante, qui s’ouvre dans un nouvel onglet de votre navigateur par défaut. Pour en savoir plus, consultez Design Data Comparisons (espace de travail Altium 365, espace de travail Enterprise Server).
Recherche filtrée
Cliquez sur la commande
en haut à droite de la vue pour accéder à un champ de recherche permettant de trouver rapidement les événements qui vous intéressent dans la chronologie. La fonction de recherche permet d’effectuer des recherches simples dans l’historique du projet, avec un filtrage dynamique à mesure que vous saisissez votre texte de recherche : seuls les événements pertinents restent affichés sur la page. Le texte correspondant est mis en surbrillance dans chaque vignette d’événement.
Exemple de recherche dans l’historique d’un projet. La chronologie est filtrée dynamiquement à mesure que vous saisissez votre terme de recherche (sans distinction de casse), et les correspondances sont mises en surbrillance dans chaque vignette d’événement pertinente.
La recherche porte sur les informations suivantes :
- Le titre de la vignette d’événement.
- Le nom de la personne à l’origine de l’événement.
- Le texte descriptif (issu d’un commentaire, d’une note ou d’une description saisis au moment de l’événement concerné).
- Le texte des données de comparaison – dans une vignette d’événement Project Committed.
- Le nom du jeu de données – dans une vignette d’événement Project Released.
- Le nom du projet – dans une vignette d’événement Project Copied et une vignette d’événement Project Created (lors d’une création par copie).
Mise à jour avec de nouveaux événements
Chaque fois qu’un événement pris en charge se produit dans le projet, il est détecté et automatiquement mis à disposition dans la vue History . Une notification s’affiche en bas de la vue peu après l’événement : cliquez sur la commande
pour ajouter le nouvel événement à la chronologie.
Création d’un rapport d’historique du projet
Un rapport d’historique du projet au format PDF peut être créé pour un projet de l’espace de travail. Ce rapport présente toutes les informations relatives à l’historique du projet, notamment sa création, ses commits et ses publications, ainsi qu’une description des modifications depuis l’événement précédent. Vous pouvez également définir la période couverte par le rapport (voir ci-dessous) afin d’obtenir un rapport parfaitement adapté à vos besoins.
Depuis un OutJob
Pour créer le rapport, dans le fichier OutputJob (*.OutJob), cliquez avec le bouton droit sur le [Add New Report Output] associé à l’entrée Report Outputs, puis choisissez Project History, comme illustré ci-dessous.
Reliez le rapport nouvellement créé à un conteneur de sortie PDF. Définissez la période couverte par le rapport en cliquant avec le bouton droit sur la sortie créée, puis en sélectionnant Configure. Activez la Period souhaitée : For all time (de la création du projet à aujourd’hui), ou Specific releases (utilisez les listes déroulantes du champ From/To pour définir les publications souhaitées). Le rapport exporté contiendra les informations correspondant à la période sélectionnée.
Une fois le rapport créé, relié à un conteneur de sortie PDF et configuré, cliquez sur Generate content, dans la zone du conteneur PDF. Si vous le souhaitez, vous pouvez également générer le rapport d’historique du projet dans le cadre du processus de publication du projet.


pour ouvrir la boîte de dialogue Choose Folder (une version simplifiée du panneau Explorer) afin de modifier le dossier selon vos besoins. Le Local Storage sera, par défaut, configuré pour utiliser l'emplacement défini sur la page 

