Benutzerhandbuch
Das vorliegende Benutzerhandbuch beschreibt einige Aspekte, die für die Benutzung des entwickelten Plugins wichtig sind.
- Projekt zum Aufzeichnen von PSP-Daten nutzen
- Editor
- Ressource Summary
- Task Overview
- Tasks
- Defekte
- Time Records manuell hinzufügen
- Diagramme
- Daten exportieren
- Um Daten für den persönlichen Softwareprozess erfassen zu können, muss ein Projekt eine psp.csv Datei besitzen, wie in Abbildung 1 gezeigt wird.
Abbildung 1: Die PSP-Datei in einem Projekt.
- Einem Projekt kann eine psp.csv Datei über den Menüpunkt New -> PSP oder über den Kontextmenüpunkt Configure eines Projektes hinzugefügt werden.
- Beim Hinzufügen einer Datei kann man neben dem Projekt, zu dem die psp.csv Datei hinzugefügt wird, noch andere Projekte auswählen. Deren Werte fließen in die Berechnung der To-Date Werte ein. Die Abbildung 2 zeigt das Dialogfenster zum Hinzufügen einer psp.csv Datei zu einem Projekt.
Abbildung 2: Dialogfenster zum Hinzufügen einer PSP-Datei zu einem Projekt.
- Der PSP-Editor eines Projektes kann über einen Doppelklick auf die psp.csv Datei geöffnet werden
- Der Editor besitzt die in PSP verwendeten Formulare.
- Abbildung 3 zeigt einen Ausschnitt aus dem PSP-Editor.
- Einträge in Tabellen in einem Editor können über das Kontextmenü oder den dazugehörigen Button hinzugefügt und gelöscht werden. Bearbeiten kann man Einträge über das Kontextmenü oder über einen Doppelklick.
Abbildung 3: Der PSP-Editor.
- Die Ressource Summary, gezeigt in Abbildung 4, zeigt Informationen zu einer im Package-Explorer ausgewählten Ressource.
- Hier werden die Anzahl der eingefügten und entfernten Defekte pro Phase, sowie die Anzahl der geschriebenen Codezeilen zu einer ausgewählten Ressource angezeigt.
- Um zum Beispiel die Daten zu einer Klasse in einem Java-Projekt anzuzeigen kann man diese in dem Package-Explorer auswählen und die Daten zu der Klasse werden in der Ressource Summary angezeigt.
Abbildung 4: Die Ressource Summary.
- In der Task Overview, gezeigt in Abbildung 5, können Tasks verwaltet werden. Die Task Overview bietet eine Übersicht über alle Aufgaben in einem Projekt.
- Hier können die Priorität, der Status und das letzte Änderungsdatum einer Task angezeigt werden.
- Es werden immer die Tasks zu einem Projekt hier angezeigt. Will man die Tasks zu einem anderen Projekt anzeigen, muss man dieses in dem Package-Explorer auswählen.
- Man kann die Tasks filtern. Es lassen sich abgeschlossene Tasks ausblenden, nur bestimmte Phasen oder auch nur bestimmte Spalten anzeigen.
Abbildung 5: Übersicht über alle Tasks.
- Tasks können über drei Arten hinzugefügt werden:
- Über den Button zum Hinzufügen in dem Formular Task Plan im PSP-Editor.
- Über das Kontextmenü eines Projektes, wie in Abbildung 8 gezeigt.
- Über die Task Overview, gezeigt in Abbildung 5. Hier können Tasks über den Button oder über das Kontextmenü hinzugefügt oder gelöscht werden. Bearbeitet können die Tasks über das Kontextmenü oder über einen Doppelklick auf die entsprechende Task in der Task Overview.
- Bei Hinzufügen muss ein Name, eine Phase und das geschätzte Enddatum für eine Task angegeben werden. Außerdem können hier optional Schätzungen zu den geschriebenen Zeilen Code, den eingefügten und entfernten Defekten beim Ausführen dieser Task angegeben werden. Das Dialogfenster ist in Abbildung 6 abgebildet.
Abbildung 6: Dialog zum Hinzufügen einer Task.
- Um eine automatische Zeitaufzeichnung zu einer Task zu starten, kann man dies über das Kontextmenü einer Task, zu sehen in Abbildung 5, oder über die Toolbar (grünes Wiedergabesymbol) der Task Overview machen. Eine gerade ausgeführte Task wird in der Task Overview, wie in Abbildung 7 gezeigt, dargestellt. Die Zeitaufzeichnung pausieren, stoppen oder eine Task als abgeschlossen markieren kann man ebenfalls über das Kontextmenü oder über die Toolbar der Task Overview.
Abbildung 7: Anzeige einer laufenden Task.
- Defekte können zu einem Projekt, zu einem Paket bzw. Ordner in einem Projekt oder zu einer Datei z.B. einer Klasse in einem Java-Projekt hinzugefügt werden. Dazu kann man eine Ressource, zu der man ein Defekt hinzufügen will, in dem Package-Explorer auswählen und über den Kontextmenüpunkt PSP hinzufügen, wie in Abbildung 8 gezeigt.
Abbildung 8: Kontextmenü zum manuellen Hinzufügen der PSP-Daten.
- Die Anzahl der Defekte zu einer Ressource können in der Resource Summary angezeigt werden. Die Defekte kann man in der Defect Record Log in dem PSP-Editor anzeigen. Dabei werden nur die Defekte zu einer ausgewählten Ressource angezeigt.
- Abbildung 9 zeigt das Dialogfenster zum Hinzufügen eines Defektes. Es kann hier ein Defekttyp, eine Phase wann der Defekt hinzugefügt wurde auswählen. Wurde der Defekt bereits entfernt kann eine Phase,wann der Defekt entfernt wurde auswählen.Wählt man hier keine Phase aus gilt der Defekt als noch nicht entfernt.
- Zu einem Defekt, wie Abbildung 9 zeigt, kann man manuell eine Zeit angeben, die man zum Entfernen des Defektes gebraucht hat (Checkbox Fix Manual). Wird keine Zeit angegeben, wird eine Task für den Defekt angelegt, mit der man die Zeit beim Entfernen des Defektes automatisch messen kann.
Abbildung 9: Dialog zum Hinzufügen eines Defektes.
- Man kann neben der automatischen Aufzeichnung der Zeit auch manuell Zeiteinträge zu einem Projekt hinzufügen.
- Dies kann auf drei Arten passieren:
- Über den Button zum Hinzufügen in dem Formular Time Record Log im PSP-Editor.
- Über das Kontextmenü eines Projektes, wie in Abbildung 8 gezeigt.
- Direkt zu einer Task, wie in Abbildung 5 zu sehen ist.
- Zu einem Zeiteintrag kann man das Start- und Enddatum, die Start- und Endzeit, sowie die Unterbrechungszeit in Minuten und ein Kommentar hinzufügen. Die Abbildung 10 zeigt das Dialogfenster, mit dem ein manueller Zeiteintrag hinzugefügt wird.
Abbildung 10: Dialog zum manuellen Hinzufügen eines Time Records.
- Man kann sich verschiedene Diagramme zu dem Verlauf eines Projektes anzeigen lassen. Dies kann über das dazugehörige Menü in der Toolbar eines PSP-Editors machen. Die Abbildung 11 zeigt das Menü.
Abbildung 11: Menü zum Anzeigen der Diagramme
- Die aufgezeichneten Daten zu einem Projekt werden zur Laufzeit in einer Datenbank zwischengespeichert.
- Um die Daten in die psp.csv Datei, gezeigt in Abbildung 1, zu exportieren, muss man diese manuell exportieren. Dies kann man über die Toolbar eines PSP-Editors tun. Die Abbildung 12zeigt den dafür vorgesehenen Button.
Abbildung 12: Button zum Exportieren der Daten.