Historique du projet
Altium Designer, en association avec un Workspace connecté, vous permet d’afficher et d’utiliser une Project HistorychronologieProject History avancée à orientation graphique. La Historyvue dédiée fournit une chronologie progressive des événements majeurs liés au projet PCB, Multi-board ou Harness — sa création, ses validations, ses versions, ses copies et ses échanges MCAD — avec diverses actions prises en charge lorsque cela s’applique.
Accéder à l’historique du projet
Pour accéder à la Historyvue d’un projet Workspace depuis Altium Designer, cliquez avec le bouton droit sur son entrée dans le Projectspanneau, puis choisissez la History & Version Contol » Show Project History commande dans le menu contextuel. Vous pouvez également sélectionner la History & Version Control » Show Project History commande dans le Projects menu principal pour ouvrir la vue History du projet Workspace actif. La History vue se présente sous la forme d’un document à onglet distinct (<ProjectName>.PrjPcb History).
Chronologie de l’historique — Vue d’ensemble
La History vue présente une chronologie des événements de base survenus au cours de l’évolution du projet. Elle peut essentiellement être divisée en trois sections clés, comme illustré dans l’image suivante et détaillé ci-dessous.
Identification des trois composants clés de la History vue.
- Main trunk of the timeline. Le sens chronologique des événements va du bas vers le haut. Le premier événement — la création du projet — apparaît en bas de la chronologie. Les événements suivants apparaissent au-dessus, le plus récent (l’événement le plus actuel) figurant en haut de la chronologie.
- Events. Chaque fois qu’un événement pris en charge (voir ci-dessous) se produit en lien avec le projet, cet événement 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 et sera soit relié directement au tronc principal de la chronologie, soit accompagné d’une icône supplémentaire à côté (comme c’est le cas pour les événements MCAD Exchange).
-
Search. Cliquez sur le contrôle
en haut à droite de la vue pour accéder à un champ de recherche facilitant une recherche simple dans l’historique du projet. À mesure que vous saisissez votre chaîne de recherche, un filtrage est appliqué à la chronologie afin de n’afficher que les événements pertinents pour cette recherche. Pour plus d’informations, consultez Recherche filtrée.
Événements pris en charge
La chronologie montre la progression des événements qui surviennent au cours de la vie d’un projet. Chacun de ces événements apparaît le long de la chronologie sous la forme d’une « vignette d’événement » dédiée. Les sections extensibles suivantes examinent la plage d’événements actuellement pris en charge et pouvant être présentés dans la chronologie historique d’un projet.
Project Creation
Refer to: Création d’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 la chronologie historique du projet. À ce titre, il se trouve toujours en entrée au bas de la chronologie. La vignette de cet événement peut apparaître sous deux variantes distinctes :
- Lorsqu’un projet est nouvellement créé dans le Workspace. Le créateur du projet est indiqué par son nom (et sa photo), ainsi que la date et l’heure de création du projet. La description du projet est également affichée dans la vignette si elle a été saisie au moment de la création.
- Lorsque le projet est une copie d’un projet existant. La personne ayant créé le projet copié est indiquée par son nom, ainsi que la date et l’heure de création du projet. La description du projet est également affichée dans la vignette si elle a été saisie au moment de la copie. Un lien vers le projet d’origine est fourni ; en cliquant dessus, vous accédez à la page de gestion détaillée de ce projet via l’interface navigateur du Workspace.
Project Commit
Chaque fois que vous validez un projet dans le Workspace (lorsque le projet est géré dans le dépôt Git Versioned Storage interne du Workspace), une vignette d’événement Project Committed est ajoutée à la chronologie. La personne ayant effectué la validation (Save to Server) est indiquée par son nom (et sa photo), ainsi que la date et l’heure. Si un commentaire a été ajouté au moment de la validation et envoyé — à l’aide de la boîte de dialogue Commit to Version Control — il sera également affiché dans la vignette.
Exemple de vignette d’événement initiale Project Committed.
La vignette prend également en charge et présente des informations de comparaison de conception, montrant des informations plus détaillées sur ce qui a changé entre la validation actuelle et la précédente. 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 vignette résume les différents éléments affectés par l’événement de validation, regroupés selon les états suivants :
– élément ajouté.
– élément supprimé.
– élément modifié.
En cliquant sur le contrôle
dans la vignette, cette section de comparaison se développe pour présenter les éléments affectés par leur nom.
Cliquez sur le contrôle
dans l’angle supérieur droit de la vignette pour accéder à un menu contenant les commandes suivantes :
-
Download Sources - uà utiliser pour télécharger et ouvrir cette révision spécifique du projet PCB ou Harness dans le panneau Projects. Le nom du projet inclura la date et l’heure auxquelles cette révision a été validée. Notez que cette révision est en lecture seule ; vous pouvez la consulter mais pas la modifier.

Vous pouvez ouvrir (en consultation uniquement) n’importe quelle révision spécifique du projet — directement depuis la vignette d’événement Project Committed correspondante pour cette révision. -
Compare: Schematic to, PCB to, BOM to – vous permet de comparer les données Schématique, PCB ou BOM du projet PCB dans ce commit avec celles d’un autre commit ou événement de publication. Utilisez le sous-menu pour comparer avec le commit précédent ou sélectionnez parmi toutes les publications et tous les commits possibles. Une fois les données choisies pour la comparaison, les résultats sont présentés dans la vue des différences associée, qui s’ouvre dans un nouvel onglet de votre navigateur par défaut. Pour plus d’informations, voir Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
-
Create Tag – ajoute une balise unique, nommée de façon personnalisée, à n’importe quel commit d’un projet de conception (et uniquement lorsque ce projet est stocké dans un Workspace sous son système interne Git VCS). Vous pouvez créer une balise uniquement pour un commit déjà enregistré dans le Workspace. Après l’exécution de la commande, la boîte de dialogue Create Tag s’ouvre. Saisissez la balise souhaitée puis cliquez sur Create.
Lorsqu’une balise 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 « aide » indiquant quels caractères sont autorisés, à savoir les lettres, les chiffres, le point ('.'), le tiret ('-'), le dièse ('#') et le trait de soulignement ('_') ; mettez à jour la balise si nécessaire.
Lorsque le projet est publié à l’aide du Project Releaser et que son dernier commit n’a pas encore de balise, une balise sera automatiquement attribuée à ce dernier commit. Cette balise sera de 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 balise, cliquez sur
puis survolez l’entrée Tag . Une boîte de dialogue s’ouvre dans laquelle vous pouvez saisir le nouveau nom de la balise. Si Remove est sélectionné, la balise est supprimée immédiatement.
- Make a copy – permet de créer une copie à partir de cette révision spécifique du projet. La boîte de dialogue Create Project Copy s’ouvre, dans laquelle vous saisissez un Project Name (par défaut, il s’agira du nom du projet d’origine avec le suffixe ' - Copy'), Description (qui n’est pas prérempli), le chemin Folder (dans le Workspace) et le chemin Local Storage (vers la copie de travail). Le projet sera créé et une vignette d’événement Project Copied sera ajoutée à la chronologie.
-
Revert to – utilisez cette commande pour revenir aux données de cette révision spécifique du projet. Les données des documents source du projet dans cette révision spécifique écrasent les données de votre copie de travail locale du projet. En pratique, le projet est momentanément fermé puis rouvert avec ces données restaurées. Si vous souhaitez finaliser le retour en arrière et faire de ces données la Head Revision (version actuelle), vous devez valider et pousser le projet vers le Workspace.
Vous pouvez revenir à n’importe quelle révision spécifique du projet directement depuis la vignette d’événement Project Committed correspondante pour cette révision.
Project Release
Related page: Publication du projet de conception
Chaque fois que vous effectuez une publication du projet PCB – à l’aide du Project Releaser d’Altium Designer – une vignette d’événement Project Released est ajoutée à la chronologie. La personne ayant effectué la publication est indiquée par son nom (et sa photo), ainsi que la date et l’heure. Si une note de publication a été ajoutée au moment de publier les données générées dans le Workspace – via la boîte de dialogue Confirm Release dialog – celle-ci sera également affichée dans la vignette. Chacun des jeux de données inclus dans la publication sera également listé.
Exemple de vignette d’événement Project Released.
Cliquez sur le contrôle
dans l’angle supérieur droit de la vignette pour accéder à un menu contenant les commandes suivantes :
- Download Sources – utilisez cette commande pour télécharger puis ouvrir (dans le panneau Projects ) la révision spécifique du projet à partir de laquelle ce package de publication a été généré. Le nom du projet inclura la version de publication. Notez que cette révision est en lecture seule ; vous pouvez la consulter, mais pas la modifier de quelque manière que ce soit.
- Compare: Schematic to, PCB to, Gerber to, BOM to – vous permet de comparer les données Schématique, PCB ou BOM de cette publication avec celles d’une autre publication ou d’un événement de commit. Pour les Gerber générés, vous pouvez comparer les données de cette publication avec celles d’une autre publication ou, lorsque vous utilisez un Altium 365 Workspace, avec un ensemble de fichiers Gerber téléversé. Utilisez le sous-menu pour comparer avec le jeu de données requis. Une fois les données choisies pour la comparaison, les résultats sont présentés dans la vue des différences associée, qui s’ouvre dans un nouvel onglet de votre navigateur par défaut. Pour plus d’informations, voir Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
Copying a Project
Chaque fois que vous copiez le projet, soit via l’interface navigateur du Workspace, soit depuis Altium Designer, une vignette d’événement Project Copied est ajoutée à la chronologie. La personne ayant effectué la copie est indiquée par son nom, sa photo, ainsi que la date et l’heure. Si une description a été ajoutée au moment 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 sera également affichée dans la vignette. Un lien vers le projet copié est fourni. En cliquant dessus, vous accéderez à la page de gestion détaillée de ce projet via l’interface navigateur du Workspace.
Exemple de vignette d’événement Project Copied.
MCAD Exchanges
Related page: Altium MCAD CoDesigner
Lorsque vous travaillez entre les domaines de la conception électronique et mécanique, le Workspace sert de passerelle entre les deux – en facilitant la co-conception ECAD-MCAD directe. Chaque fois que des modifications sont apportées à la conception PCB du projet et que ces modifications sont poussées vers le Workspace via le panneau CoDesigner approprié, une vignette d’événement MCAD Changes Suggested est ajoutée à la chronologie. La personne ayant effectué le push est indiquée par son nom (et sa photo), ainsi que la date et l’heure. Si un message a été publié au moment du push – via le panneau MCAD CoDesigner (Altium Designer), ou le panneau Altium CoDesigner (dans le logiciel MCAD pris en charge) – celui-ci sera également affiché dans la vignette.
Exemple de vignette d’événement MCAD Changes Suggested.
Lorsque l’ingénieur MCAD apporte des modifications au PCB dans son logiciel MCAD pris en charge et les repousse vers le Workspace, l’événement de push correspondant sera disponible sur la chronologie de l’historique du projet only après extraction des modifications du Workspace dans Altium Designer.
Exemple montrant deux événements liés au MCAD. À gauche du tronc de la chronologie, l’événement de push provenant du côté ECAD, tandis qu’à droite, l’événement de push provenant du côté MCAD.
Local Changes
Lorsqu’il existe des documents de projet PCB enregistrés localement mais pas encore dans le Workspace, 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 affichée par son nom (et sa photo).

Exemple de vignette d’événement Local Changes.
Cliquez sur le contrôle
dans l’angle supérieur droit de la vignette pour accéder à un menu contenant la commande suivante :
- Compare : Schematic to, PCB to, BOM to – permet de comparer les données Schématique, PCB, ou BOM enregistrées localement dans ce commit avec celles d’un événement de commit ou de release. Utilisez le sous-menu pour comparer avec les données source de la release précédente, les données source du commit précédent, ou sélectionner parmi toutes les releases et tous les commits possibles. Une fois les données choisies pour la comparaison, les résultats sont présentés dans la vue des différences associée, qui s’ouvre dans un nouvel onglet de votre navigateur par défaut. Pour plus d’informations, voir Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
Recherche filtrée
Cliquez sur le contrôle
en haut à droite de la vue pour accéder à un champ de recherche permettant de trouver rapidement les événements intéressants le long de la chronologie. La fonction de recherche prend en charge une recherche de base dans l’historique du projet, avec un filtrage dynamique appliqué au fur et à mesure que vous saisissez votre chaîne de recherche, de sorte que seuls les événements pertinents pour cette recherche restent affichés sur la page. Le texte correspondant dans une vignette d’événement est mis en surbrillance.
Exemple de recherche dans l’historique d’un projet. La chronologie est filtrée dynamiquement à mesure que vous saisissez votre terme de recherche (insensible à la casse), avec les entrées correspondantes mises en surbrillance dans chaque vignette d’événement pertinente.
La fonction de recherche s’appuie sur les informations suivantes :
- Titre de la vignette d’événement.
- Nom de la personne ayant effectué l’événement.
- Texte descriptif (texte provenant d’un commentaire/une note/une description au moment où l’événement concerné s’est produit).
- Texte des données de comparaison – dans une vignette d’événement Project Committed.
- Nom de l’ensemble de données – dans une vignette d’événement Project Released.
- Nom du projet – dans une vignette d’événement Project Copied et une vignette d’événement Project Created (lorsqu’elle est créée par copie).
Mise à jour avec de nouveaux événements
Chaque fois qu’un événement pris en charge se produit en lien avec le projet, cet événement est détecté et rendu automatiquement disponible dans la vue History . Une notification apparaît en bas de la vue peu après que l’événement s’est produit ; cliquez sur le contrôle
pour mettre à jour la chronologie avec le nouvel événement.
Création d’un rapport d’historique du projet
Un rapport d’historique du projet au format PDF peut être créé pour un projet Workspace. Le rapport affiche toutes les informations sur l’historique du projet, y compris la création, les commits et les releases, 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 (décrite ci-dessous) afin d’obtenir le rapport précis dont vous avez besoin.
À partir d’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.
Connectez le rapport nouvellement créé à un conteneur de sortie PDF. Définissez la période du rapport en cliquant avec le bouton droit sur la sortie créée puis en sélectionnant Configure. Activez la Period temporelle souhaitée : For all time (de la création du projet jusqu’à aujourd’hui), ou Specific releases (utilisez les listes déroulantes du champ From/To pour définir les releases souhaitées). Le rapport exporté contiendra les informations correspondant à la période sélectionnée.
Une fois votre rapport créé, lié à un conteneur de sortie PDF et configuré, dans la zone du conteneur PDF, cliquez sur Generate content, ou, si vous le souhaitez, vous pouvez générer le rapport d’historique du projet dans le cadre du processus de project release.
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, défini pour utiliser l’emplacement indiqué sur la page