Historique du projet

En un coup d'œil

Découvrez comment la vue Project History d’Altium Designer vous aide à retracer l’évolution d’un projet connecté à un Workspace grâce à une chronologie graphique des créations, commits, publications, copies et échanges MCAD. Cet article explique comment accéder à cette chronologie et la parcourir, comprendre les vignettes d’événements et utiliser les actions associées aux commits pour examiner les modifications, consulter les révisions précédentes, comparer les données de conception et gérer les étiquettes. Il précise également pourquoi le contrôle de version natif du Workspace est essentiel pour accéder à l’historique des commits. Poursuivez votre lecture pour mieux exploiter l’historique de votre projet.

- 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.
Approfondissez avec l'IA :

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.

Pour tirer pleinement parti de cette fonctionnalité, votre projet doit être entièrement géré par le système de contrôle de version (VCS) intégré à l’espace de travail (Git).

Si votre projet est soumis à un contrôle de version externe, vous pouvez le convertir en projet entièrement géré, hébergé dans l’espace de travail Altium 365, en le migrant vers le VCS natif de l’espace de travail. Pour plus de détails sur cette procédure, consultez Passer d’un VCS externe au VCS natif de l’espace de travail.

Pour savoir comment utiliser la vue History d’un projet depuis l’interface Web de l’espace de travail, consultez Historique du projet.

Pour accéder aux fonctionnalités d’historique des projets dans Altium Designer, l’extension logicielle Project History doit être installée. Cette extension est installée par défaut avec Altium Designer. Elle peut être installée ou supprimée manuellement.

Pour plus d’informations sur la gestion des extensions, consultez la page Extending Your Installation (Altium Designer Develop, Altium Designer Agile, Altium Designer).

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).

Si un projet de votre espace de travail existait déjà avant l’introduction de la fonctionnalité d’historique des projets, son historique sera initialement incomplet. Les données d’événements de ce projet seront automatiquement réindexées lors du premier accès à sa vue History . Une notification apparaîtra au bas de la vue une fois la réindexation terminée. Cliquez sur la commande pour mettre à jour la chronologie avec l’ensemble des données d’événements historiques.
Pour accéder à la vue History d’un fichier d’un projet de l’espace de travail, c’est-à-dire à la chronologie des événements majeurs du projet liés à ce fichier, faites un clic droit sur le fichier dans le panneau Projects , puis choisissez la commande History & Version Control » Show File History dans le menu contextuel.

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 .Identification des trois éléments clés de la vue History .

  1. 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.
  2. 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).
  3. 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.

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.

La recherche ne tient pas compte de la casse.

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.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.

Un encadré situé au-dessus de la sélection filtrée indique le nombre d’événements actuellement affichés et propose des commandes permettant de supprimer rapidement le filtre ou le texte de recherche.

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).
Pour supprimer le filtrage actuel et rétablir la chronologie complète, videz le champ de recherche, soit en sélectionnant le texte actuel et en appuyant sur la touche Backspace , soit en cliquant sur la commande à l’extrémité droite du champ. Vous pouvez également cliquer sur l’une des commandes Clear Filter dans l’encadré indiquant 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 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.

Vous pouvez également actualiser manuellement la vue en cliquant sur la commande en haut à droite.

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.

Depuis le menu Reports

L’historique du projet peut être exporté au format PDF en choisissant Reports » Project History dans les menus principaux. La boîte de dialogue Project History Report Configuration s’ouvre et vous permet de définir la Period pour laquelle le rapport doit être exporté : soit l’intégralité de l’historique du projet, soit une période délimitée par des publications spécifiques du projet (ou par la plus récente). Cliquez sur Export, puis saisissez un nom pour le PDF exporté dans la fenêtre Explorer qui s’ouvre et cliquez sur Save. Le rapport PDF s’ouvre dans un navigateur.
AI-LocalizedLocalisé par IA
Si vous trouvez un problème, sélectionnez le texte/l’image et appuyez surCtrl + Enterpour nous envoyer vos commentaires.
Nav
Contents
Disponibilité des fonctionnalités

Les fonctionnalités auxquelles vous avez accès dépendent de la solution Altium dont vous disposez – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, ou Altium Designer (avec un abonnement actif).

Si vous ne voyez pas une fonctionnalité documentée dans votre logiciel actuel, contactez le service commercial d’Altium pour en savoir plus.

Documentation héritée

La documentation d’Altium Designer n’est plus versionnée. Si vous devez accéder à la documentation des versions antérieures d’Altium Designer, consultez la section Documentation héritée de la page Other Installers.

Contents