Historique du projet
En un coup d'œil
- Découvrez où trouver la vue Historique et comment sa chronologie organise les événements du projet.
- Comprenez les exigences en matière de gestion de versions pour consulter l’historique des commits.
- Découvrez comment examiner les modifications d’un commit, ouvrir des instantanés antérieurs de la conception et ajouter des étiquettes aux commits.
Ne pas pouvoir accéder facilement à l’historique du développement d’un projet est souvent une source de frustration pour les concepteurs et les chefs de produit. Trop souvent, un concepteur doit se familiariser avec des outils externes de gestion de versions (VCS), dont l’utilisation peut exiger un niveau d’expertise assez élevé, ce qui prend beaucoup de temps lorsqu’il souhaite simplement effectuer des tâches courantes de gestion de projet. Même si vous maîtrisez les outils VCS externes, ils ne couvrent que certains aspects du projet : les actions liées à la gestion de versions, comme l’ouverture, le clonage et le rétablissement d’une version antérieure. Mais qu’en est-il de la gestion de projet au sens large, notamment des publications et des échanges MCAD ? Sans oublier que la plupart de ces opérations nécessitent généralement de rester à son poste de travail.
Pour répondre de manière élégante au besoin de consulter ces informations et d’interagir avec elles depuis un emplacement unique, l’espace de travail Altium 365 propose la notion de Project History. Accessible depuis l’interface Web de l’espace de travail (qui fait partie de l’interface de la plateforme Altium 365) ou depuis Altium Designer, une vue History dédiée présente une chronologie des événements majeurs du projet : sa création, les commits, les publications, les clonages et les échanges MCAD. Diverses actions, comme la consultation d’un instantané des sources de conception, sont proposées lorsqu’elles sont applicables.
Accéder à l’historique du projet
La vue History d’un projet est accessible depuis la page de gestion détaillée de ce projet. Cliquez sur l’entrée History dans le volet de gauche.
Accédez à l’historique d’un projet depuis sa page de gestion détaillée.
Chronologie de l’historique – Présentation
La vue History présente une chronologie des principaux événements survenus au cours de l’évolution du projet. Elle se compose essentiellement de trois éléments clés, illustrés dans l’image suivante et détaillés ci-après.
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 se trouvant 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, 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 reliée directement à l’axe principal de la chronologie, soit accompagnée d’une icône supplémentaire (comme dans le cas des échanges 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 texte de recherche, la chronologie est filtrée pour n’afficher que les événements pertinents. Pour plus d’informations, consultez Recherche avec filtrage.
Événements pris en charge
La chronologie présente la succession des événements qui surviennent au cours de la vie d’un projet. Chacun de ces événements y apparaît sous la forme d’une « vignette d’événement » dédiée. Les sections 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
Related pages: Création d’un projet géré (interface Web / Altium Designer), Mise en ligne d’un projet existant, Clonage d’un projet (interface Web / Altium Designer)
Lorsqu’un projet est créé, la vignette d’événement Project Createdest ajoutée à la chronologie. Cet événement marque le début de l’historique du projet. Il figure donc toujours en bas de la chronologie. La vignette de cet événement peut se présenter sous deux formes distinctes :
- Lorsque le projet vient d’être créé dans l’espace de travail. Le nom du créateur du projet (ainsi que sa photo) est affiché, avec 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 un clone d’un projet existant. Le nom (et la photo) de la personne qui a créé le projet cloné sont affichés, ainsi que la date et l’heure de création du projet. La description du projet figure également dans la tuile, si elle a été renseignée lors du clonage. Un lien vers le projet d’origine est fourni : cliquez dessus pour accéder à la page de gestion détaillée de ce projet, qui s’ouvre dans un nouvel onglet du navigateur.
Commit du projet
Chaque fois que vous effectuez un Commit & Push du projet vers 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. Le nom (et la photo) de la personne qui a effectué le commit et le push sont affichés, ainsi que la date et l’heure. Si un commentaire a été ajouté lors du commit et du push — via la boîte de dialogue Commit to Version Control — il figure également dans la tuile.
Exemple de tuile d’événement Project Committed initiale.
La tuile prend également en charge et affiche les informations de comparaison de conception, avec des détails sur les modifications 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écapitule les différents éléments concernés par l’événement de commit, regroupés selon les états suivants :
– élément ajouté.
– élément supprimé.
– élément modifié.
Cliquez sur la commande
dans la tuile pour développer cette section de comparaison et 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 :
- View – utilisez cette commande pour ouvrir les données de conception source du commit sélectionné dans le Web Viewer, sous la forme d’un instantané de la conception à ce moment-là.
- Create Tag – ajoutez un nom de tag VCS au commit actuellement sélectionné. Les tags associés à un commit apparaissent dans sa tuile de la vue Historique, dans l’en-tête de son instantané dans le Web Viewer et dans tous les commentaires associés à cet instantané. Une fois un tag ajouté à un commit, la commande du menu de la tuile devient Tag et propose des sous-options permettant de modifier (Edit) ou de supprimer (Remove) le tag du commit.
Sélectionnez l’option de menu Créer un tag pour ajouter un nom de tag à un événement de commit dans l’historique.
L’instantané d’un événement de commit de l’historique auquel un tag est associé porte le nom de ce tag.
Lorsque les commentaires sont consultés dans la conception en cours de travail (WIP), ceux créés dans l’instantané d’un commit portant un tag incluent le nom du tag associé. Cliquez sur le lien du nom du tag pour ouvrir l’instantané du commit correspondant. Consultez Commentaires dans le Web Viewer pour en savoir plus sur l’utilisation des commentaires.
Les commentaires ajoutés à l’instantané d’un événement de commit portant un tag incluent le nom du tag associé.
L’événement de commit associé à une publication du projet, créée par le Project Releaser d’Altium Designer, reçoit automatiquement un tag correspondant à l’identifiant de révision de la publication. Si nécessaire, le tag de révision ainsi associé au commit peut ensuite être modifié ou supprimé. Pour plus d’informations à ce sujet, consultez Publier dans un espace de travail.
Altium Designer attribue automatiquement au commit associé à une publication un tag correspondant à l’identifiant de la publication.
- Schematic to – permet de comparer les données schématiques de ce commit à celles d’un autre événement de commit ou de publication. Utilisez le sous-menu pour les comparer aux données source du commit précédent, ou faites votre choix parmi tous les commits ou toutes les publications disponibles. Une fois la publication ou le commit de référence choisi, les résultats de la comparaison sont présentés dans la vue Comparaison, qui s’ouvre dans un nouvel onglet de votre navigateur Web par défaut. Pour plus d’informations, consultez Comparaison de schémas.
- PCB to – permet de comparer les données PCB de ce commit à celles d’un autre événement de commit ou de publication. Utilisez le sous-menu pour les comparer aux données source du commit précédent, ou faites votre choix parmi tous les commits ou toutes les publications disponibles. Une fois la publication ou le commit de référence choisi, les résultats de la comparaison sont présentés dans la vue Comparaison, qui s’ouvre dans un nouvel onglet de votre navigateur Web par défaut. Pour plus d’informations, consultez Comparaison de PCB.
- BOM to – vous permet de comparer les données de nomenclature de ce commit à celles d’un autre commit ou d’une autre publication. Utilisez le sous-menu associé pour les comparer aux données de nomenclature du commit précédent, ou choisissez parmi tous les commits et toutes les publications du projet. Une fois la cible de la comparaison choisie, les résultats s’affichent sous la forme d’une liste d’entrées de nomenclature avec un code couleur indiquant les éléments qui ont changé entre les événements de commit ou de publication spécifiés. Une synthèse des modifications est générée au format CSV standard et peut être téléchargée dans une archive ZIP. Pour plus d’informations, consultez Comparaison de nomenclatures.
-
Clone – utilisez cette commande pour créer un clone à partir de cette révision spécifique du projet. La fenêtre Clone Project s’affiche pour vous permettre de définir les paramètres Name, Description et Parent Folder du projet (dans l’espace de travail). Notez que le texte de la bannière de la fenêtre indique la révision du projet à partir de laquelle le clone est créé. Une fois les informations requises renseignées, cliquez sur le bouton
. Le projet est créé et une vignette d’événement Project Cloned est ajoutée à la chronologie.
Vous pouvez créer un clone à partir de n’importe quelle révision spécifique du projet actif, directement depuis la vignette d’événement Project Committed correspondant à cette révision.
- Download Sources – utilisez cette commande pour télécharger les fichiers sources de cette révision spécifique du projet dans une archive ZIP. Le nom du fichier ZIP et celui du fichier de projet PCB incluront la date et l’heure (UTC) auxquelles cette révision du projet a été enregistrée dans un commit et envoyée vers l’espace de travail.
Publication du projet
Related page: Publication du projet de conception
Chaque fois que vous publiez le projet à l’aide de Project Releaser d’Altium Designer, une vignette d’événement Project Released est ajoutée à la chronologie. Le nom et la photo de la personne ayant effectué la publication s’affichent, ainsi que 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 dans l’espace de travail, via la boîte de dialogue Confirm Release, elle s’affiche également dans la vignette. Chacun des jeux de données inclus dans la publication est également répertorié, avec une indication de son état de cycle de vie.
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 contenant les commandes suivantes :
- View – ouvre un portail de fabrication dédié (dans un onglet distinct du navigateur) pour examiner plus en détail les données publiées. Depuis ce portail, vous pouvez consulter et parcourir les données des fichiers publiés, examiner la nomenclature, ainsi que visualiser et commenter l’instantané de la conception elle-même, à l’origine de ces données publiées. Vous avez également accès à des commandes permettant de télécharger les données de fabrication à différents niveaux de détail (des jeux de données complets aux fichiers de sortie générés individuels). Une publication sélectionnée peut également être envoyée directement à votre fabricant sous la forme d’un Manufacturing Package. Pour plus d’informations, consultez Consultation d’un package de publication via le portail de fabrication.
Accès à l’onglet dédié Manufacturing Portal, qui permet d’examiner plus en détail la publication du projet.
- Schematic to – vous permet de comparer les données de schéma de cette publication à celles d’une autre publication ou d’un autre commit. Utilisez le sous-menu pour les comparer aux données sources de la publication précédente, ou choisissez parmi toutes les publications et tous les commits disponibles. Une fois la publication ou le commit de comparaison choisi, les résultats s’affichent dans la vue Compare, qui s’ouvre dans un nouvel onglet de votre navigateur Web par défaut. Pour plus d’informations, consultez Comparaison de schémas.
Comparaison des données de schéma entre deux publications du projet de conception.
- PCB to – vous permet de comparer les données PCB de cette publication à celles d’une autre publication ou d’un autre commit. Utilisez le sous-menu pour les comparer aux données sources de la publication précédente, ou choisissez parmi toutes les publications et tous les commits disponibles. Une fois la publication ou le commit de comparaison choisi, les résultats s’affichent dans la vue Compare, qui s’ouvre dans un nouvel onglet de votre navigateur Web par défaut. Pour plus d’informations, consultez Comparaison de PCB.
Comparaison des données PCB entre deux publications du projet de conception.
- Gerber to – vous permet de comparer les données Gerber générées pour cette publication à un autre jeu de données Gerber. Utilisez le sous-menu associé pour les comparer aux données de fabrication de la publication précédente, choisir parmi toutes les publications du projet (la chronologie sera filtrée pour n’afficher que les vignettes d’événement Project Released), ou les comparer à un jeu de fichiers généré localement et téléversé. Une fois la cible de la comparaison choisie, les résultats s’affichent dans la vue Gerber Compare , qui s’ouvre dans un onglet distinct du navigateur. Pour plus d’informations, consultez Comparaison de données Gerber.
Comparaison des données Gerber générées entre deux publications du projet de conception.
- BOM to – vous permet de comparer les données de nomenclature de cette publication à celles d’un autre commit ou d’une autre publication. Utilisez le sous-menu associé pour les comparer aux données de nomenclature du commit précédent, ou choisissez parmi tous les commits et toutes les publications du projet. Une fois la cible de la comparaison choisie, les résultats s’affichent sous la forme d’une liste d’entrées de nomenclature avec un code couleur indiquant les éléments qui ont changé entre les événements de commit ou de publication spécifiés. Une synthèse des modifications est générée au format CSV standard et peut être téléchargée dans une archive ZIP. Pour plus d’informations, consultez Comparaison de nomenclatures.
Téléchargement d’une comparaison des données de nomenclature générées entre deux événements du projet de conception.
-
Download Outputs – vous permet de choisir, dans une fenêtre qui s’ouvre ensuite, les jeux de données de sortie du package de publication à télécharger. Une fois vos choix effectués, cliquez sur le bouton
. Une archive ZIP unique est téléchargée, contenant un dossier pour chacun des jeux de données sélectionnés.
- Download Sources – vous permet de télécharger, sous forme d’archive ZIP, les données sources de la version de la conception utilisée pour créer ce package de publication.
Clonage de projet
Related page: Clonage d’un projet (interface du navigateur / Altium Designer)
Chaque fois que vous clonez le projet, que ce soit depuis l’interface Web de l’espace de travail ou depuis Altium Designer, une vignette d’événement Project Cloned est ajoutée à la chronologie. Le nom (et la photo) de la personne qui a effectué le clonage s’affichent, ainsi que la date et l’heure. Si une description a été ajoutée lors du clonage, dans la fenêtre Clone Project (interface Web) ou dans la boîte de dialogue Clone Project (Altium Designer), elle s’affiche également dans la vignette. Un lien vers le projet cloné est fourni : cliquez dessus pour accéder à la page de gestion détaillée de ce projet, qui s’ouvre dans un onglet distinct du navigateur.
Exemple de vignette d’événement Project Cloned.
Échanges MCAD
Related page: En savoir plus sur la coconception ECAD-MCAD
Lorsque vous travaillez entre les domaines de la conception électronique et de la conception mécanique, l’espace de travail fait le lien entre les deux et facilite la coconception directe ECAD-MCAD. Chaque fois que des modifications sont apportées à la conception du PCB du projet et envoyées à l’espace de travail depuis le panneau CoDesigner approprié, une vignette d’événement MCAD Changes Suggested est ajoutée à la chronologie. Le nom (et la photo) de la personne qui a effectué l’envoi s’affichent, ainsi que la date et l’heure. Si un message a été ajouté lors de l’envoi, depuis le panneau MCAD CoDesigner (Altium Designer) ou le panneau Altium CoDesigner (dans le logiciel MCAD pris en charge), il s’affiche également 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 envoie à l’espace de travail, l’événement d’envoi correspondant s’affiche automatiquement dans la chronologie de l’historique du projet. Notez qu’il peut être nécessaire d’actualiser la page Historique pour afficher la dernière modification.
Exemple montrant deux événements liés à la MCAD. À gauche du tronc de la chronologie, l’événement d’envoi côté ECAD ; à droite, l’événement d’envoi côté MCAD.
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 concernée.
La fonction de 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 Cloned et une vignette d’événement Project Created (lorsque le projet est créé par clonage).
Mise à jour avec les nouveaux événements
Chaque fois qu’un événement pris en charge se produit en lien avec le projet, il est automatiquement détecté et mis à disposition dans la vue History . Une notification apparaît en bas de la vue peu après l’événement : cliquez sur la commande
pour ajouter le nouvel événement à la chronologie.