Historique du projet

Ne pas pouvoir accéder facilement à une vue historique du parcours de développement d’un projet est très 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 VCS, qui peuvent nécessiter un niveau d’expertise assez élevé pour être utilisés — ce qui prend beaucoup de temps lorsqu’il s’agit d’effectuer des tâches élémentaires de gestion de projet. Même si vous maîtrisez les outils VCS externes, ils ne traitent que certains aspects du projet — des actions liées au VCS comme l’ouverture, le clonage et le retour à une version antérieure. Mais qu’en est-il du périmètre plus large de la gestion de projet, y compris les versions et les échanges MCAD ? Sans oublier que, dans la plupart des cas, tout cela impose généralement de rester attaché à un poste de travail.

Offrant une solution élégante au besoin de consulter ces informations et d’interagir avec elles depuis un emplacement unique, le Altium 365 Workspace facilite la notion de Project History. Accessible via l’interface navigateur du Workspace (qui constitue une partie de l’Altium 365 Platform Interface) ou depuis Altium Designer, une History vue dédiée fournit une chronologie progressive des événements majeurs liés au projet — sa création, les commits, les versions, les clonages et les échanges MCAD — avec diverses actions prises en charge lorsque cela s’applique (comme l’affichage d’un instantané des sources de conception).

Accès à l’historique du projet

L’accès à la History vueHistory d’un projet s’effectue depuis la page de gestion détaillée de ce projet. Cliquez sur l’entrée History dans le volet de gauche.

La page de gestion détaillée elle-même s’ouvre en sélectionnant le projet souhaité (sur la Projects pageProjects de l’interface), en cliquant sur le contrôle au-dessus de la liste des projets, puis en choisissant l’entrée Open dans le menu associé. Vous pouvez également double-cliquer directement sur l’entrée du projet souhaité dans la liste. La page s’ouvrira dans un nouvel onglet du navigateur. Pour plus d’informations, voir Management of a Specific Project.

Accédez à l’historique d’un projet depuis la page de gestion détaillée de ce projet.

Pour un projet de votre Workspace qui existait déjà avant l’arrivée de la fonctionnalité Project History, son historique ne sera initialement pas complet. La réindexation des données d’événements pour ce projet sera effectuée automatiquement lors du premier accès à la History vueHistory de ce projet. Une notification apparaîtra au bas de la vue une fois la réindexation terminée — cliquez sur le contrôle pour mettre à jour la chronologie avec l’ensemble des données historiques d’événements.

Chronologie de l’historique — Vue d’ensemble

La History vueHistory 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-après.

Identification des trois composants clés de la History vueHistory .

1. 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.
2. 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 d’une couleur différente et est 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).
3. Search. Cliquez sur le contrôle en haut à droite de la vue pour accéder à un champ de recherche permettant 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, voir Filtered Searching.

Événements pris en charge

La chronologie montre une 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 suivantes présentent l’éventail des événements actuellement pris en charge et pouvant être affichés dans la chronologie historique d’un projet.

Création du projet

Related pages: Création d’un nouveau projet géré (interface navigateur / Altium Designer), Mise en ligne d’un projet existant, Clonage d’un projet (interface navigateur / Altium Designer)

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 :

• Lorsque le 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 un clone d’un projet existant. La personne qui a créé le projet cloné est indiquée 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 du clonage. 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, qui s’ouvre dans un onglet séparé du navigateur.

La vignette d’événement Project Created est physiquement reliée au tronc principal de la chronologie par une ligne de connexion bleue continue et un nœud : .

Commit du projet

Chaque fois que vous effectuez un Commit & Push du projet vers le Workspace (lorsque le projet est géré dans le Versioned Storagedépôt GitVersioned Storage interne du Workspace), une vignette d’événement Project Committed est ajoutée à la chronologie. La personne ayant effectué le commit et le push 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 du push — via la boîte de dialogue Commit to Version Control — celui-ci 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, en affichant des informations plus détaillées sur ce qui a changé entre le commit actuel et le commit précédent. Les éléments pris en charge incluent les fichiers, les composants, les nets, les variantes et la structure du PCB. La section de comparaison des différences 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é.

En cliquant sur le contrôle dans la vignette, cette section de comparaison des différences se développera pour présenter les éléments affectés par nom.

Utilisez les contrôles Show More et Show Less disponibles pour examiner la liste complète de chaque type d’élément. Cliquez sur le contrôle dans la vignette pour revenir à l’affichage récapitulatif.

Cliquez sur le contrôle dans le coin supérieur droit de la vignette pour accéder à un menu contenant les commandes suivantes :

• View – utilisez cette commande pour ouvrir les données source de conception du commit sélectionné dans le Web Viewer sous forme d’instantané de la conception à ce moment-là.
• Create Tag – ajoute un nom de tag VCS au commit actuellement sélectionné. Les tags attachés à un commit apparaissent dans la vignette de sa vue History, dans l’en-tête de sa vue instantanée dans le Web Viewer, ainsi que dans tous les commentaires attachés à cette vue instantanée. Une fois qu’un tag a été ajouté à un commit, la commande de menu de la vignette devient Tag et propose des sous-options pour modifier (Edit) ou supprimer (Remove) le tag du commit.

Sélectionnez l’option de menu Create Tag pour ajouter un nom de tag à un événement de l’historique d’un commit.

La vue instantanée d’un événement de commit History tagué est étiquetée avec le nom du tag.

Lorsque les commentaires sont affichés dans la conception WIP active, ceux créés dans l’instantané de conception d’un commit tagué incluront le nom du tag associé. Sélectionnez le lien du nom du tag pour ouvrir l’instantané du commit correspondant. Voir Web Viewer Comments pour plus d’informations sur l’utilisation des commentaires.

Les commentaires ajoutés à un instantané d’un événement de commit tagué incluront le nom du tag associé.

L’événement de commit associé à une Release de projet, tel que créé par le Project Releaser d’Altium Designer, est automatiquement tagué avec le Release Revision ID. Si nécessaire, le tag de commit de révision résultant peut ensuite être modifié ou supprimé. Voir Releasing to a Workspace pour les informations associées.

Le commit associé à une Release est automatiquement tagué avec l’ID de Release par Altium Designer.

• Schematic to – vous permet de comparer les données de schéma de ce commit avec celles d’un autre événement de commit ou de release. Utilisez le sous-menu pour comparer avec les données source du commit précédent, ou sélectionnez parmi tous les commits ou releases possibles. Une fois le release/commit de comparaison choisi, les résultats de la comparaison sont présentés dans la vue Compare, qui s’ouvre dans un nouvel onglet de votre navigateur web par défaut. Pour plus d’informations, voir Schematic Comparison.
• PCB to – vous permet de comparer les données PCB de ce commit avec celles d’un autre événement de commit ou de release. Utilisez le sous-menu pour comparer avec les données source du commit précédent, ou sélectionnez parmi tous les commits ou releases possibles. Une fois le release/commit de comparaison choisi, les résultats de la comparaison sont présentés dans la vue Compare, qui s’ouvre dans un nouvel onglet de votre navigateur web par défaut. Pour plus d’informations, voir PCB Comparison.
• BOM to – vous permet de comparer les données BOM de ce commit avec celles d’un autre événement de commit ou de release. Utilisez le sous-menu associé pour comparer avec les données BOM du commit précédent, ou sélectionnez parmi tous les commits/releases effectués pour le projet. Une fois la cible de la comparaison choisie, les résultats de la comparaison sont présentés sous la forme d’une liste d’entrées BOM codées par couleur représentant les éléments qui ont changé entre les événements de Commit/Release spécifiés. Un résumé consolidé des modifications est généré au format CSV standard et mis à disposition pour téléchargement dans une archive ZIP. Pour plus d’informations, voir BOM Comparison.
• Clone – utilisez cette commande pour créer un clone à partir de cette révision spécifique du projet. La fenêtre Clone Project apparaîtra pour vous permettre de définir le Name, le Description du projet, ainsi que le Parent Folder (dans le Workspace). Notez que le texte de bannière de la fenêtre indique à partir de quelle révision du projet le clone est créé. Une fois les informations requises définies, cliquez sur le bouton . Le projet sera créé et une vignette d’événement Project Cloned sera 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 correspondante pour cette révision.

• Download Sources – utilisez cette commande pour télécharger les sources du projet pour 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 (en UTC) auxquelles cette révision du projet a été commitée et poussée vers le Workspace.

Une vignette d’événement Project Committed est physiquement reliée au tronc principal de la chronologie par une ligne de connexion et un nœud bleus pleins : . La dernière révision du projet (c’est-à-dire le dernier commit) se distingue par un remplissage blanc de son nœud : .

Release de projet

Related page: Release du projet de conception

Chaque fois que vous effectuez une release du projet – à l’aide du Project Releaser d’Altium Designer – une vignette d’événement Project Released sera ajoutée à la chronologie. La personne ayant effectué la release est indiquée par son nom (et sa photo), ainsi que la date et l’heure. Si une note de release a été ajoutée au moment de la publication des 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 release sera également listé, avec indication de l’état du cycle de vie.

Exemple de vignette d’événement Project Released.

Cliquez sur le contrôle 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 de navigateur séparé) permettant d’inspecter plus en détail les données publiées. Depuis ce portail, vous pouvez afficher et parcourir les données des fichiers publiés, inspecter la BOM, et afficher et commenter l’instantané de la conception elle-même ; la source de ces données publiées. Vous aurez également accès à des contrôles permettant de télécharger les données de fabrication à différents niveaux de granularité (depuis le ou les jeux de données complets jusqu’aux fichiers de sortie générés individuels). Une release choisie peut également être envoyée – en tant que Manufacturing Package – directement à votre fabricant. Pour plus d’informations, voir Browsing a Release Package through the Manufacturing Portal.

Accès à l’onglet dédié Manufacturing Portal, permettant d’inspecter plus en détail la release du projet.

• Schematic to – vous permet de comparer les données de schéma de cette release avec celles d’un autre événement de release ou de commit. Utilisez le sous-menu pour comparer avec les données source de la release précédente, ou sélectionnez parmi toutes les releases et tous les commits possibles. Une fois le release/commit de comparaison choisi, les résultats de la comparaison sont présentés dans la vue Compare, qui s’ouvre dans un nouvel onglet de votre navigateur web par défaut. Pour plus d’informations, voir Schematic Comparison.

Comparaison des données de schéma entre deux releases du projet de conception.

• PCB to – vous permet de comparer les données PCB de cette release avec celles d’un autre événement de release ou de commit. Utilisez le sous-menu pour comparer avec les données source de la release précédente, ou sélectionnez parmi toutes les releases et tous les commits possibles. Une fois le release/commit de comparaison choisi, les résultats de la comparaison sont présentés dans la vue Compare, qui s’ouvre dans un nouvel onglet de votre navigateur web par défaut. Pour plus d’informations, voir PCB Comparison.

Comparaison des données PCB entre deux releases du projet de conception.

• Gerber to – vous permet de comparer les données Gerber générées pour cette release avec un autre jeu de données Gerber. Utilisez le sous-menu associé pour comparer avec les données de fabrication de la release précédente, sélectionner parmi toutes les releases effectuées pour le projet (la chronologie sera filtrée pour n’afficher que les vignettes d’événement Project Released), ou comparer avec un jeu de fichiers choisi généré localement (et téléversé). Une fois la cible de la comparaison choisie, les résultats sont présentés dans la vue Gerber Compare , qui s’ouvre dans un onglet de navigateur séparé. Pour plus d’informations, voir Gerber Comparison.

Comparaison des données Gerber générées entre deux releases du projet de conception.

• BOM to – vous permet de comparer les données de nomenclature (BOM) de cette version avec celles d’un autre commit ou événement de publication. Utilisez le sous-menu associé pour comparer avec les données BOM du commit précédent, ou sélectionnez parmi tous les commits/publications effectués pour le projet. Une fois la cible de la comparaison choisie, les résultats sont présentés sous la forme d’une liste d’entrées BOM codées par couleur, représentant les éléments qui ont changé entre les événements de commit/publication spécifiés. Un résumé consolidé des modifications est généré au format CSV standard et mis à disposition au téléchargement dans une archive ZIP. Pour plus d’informations, voir Comparaison de BOM.

Télécharger une comparaison des données BOM générées entre deux événements du projet de conception.

• Download Outputs – vous permet de choisir, via une fenêtre suivante, quels jeux de données de sortie du package de publication télécharger. Une fois les choix effectués, cliquez sur le bouton . Une seule archive ZIP sera téléchargée, contenant des dossiers pour chacun des jeux de données sélectionnés.
• Download Sources – vous permet de télécharger les données source de la version de la conception utilisée pour créer ce package de publication, sous forme d’archive ZIP.

Clonage de projet

Related page:Clonage d’un projet (interface navigateur / Altium Designer)

Chaque fois que vous clonez le projet – soit via l’interface navigateur du Workspace, soit depuis Altium Designer – une vignette d’événement Project Cloned sera ajoutée à la chronologie. La personne ayant effectué le clonage est indiquée par son nom (et sa photo), ainsi que la date et l’heure. Si une description a été ajoutée au moment du clonage – via la fenêtre Clone Project (dans le navigateur) ou la boîte de dialogue Clone Project (Altium Designer) – celle-ci sera également affichée dans la vignette. Un lien vers le projet cloné est fourni ; en cliquant dessus, vous accéderez à la page de gestion détaillée de ce projet, qui s’ouvre dans un onglet séparé du navigateur.

Exemple de vignette d’événement Project Cloned.

Les principales Clone commandes disponibles depuis la page Projects de l’interface navigateur du Workspace, ou depuis Altium Designer (clic droit sur l’entrée du projet dans le panneau Projects, ou clic sur le bouton en haut à droite du panneau Explorer lors de la navigation dans le projet) agissent sur la révision la plus récente (ou Head) du projet. Depuis la vue History , vous avez la possibilité de cloner une révision spécifique d’un projet. Pour ce faire, localisez la vignette d’événement Project Committed correspondant à la révision souhaitée du projet, puis cliquez sur le contrôle dans l’angle supérieur droit de la vignette. Dans le menu qui s’affiche ensuite, choisissez la commande Clone .

La vignette d’événement Project Cloned est physiquement reliée au tronc principal de la chronologie par une ligne de connexion verte en pointillés et un nœud non rempli : .

Échanges MCAD

Related page: En savoir plus sur la co-conception ECAD-MCAD

Lors du travail entre les domaines de 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 approprié, une vignette d’événement MCAD Changes Suggested sera ajoutée à la chronologie. La personne ayant effectué l’envoi est indiquée par son nom (et sa photo), ainsi que 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) – 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 envoie ces modifications au Workspace, l’événement d’envoi correspondant s’affichera automatiquement sur 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 au MCAD. À gauche du tronc de la chronologie, l’événement d’envoi côté ECAD ; à droite, l’événement d’envoi côté MCAD.

La vignette d’événement MCAD Changes Suggested n’est pas physiquement reliée au tronc principal de la chronologie. À la place, un symbole de flèche directionnelle est utilisé, pointant vers le tronc : .

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 d’intérêt 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é à mesure que vous saisissez votre chaîne de recherche – ne laissant affichés sur la page que les événements pertinents pour cette recherche. 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 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 lorsque l’événement concerné s’est produit).
• Texte des données de différenciation – dans une vignette d’événement Project Committed.
• Nom du jeu de données – dans une vignette d’événement Project Released.
• Nom du projet – dans une vignette d’événement Project Cloned et une vignette d’événement Project Created (lorsqu’elle est créée par clonage).

Pour effacer le filtrage actuel et revenir à la chronologie complète, videz le champ de recherche – soit en sélectionnant le texte actuel puis en appuyant sur la touche Backspace , soit en cliquant sur le contrôle à l’extrémité droite du champ. Vous pouvez également cliquer sur le contrôle Clear Filter dans la zone résumant le nombre d’événements affichés (en haut de la vue).

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 sera détecté et rendu automatiquement disponible dans la vue History . Une notification apparaîtra en bas de la vue peu après que l’événement se soit produit ; cliquez sur le contrôle pour mettre à jour la chronologie avec le nouvel événement.

Une actualisation manuelle est également disponible, en cliquant sur le contrôle en haut à droite de la vue.