Inspektor w swej pracy powinien posiłkować się systemem śledzenia
błędów dostępnym pod adresem http://gromit.iiar.pwr.wroc.pl/mantis.
System ten jest przeznaczony do raportowania i śledzenia błędów
wykrytych w specyfikacji, modelu i w kodzie źródłowym tworzonej
aplikacji.
Cykl życia defektu w Mantisie
Defekt pojawia się w systemie z chwilą odnalezienia go w projekcie
przez inspektora. Do raportowania służy polecenie Report Issue.
W formularzu który się pojawi po wywołaniu tego polecenia
należy
zwrócić szczególną uwagę na następujące pola:
- Severity
- ważność defektu. Istnieją tu takie specjalne kategorie ważności jak:
text
- odnosi się do literówek i błędów
ortograficznych, oraz feature
- odnosi się do sugestii dodatkowych funkcjonalności.
- Summary
- nazwa defektu.
- Description
- opis
defektu, na podstawie którego pozostałe osoby biorące udział
w
projekcie będą mogło stwierdzić o co chodziło inspektorowi!
- Artefacts connected with fault
- jeżeli defekt dotyczy dokumentacji to należy tu wypisać
których dokumentów /
diagramów defekt dotyczy, natomiast jeżeli dotyczy kodu
źródłowego to należy podać na potrzeby którego przypadku
użycia kod ten był implementowany.
- Revision
- numer rewizji projektu, z systemu kontroli wersji (np SVN),
której defekt dotyczy.
- Type
- rodzaj defektu. Do wyboru są: missing
- brakujący element, wrong
- błędny element, excessive
- nadmiarowy element oraz ambiguous
- niejednoznaczność.
Po wykryciu defekt powinien zostać naprawiony przez jednego z
pozostałych członków zespołu. Fakt ten należy oczywiście
odnotować w Mantisie. W tym celu trzeba odnaleźć defekt (defekty można
przeglądać np. wybierając View
Issues), otworzyć formularz z jego opisem (klikając na ID defektu) i
zmienić jego status na rozwiązany (Change
Status To: resolved). Podczas zmiany statusu błędu trzeba
koniecznie wypełnić przynajmniej dwa pola:
- Resolved in
revision - numer rewizji projektu, z systemu kontroli
wersji (np SVN), w której defekt został poprawiony
- Time [h]
- czas, w godzinach, jaki poświęcono na poprawki związane z eliminacją
defektu.
Po naprawieniu defektu inspektor ma za zadanie zweryfikować, czy defekt
został poprawnie wyeliminowany. Informacja o tej czynności powinna
pojawić się w Mantisie w postaci zmiany statusu defektu. Jeżeli
poprawki były właściwie wykonane to status jest zmieniany na closed, w
przeciwnym razie natomiast status zmienia się na feedback i defekt
trzeba jeszcze raz naprawiać.
Wykorzystanie raportu Mantisa w raporcie inspektora
Istnieje możliwość użycia raportu wygenerowanego z systemu Mantis jako
"Listy zagadnień", która to powinna być podstawowym elementem
składowym raportu przygotowywanego przez inspektora na zajęcia
poświęcone modelowaniu. Aby przy pomocy Mantisa uzyskać akceptowalną
postać raportu należy wykonać następujące kroki:
- Wybrać: "View Issues" -> "Print Reports" -> "Printing Options".
- Pozostawić zaznaczone tylko pola: "ID", "Severity", "
Date Submitted", "Reporter",
"Assigned To", "Priority", "Status", "Summary", "Description",
"Artefacts connected with fault" i "Type".
- Teraz można już wygenerować raport: "View Issues" -> "Print Reports" -> Ikonka Excel'a.
- Zawsze należy sprawdzić, czy raport wygenerował się poprawnie; czasami nazwy kolumn są przesunięte w stosunku do ich zawartości.
Kroki 1 i 2 wystarczy wykonać raz - zostaną zapamiętane w konfiguracji
konta użytkownika. Tak przygotowany raport należy wydrukować i
przynieść na zajęcia w wersji papierowej.
Uwaga:
Aby uzyskać dostęp do Mantisa należy wysłać na adres marian.jureczko@pwr.wroc.pl nazwę
realizowanego projektu oraz personalia (imię i nazwisko) i adresy
mailowe członków zespołu projektowego. Po jakimś czasie, na
adresy te, zostaną wysłane maile z
informacją, że konta zostały utworzone i z linkami pod
którymi
należy dokonać aktywacji konta (ustalić hasło).
Uwaga 2: O wszelakich nieprawidłowościach w działaniu systemu proszę donosić na
adres marian.jureczko@pwr.wroc.pl.
Uwaga 3:
Mantis domyślnie działa w angielskiej wersji językowej. W wersji tej
nie można stosować polskich znaków diakretycznych. Aby polskie
"ogonki" były wyświetlane poprawnie należy w preferencjach Mantisa
przestawić język na polski.