Historique du projet
Altium Designer, associé à un Workspace connecté, vous permet d’afficher et d’utiliser une Project Historychronologie 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 commits, ses publications, ses copies et ses échanges MCAD – avec diverses actions prises en charge lorsque cela s’applique.
Accès à 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 panneau Projects et 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 Project menu principal pour ouvrir la vue History du projet Workspace actif. La History vue se présente comme un document distinct à onglets (<ProjectName>.PrjPcb History).
Chronologie de l’historique – Vue d’ensemble
La History vue présente une chronologie des événements de base survenus pendant l’évolution du projet. Elle peut essentiellement être décomposée en trois sections clés, comme le montre l’image suivante et les détails associés.
Identification des trois composants clés de la History vue.
- Main trunk of the timeline. La direction de la chronologie 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) survient 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 la 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 survenant pendant 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 présentent la plage d’événements actuellement pris en charge et affichables 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 bas de la chronologie. La vignette de cet événement peut apparaître sous deux variantes distinctes :
- Lorsqu’un projet est créé directement dans le Workspace. Le créateur du projet est indiqué par son nom (et sa photo), ainsi que par 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 par 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 effectuez un Commit d’un projet vers le Workspace (lorsque le projet est géré dans le dépôt Versioned Storage Git interne du Workspace), une vignette d’événement Project Committed est ajoutée à la chronologie. La personne ayant effectué le commit (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 du commit et envoyé – à l’aide de la boîte de dialogue Commit to Version Control dialog – 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 des différences de conception, montrant des informations plus détaillées sur 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 PCB. La section de comparaison de la vignette résume les différents éléments affectés par l’événement de commit, regroupés selon les états suivants :
– élément ajouté.
– élément supprimé.
– élément modifié.
Un clic sur le contrôle
dans la vignette développe cette section de comparaison afin de présenter par leur nom les éléments affectés.
Cliquez sur le contrôle
dans l’angle supérieur droit de la vignette pour accéder à un menu proposant 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 l’afficher mais pas la modifier.

Vous pouvez ouvrir (en affichage 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 – permet de comparer les données Schematic, PCB ou BOM de ce commit avec celles d’un autre événement de commit ou de publication. Utilisez le sous-menu pour comparer avec le commit précédent ou sélectionnez parmi toutes les publications et commits possibles. Une fois les données choisies pour la comparaison, les résultats sont présentés dans la vue de différences associée, qui s’ouvre comme un nouvel onglet dans votre navigateur par défaut. Pour plus d’informations, consultez Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
-
Create Tag – ajoute un tag unique nommé de manière 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 VCS Git interne). Vous pouvez créer un tag uniquement pour le 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 le tag souhaité puis cliquez sur Create.
Lorsqu’un tag saisi 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 « indication » des caractères autorisés, à savoir les lettres, les chiffres, le point ('.'), le tiret ('-'), le signe dièse ('#') et le caractère de soulignement ('_') ; mettez à jour le tag si nécessaire.
Lorsque le projet est publié à l’aide de Project Releaser et que son dernier commit n’a pas encore de tag, un tag sera automatiquement attribué à ce dernier commit. Ce tag 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 un tag, cliquez sur
puis survolez l’entrée Tag . Une boîte de dialogue s’ouvrira dans laquelle vous pourrez saisir le nouveau nom du tag. Si Remove est sélectionné, le tag est supprimé immédiatement.
-
Créer une copie – 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
(dans le Workspace) et le chemin (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 à l’utilisation des données de cette révision spécifique du projet. Les données des documents source du projet dans cette révision spécifique remplacent 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 rétablies. Si vous souhaitez finaliser le retour et faire de ces données la Head Revision (version actuelle), vous devez effectuer un commit et envoyer à nouveau 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 d’un 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 par la date et l’heure. Si une note de publication a été ajoutée lors de la publication des données générées vers le Workspace – via la boîte de dialogue Confirm Release dialog – elle 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 proposant 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 l’afficher, mais pas la modifier de quelque manière que ce soit.
- Compare: Schematic to, PCB to, Gerber to, BOM to – permet de comparer les données Schematic, PCB ou BOM de cette publication avec celles d’un autre événement de publication ou de commit. Pour le Gerber généré, vous pouvez comparer les données de cette publication avec celles d’une autre publication ou, lors de l’utilisation d’un Workspace Altium 365, avec un jeu 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 de différences associée, qui s’ouvre comme un nouvel onglet dans votre navigateur par défaut. Pour plus d’informations, consultez 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 (navigateur) ou la boîte de dialogue Create Project Copy (Altium Designer), elle sera également affichée dans la vignette. Un lien vers le projet copié est fourni. En cliquant dessus, vous accédez à 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
Lors du travail 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 envoyées au Workspace via le panneau CoDesigner concerné, une vignette d’événement MCAD Changes Suggested est ajoutée à la chronologie. La personne ayant effectué l’envoi est indiquée par son nom (et sa photo), ainsi que par la date et l’heure. Si un message a été publié au moment de l’envoi – via le panneau MCAD CoDesigner (Altium Designer), ou le panneau Altium CoDesigner (dans le logiciel MCAD pris en charge) – il 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 renvoie vers le Workspace, l’événement de publication correspondant sera disponible dans la chronologie de l’historique du projet only après récupération des modifications depuis le Workspace dans Altium Designer.
Exemple montrant deux événements liés au MCAD. À gauche du tronc de la chronologie, l’événement de publication du côté ECAD, et à droite, l’événement de publication du côté MCAD.
Modifications locales
Lorsqu’il existe des documents de projet PCB enregistrés localement mais pas encore dans le Workspace, une vignette d’événement Local Changes sera ajoutée en haut de la chronologie. La personne ayant effectué l’enregistrement local (c’est-à-dire l’utilisateur actuel) est indiquée par son nom (et sa photo).

Exemple de vignette d’événement Local Changes.
Cliquez sur le contrôle
en haut à droite 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 Schematic, PCB ou BOM enregistrées localement dans ce commit avec celles d’un événement de commit ou de version. Utilisez le sous-menu pour comparer avec les données source de la version précédente, les données source du commit précédent, ou sélectionnez parmi toutes les versions 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 pertinents dans la chronologie. La fonction de recherche prend en charge une recherche simple dans l’historique du projet, avec un filtrage dynamique appliqué à 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 recherche fonctionne avec 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 différenciation – 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
Dès 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 de projet
Un rapport d’historique de projet au format PDF peut être créé pour un projet du Workspace. Le rapport affiche toutes les informations sur l’historique du projet, y compris la création, les commits et les versions, ainsi qu’une description des changements par rapport à 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.
Reliez 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 à aujourd’hui), ou Specific releases (utilisez les listes déroulantes du champ From/To pour définir les versions 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 publication du projet.


pour ouvrir la boîte de dialogue Choose Folder (une version allégé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 

