Projektverlauf
Auf einen Blick
- Erfahren Sie, wo Sie die Verlaufsansicht finden und wie deren Zeitleiste Projektereignisse anordnet.
- Lernen Sie die Voraussetzungen der Versionsverwaltung für die Anzeige des Commit-Verlaufs kennen.
- Entdecken Sie, wie Sie Änderungen in Commits prüfen, historische Momentaufnahmen des Designs öffnen und Commits mit Tags versehen.
Dass sich der bisherige Entwicklungsverlauf eines Projekts nicht ohne Weiteres einsehen lässt, ist für Entwickler und Produktmanager häufig ein Ärgernis. Allzu oft müssen sich Entwickler in externe VCS-Verwaltungstools einarbeiten, deren Bedienung einiges an Fachwissen erfordern kann – ein erheblicher Zeitaufwand, wenn lediglich grundlegende Aufgaben der Projektverwaltung erledigt werden sollen. Selbst wenn Sie mit externen VCS-Tools vertraut sind, decken diese immer nur bestimmte Aspekte des Projekts ab – VCS-bezogene Aktionen wie Öffnen, Klonen und Zurücksetzen. Doch wie sieht es mit dem umfassenderen Bereich der Projektverwaltung aus, einschließlich Freigaben und MCAD-Datenaustausch? Nicht zu vergessen, dass Sie dafür in der Regel an den Desktop gebunden sind.
Der Altium 365 Workspace bietet eine elegante Lösung, um solche Informationen an einem zentralen Ort einzusehen und mit ihnen zu arbeiten, und ermöglicht damit das Konzept von Project History. Eine spezielle History Ansicht, die über die Browseroberfläche des Workspace (als Bestandteil der übergeordneten Altium 365-Plattformoberfläche) oder direkt in Altium Designer zugänglich ist, stellt wichtige Ereignisse im Projektverlauf auf einer fortlaufenden Zeitleiste dar – Erstellung, Commits, Freigaben, Klone und MCAD-Datenaustausch. Je nach Ereignis stehen verschiedene Aktionen zur Verfügung, beispielsweise das Anzeigen einer Momentaufnahme der Design-Quelldaten.
Auf den Projektverlauf zugreifen
Sie erreichen die History Ansicht eines Projekts über dessen detaillierte Verwaltungsseite. Klicken Sie im linken Bereich auf den Eintrag History .
Greifen Sie über die detaillierte Verwaltungsseite eines Projekts auf dessen Verlauf zu.
Verlaufszeitleiste – Überblick
Die History Ansicht zeigt eine Zeitleiste der grundlegenden Ereignisse, die im Laufe der Projektentwicklung aufgetreten sind. Sie lässt sich im Wesentlichen in drei Hauptbereiche unterteilen, die in der folgenden Abbildung dargestellt und anschließend näher erläutert werden.
Die drei Hauptbestandteile der History Ansicht.
- Main trunk of the timeline. Die zeitliche Abfolge der Ereignisse verläuft von unten nach oben. Das erste Ereignis – die Erstellung des Projekts – erscheint ganz unten auf der Zeitleiste. Nachfolgende Ereignisse werden darüber angezeigt, wobei das neueste Ereignis ganz oben auf der Zeitleiste steht.
- Events. Jedes Mal, wenn im Zusammenhang mit dem Projekt ein unterstütztes Ereignis (siehe unten) eintritt, wird es der Zeitleiste als eigene Kachel hinzugefügt. Jeder Ereignistyp hat eine andersfarbige Kachel, die entweder direkt mit der Hauptachse der Zeitleiste verbunden ist oder neben der ein zusätzliches Symbol angezeigt wird (wie bei MCAD-Datenaustauschereignissen).
-
Search. Klicken Sie oben rechts in der Ansicht auf das Bedienelement
, um ein Suchfeld für eine einfache Suche im Projektverlauf zu öffnen. Während Sie Ihren Suchtext eingeben, wird die Zeitleiste gefiltert, sodass nur die für die Suche relevanten Ereignisse angezeigt werden. Weitere Informationen finden Sie unter Gefilterte Suche.
Unterstützte Ereignisse
Die Zeitleiste zeigt die Abfolge der Ereignisse, die während der Lebensdauer eines Projekts auftreten. Jedes dieser Ereignisse wird auf der Zeitleiste als eigene „Ereigniskachel“ dargestellt. Die folgenden Abschnitte beschreiben die Ereignisse, die derzeit unterstützt werden und im historischen Verlauf eines Projekts angezeigt werden können.
Projekterstellung
Related pages: Erstellen eines neuen verwalteten Projekts (Browseroberfläche / Altium Designer), Online-Bereitstellen eines vorhandenen Projekts, Klonen eines Projekts (Browseroberfläche / Altium Designer)
Wenn ein Projekt erstellt wird, wird die Ereigniskachel Project Created zur Zeitleiste hinzugefügt. Dieses Ereignis markiert den Beginn des Projektverlaufs. Daher ist es immer als unterster Eintrag auf der Zeitleiste zu finden. Die Kachel für dieses Ereignis kann in zwei unterschiedlichen Varianten erscheinen:
- Wenn das Projekt im Workspace neu erstellt wird. Der Ersteller des Projekts wird mit Namen (und Bild) sowie Datum und Uhrzeit der Projekterstellung angezeigt. Auch die Projektbeschreibung wird in der Kachel angezeigt, sofern bei der Erstellung eine eingegeben wurde.
- Wenn das Projekt ein Klon eines vorhandenen Projekts ist. Die Person, die das geklonte Projekt erstellt hat, wird mit Namen (und Bild) sowie Datum und Uhrzeit der Projekterstellung angezeigt. Falls beim Klonen eine Projektbeschreibung eingegeben wurde, wird diese ebenfalls in der Kachel angezeigt. Ein Link führt zum ursprünglichen Projekt. Wenn Sie darauf klicken, wird die detaillierte Verwaltungsseite dieses Projekts in einem separaten Browser-Tab geöffnet.
Projekt-Commit
Jedes Mal, wenn Sie für das Projekt einen Commit & Push in den Workspace durchführen (wobei das Projekt im internen Git-Repository Versioned Storage des Workspace verwaltet wird), wird der Zeitleiste eine Ereigniskachel Project Committed hinzugefügt. Die Person, die den Commit und Push durchgeführt hat, wird mit Namen (und Bild) sowie Datum und Uhrzeit angezeigt. Wenn beim Commit und Push über den Dialog In die Versionskontrolle übernehmen ein Kommentar hinzugefügt wurde, wird dieser ebenfalls in der Kachel angezeigt.
Beispiel einer ersten Ereigniskachel Project Committed.
Die Kachel unterstützt und zeigt auch Informationen zu Designunterschieden an und stellt damit detaillierter dar, was sich zwischen dem aktuellen und dem vorherigen Commit geändert hat. Zu den unterstützten Elementen gehören Dateien, Bauteile, Netze, Varianten und die Leiterplattenstruktur. Der Vergleichsbereich der Kachel fasst die verschiedenen vom Commit-Ereignis betroffenen Elemente zusammen, gruppiert nach den folgenden Zuständen:
– Element hinzugefügt.
– Element entfernt.
– Element geändert.
Wenn Sie auf das Steuerelement
in der Kachel klicken, wird dieser Vergleichsbereich erweitert und die betroffenen Elemente werden mit Namen angezeigt.
Klicken Sie auf das Steuerelement
oben rechts in der Kachel, um ein Menü mit den folgenden Befehlen zu öffnen:
- View – Mit diesem Befehl öffnen Sie die Quelldaten des ausgewählten Commits im Web Viewer als Momentaufnahme des Designs zum damaligen Zeitpunkt.
- Create Tag – Fügen Sie dem aktuell ausgewählten Commit einen VCS-Tag-Namen hinzu. Einem Commit zugewiesene Tags werden in dessen Kachel in der Verlaufsansicht, in der Kopfzeile seiner Momentaufnahme im Web Viewer sowie in allen Kommentaren zu dieser Momentaufnahme angezeigt. Sobald einem Commit ein Tag hinzugefügt wurde, ändert sich der Menübefehl der Kachel in Tag und bietet Unteroptionen zum Ändern (Edit) oder Löschen (Remove) des Commit-Tags.
Wählen Sie die Menüoption „Tag erstellen“, um einem Commit-Ereignis im Verlauf einen Tag-Namen hinzuzufügen.
Die Momentaufnahme eines mit einem Tag versehenen Commit-Ereignisses im Verlauf ist mit dem Tag-Namen gekennzeichnet.
Wenn Kommentare im aktuellen WIP-Design angezeigt werden, enthalten diejenigen, die in der Design-Momentaufnahme eines mit einem Tag versehenen Commits erstellt wurden, den zugehörigen Tag-Namen. Klicken Sie auf den Link des Tag-Namens, um die zugehörige Commit-Momentaufnahme zu öffnen. Weitere Informationen zum Arbeiten mit Kommentaren finden Sie unter Kommentare im Web Viewer.
Kommentare, die einer Momentaufnahme eines mit einem Tag versehenen Commit-Ereignisses hinzugefügt werden, enthalten den zugehörigen Tag-Namen.
Das Commit-Ereignis, das zu einer mit dem Project Releaser von Altium Designer erstellten Projektfreigabe gehört, wird automatisch mit der Freigabe-Revisions-ID als Tag versehen. Bei Bedarf kann das resultierende Revisions-Commit-Tag anschließend bearbeitet oder gelöscht werden. Weitere Informationen hierzu finden Sie unter Freigeben in einem Workspace.
Der zu einer Freigabe gehörende Commit wird von Altium Designer automatisch mit der Freigabe-ID als Tag versehen.
- Schematic to – Ermöglicht es Ihnen, die Schaltplandaten dieses Commits mit denen eines anderen Commit- oder Freigabeereignisses zu vergleichen. Verwenden Sie das Untermenü, um die Quelldaten mit denen des vorherigen Commits zu vergleichen, oder wählen Sie aus allen verfügbaren Commits oder Freigaben. Sobald die Freigabe bzw. der Commit für den Vergleich ausgewählt wurde, werden die Vergleichsergebnisse in der Vergleichsansicht angezeigt, die sich als neuer Tab in Ihrem Standard-Webbrowser öffnet. Weitere Informationen finden Sie unter Schaltplanvergleich.
- PCB to – Ermöglicht es Ihnen, die Leiterplattendaten dieses Commits mit denen eines anderen Commit- oder Freigabeereignisses zu vergleichen. Verwenden Sie das Untermenü, um die Quelldaten mit denen des vorherigen Commits zu vergleichen, oder wählen Sie aus allen verfügbaren Commits oder Freigaben. Sobald die Freigabe bzw. der Commit für den Vergleich ausgewählt wurde, werden die Vergleichsergebnisse in der Vergleichsansicht angezeigt, die sich als neuer Tab in Ihrem Standard-Webbrowser öffnet. Weitere Informationen finden Sie unter Leiterplattenvergleich.
- BOM to – ermöglicht es Ihnen, die BOM-Daten dieses Commits mit denen eines anderen Commits oder einer anderen Freigabe zu vergleichen. Verwenden Sie das zugehörige Untermenü, um einen Vergleich mit den BOM-Daten des vorherigen Commits durchzuführen, oder wählen Sie aus allen Commits/Freigaben aus, die für das Projekt erstellt wurden. Sobald das Vergleichsziel ausgewählt wurde, werden die Vergleichsergebnisse als Liste farbcodierter BOM-Einträge dargestellt, die die zwischen den angegebenen Commit-/Freigabeereignissen geänderten Elemente kennzeichnen. Eine zusammengefasste Übersicht der Änderungen wird im Standard-CSV-Format erstellt und in einem ZIP-Archiv zum Download bereitgestellt. Weitere Informationen finden Sie unter BOM-Vergleich.
-
Clone – verwenden Sie diesen Befehl, um einen Klon dieser bestimmten Revision des Projekts zu erstellen. Das Fenster Clone Project wird geöffnet, in dem Sie Name, Description und Parent Folder (innerhalb des Workspace) für das Projekt festlegen können. Beachten Sie, dass der Bannertext des Fensters angibt, aus welcher Revision des Projekts der Klon erstellt wird. Nachdem Sie die erforderlichen Angaben gemacht haben, klicken Sie auf die Schaltfläche
. Das Projekt wird erstellt und der Zeitleiste wird eine Ereigniskachel Project Cloned hinzugefügt.
Sie können einen Klon jeder beliebigen Revision des aktiven Projekts erstellen – direkt über die entsprechende Ereigniskachel Project Committed dieser Revision.
- Download Sources – verwenden Sie diesen Befehl, um die Projektquelldaten dieser bestimmten Revision des Projekts als ZIP-Archiv herunterzuladen. Der Name der ZIP-Datei und der PCB-Projektdatei enthält das Datum und die Uhrzeit (in UTC), zu denen diese Revision des Projekts committet und in den Workspace übertragen wurde.
Projektfreigabe
Related page: Freigabe eines Designprojekts
Jedes Mal, wenn Sie ein Projekt mit dem Project Releaser von Altium Designer freigeben, wird der Zeitleiste eine Ereigniskachel Project Released hinzugefügt. Die Person, die die Freigabe durchgeführt hat, wird mit Namen (und Bild) sowie Datum und Uhrzeit angezeigt. Wenn bei der Freigabe der generierten Daten für den Workspace im Dialogfeld „Confirm Release“ eine Freigabenotiz hinzugefügt wurde, wird diese ebenfalls in der Kachel angezeigt. Außerdem werden alle in der Freigabe enthaltenen Datensätze mit Angabe ihres Lebenszyklusstatus aufgeführt.
Beispiel einer Ereigniskachel Project Released.
Klicken Sie auf das Steuerelement
in der oberen rechten Ecke der Kachel, um ein Menü mit den folgenden Befehlen aufzurufen:
- View – öffnet ein dediziertes Fertigungsportal (in einem separaten Browser-Tab), in dem Sie die freigegebenen Daten genauer untersuchen können. In diesem Portal können Sie die freigegebenen Dateidaten anzeigen und durchsuchen, die BOM prüfen sowie den Snapshot des Designs selbst – die Quelle der freigegebenen Daten – anzeigen und kommentieren. Außerdem stehen Ihnen Steuerelemente zum Herunterladen von Fertigungsdaten in verschiedenen Detaillierungsstufen zur Verfügung (von vollständigen Datensätzen bis hin zu einzelnen generierten Ausgabedateien). Eine ausgewählte Freigabe kann auch als Manufacturing Package direkt an Ihren Hersteller gesendet werden. Weitere Informationen finden Sie unter Durchsuchen eines Freigabepakets über das Fertigungsportal.
Zugriff auf den dedizierten Tab Manufacturing Portal, in dem Sie die Freigabe des Projekts genauer untersuchen können.
- Schematic to – ermöglicht es Ihnen, die Schaltplandaten dieser Freigabe mit denen einer anderen Freigabe oder eines anderen Commits zu vergleichen. Verwenden Sie das Untermenü, um einen Vergleich mit den Quelldaten der vorherigen Freigabe durchzuführen, oder wählen Sie aus allen verfügbaren Freigaben und Commits aus. Sobald die Freigabe bzw. der Commit für den Vergleich ausgewählt wurde, werden die Vergleichsergebnisse in der Vergleichsansicht dargestellt, die sich als neuer Tab in Ihrem Standard-Webbrowser öffnet. Weitere Informationen finden Sie unter Schaltplanvergleich.
Vergleich der Schaltplandaten zweier Freigaben des Designprojekts.
- PCB to – ermöglicht es Ihnen, die PCB-Daten dieser Freigabe mit denen einer anderen Freigabe oder eines anderen Commits zu vergleichen. Verwenden Sie das Untermenü, um einen Vergleich mit den Quelldaten der vorherigen Freigabe durchzuführen, oder wählen Sie aus allen verfügbaren Freigaben und Commits aus. Sobald die Freigabe bzw. der Commit für den Vergleich ausgewählt wurde, werden die Vergleichsergebnisse in der Vergleichsansicht dargestellt, die sich als neuer Tab in Ihrem Standard-Webbrowser öffnet. Weitere Informationen finden Sie unter PCB-Vergleich.
Vergleich der PCB-Daten zweier Freigaben des Designprojekts.
- Gerber to – ermöglicht es Ihnen, die für diese Freigabe generierten Gerber-Daten mit einem anderen Satz von Gerber-Daten zu vergleichen. Verwenden Sie das zugehörige Untermenü, um einen Vergleich mit den Fertigungsdaten der vorherigen Freigabe durchzuführen, aus allen für das Projekt erstellten Freigaben auszuwählen (die Zeitleiste wird so gefiltert, dass nur Ereigniskacheln Project Released angezeigt werden) oder einen Vergleich mit einem ausgewählten, lokal generierten (und hochgeladenen) Dateisatz durchzuführen. Sobald das Vergleichsziel ausgewählt wurde, werden die Ergebnisse in der Ansicht Gerber Compare dargestellt, die sich in einem separaten Browser-Tab öffnet. Weitere Informationen finden Sie unter Gerber-Vergleich.
Vergleich der generierten Gerber-Daten zweier Freigaben des Designprojekts.
- BOM to – ermöglicht es Ihnen, die BOM-Daten dieser Freigabe mit denen eines anderen Commits oder einer anderen Freigabe zu vergleichen. Verwenden Sie das zugehörige Untermenü, um einen Vergleich mit den BOM-Daten des vorherigen Commits durchzuführen, oder wählen Sie aus allen Commits/Freigaben aus, die für das Projekt erstellt wurden. Sobald das Vergleichsziel ausgewählt wurde, werden die Vergleichsergebnisse als Liste farbcodierter BOM-Einträge dargestellt, die die zwischen den angegebenen Commit-/Freigabeereignissen geänderten Elemente kennzeichnen. Eine zusammengefasste Übersicht der Änderungen wird im Standard-CSV-Format erstellt und in einem ZIP-Archiv zum Download bereitgestellt. Weitere Informationen finden Sie unter BOM-Vergleich.
Herunterladen eines Vergleichs der generierten BOM-Daten zwischen zwei Ereignissen des Designprojekts.
-
Download Outputs – ermöglicht es Ihnen, in einem nachfolgenden Fenster auszuwählen, welche Ausgabedatensätze des Freigabepakets heruntergeladen werden sollen. Nachdem Sie Ihre Auswahl getroffen haben, klicken Sie auf die Schaltfläche
. Es wird ein einzelnes ZIP-Archiv heruntergeladen, das für jeden ausgewählten Datensatz einen Ordner enthält.
- Download Sources – ermöglicht es Ihnen, die Quelldaten der Designversion, die zur Erstellung dieses Freigabepakets verwendet wurde, als ZIP-Archiv herunterzuladen.
Klonen von Projekten
Related page: Klonen eines Projekts (Browseroberfläche / Altium Designer)
Jedes Mal, wenn Sie das Projekt klonen – entweder über die Browseroberfläche des Workspace oder direkt in Altium Designer –, wird der Zeitleiste eine Project Cloned-Ereigniskachel hinzugefügt. Die Person, die das Projekt geklont hat, wird mit Namen (und Bild) sowie Datum und Uhrzeit angezeigt. Wenn beim Klonen eine Beschreibung hinzugefügt wurde – über das Fenster Clone Project (browserbasiert) oder den Dialog „Projekt klonen“ (Altium Designer) –, wird diese ebenfalls in der Kachel angezeigt. Ein Link führt zum geklonten Projekt. Durch Anklicken öffnen Sie die detaillierte Verwaltungsseite dieses Projekts in einem separaten Browser-Tab.
Beispiel einer Project Cloned-Ereigniskachel.
MCAD-Austausch
Related page: Weitere Informationen zu ECAD-MCAD-CoDesign
Bei der Zusammenarbeit zwischen Elektronik- und Mechanikentwicklung dient der Workspace als Brücke zwischen beiden Bereichen und ermöglicht so direktes ECAD-MCAD-CoDesign. Wenn Änderungen am Leiterplattendesign des Projekts vorgenommen und über das entsprechende CoDesigner-Panel an den Workspace übertragen werden, wird der Zeitleiste eine MCAD Changes Suggested-Ereigniskachel hinzugefügt. Die Person, die die Änderungen übertragen hat, wird mit Namen (und Bild) sowie Datum und Uhrzeit angezeigt. Wenn beim Übertragen eine Nachricht hinzugefügt wurde – über das Panel MCAD CoDesigner (Altium Designer) oder das Panel Altium CoDesigner (in der unterstützten MCAD-Software) –, wird diese ebenfalls in der Kachel angezeigt.
Beispiel einer MCAD Changes Suggested-Ereigniskachel.
Wenn der MCAD-Konstrukteur in seiner unterstützten MCAD-Software Änderungen an der Leiterplatte vornimmt und diese an den Workspace überträgt, wird das entsprechende Übertragungsereignis automatisch in der Verlaufszeitleiste des Projekts angezeigt. Beachten Sie, dass Sie die Verlaufsseite möglicherweise aktualisieren müssen, damit die neueste Änderung angezeigt wird.
Beispiel mit zwei MCAD-bezogenen Ereignissen. Links vom Hauptstrang der Zeitleiste ist das Übertragungsereignis von der ECAD-Seite zu sehen, rechts das Übertragungsereignis von der MCAD-Seite.
Gefilterte Suche
Klicken Sie oben rechts in der Ansicht auf das Bedienelement
, um ein Suchfeld einzublenden, mit dem Sie relevante Ereignisse entlang der Zeitleiste schnell finden können. Die Suchfunktion unterstützt eine einfache Suche im Projektverlauf. Während Sie Ihren Suchbegriff eingeben, wird die Anzeige dynamisch gefiltert, sodass nur die für die Suche relevanten Ereignisse auf der Seite angezeigt werden. Übereinstimmender Text innerhalb einer Ereigniskachel wird hervorgehoben.
Beispiel einer Suche im Projektverlauf. Die Zeitleiste wird während der Eingabe Ihres Suchbegriffs dynamisch gefiltert (ohne Unterscheidung zwischen Groß- und Kleinschreibung). Übereinstimmende Einträge werden in den jeweiligen Ereigniskacheln hervorgehoben.
Die Suchfunktion berücksichtigt die folgenden Informationen:
- Titel der Ereigniskachel.
- Name der Person, die das Ereignis ausgelöst hat.
- Beschreibungstext (Text aus einem Kommentar, einer Notiz oder einer Beschreibung zum Zeitpunkt des jeweiligen Ereignisses).
- Text der Vergleichsdaten – in einer Project Committed-Ereigniskachel.
- Name des Datensatzes – in einer Project Released-Ereigniskachel.
- Projektname – in einer Project Cloned-Ereigniskachel und einer Project Created-Ereigniskachel (bei Erstellung durch Klonen).
Aktualisieren mit neuen Ereignissen
Wenn ein unterstütztes Ereignis im Zusammenhang mit dem Projekt eintritt, wird es automatisch erkannt und für die Ansicht History bereitgestellt. Kurz nach dem Ereignis erscheint unten in der Ansicht eine Benachrichtigung. Klicken Sie auf das Bedienelement
, um die Zeitleiste um das neue Ereignis zu ergänzen.