Project History

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.

Pour tirer le meilleur parti de cette fonctionnalité, votre projet doit être entièrement géré en veillant à ce qu’il soit placé sous le VCS intégré du Workspace (Git).

Si votre projet est sous contrôle de version externe, vous pouvez le convertir en projet entièrement géré hébergé dans le Workspace Altium 365 en migrant le projet vers le VCS natif du Workspace. Pour des informations détaillées sur la procédure, consultez Passer d’un VCS externe au VCS natif du Workspace.

Pour plus d’informations sur l’utilisation de la Historyvue pour un projet via l’interface navigateur du Workspace, consultez Historique du projet.

Pour accéder aux fonctionnalités d’historique du projet 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, reportez-vous à la page Extending Your Installation (Altium Designer Develop, Altium Designer Agile, Altium Designer).

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

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énement pour ce projet sera effectuée automatiquement lors du premier accès à la History vue de ce projet. Une notification apparaîtra en 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énement.
Pour accéder à la Historyvue d’un fichier d’un projet Workspace, c’est-à-dire la chronologie des événements majeurs du projet relatifs au fichier, cliquez avec le bouton droit sur le fichier dans le Projects panneau, puis choisissez la History & Version Control » Show File History commande dans le menu contextuel.

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

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

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.

La fonction de recherche n’est pas sensible à 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 (insensible à la casse), avec les entrées correspondantes 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 (insensible à la casse), avec les entrées correspondantes mises en surbrillance dans chaque vignette d’événement pertinente.

Une zone est affichée au-dessus de la sélection filtrée ; elle résume le nombre d’événements actuellement affichés et propose des contrôles pour supprimer rapidement le filtre/la chaîne de recherche.

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

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

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.

À partir du 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, dans laquelle vous pouvez définir la Period pour laquelle le rapport doit être exporté : soit l’historique complet du projet, soit depuis/vers une release spécifique du projet (ou la plus récente). Cliquez sur Export puis saisissez un nom pour le PDF exporté dans la fenêtre Explorer qui s’ouvre, puis cliquez sur Save. Le rapport PDF s’ouvre dans un navigateur.
AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Legacy Documentation

Altium Designer documentation is no longer versioned. If you need to access documentation for older versions of Altium Designer, visit the Legacy Documentation section of the Other Installers page.

Contenu