PU 131 Jak akwizytor chcę aby informacje z Jira były

P.U. 131
Jak akwizytor chcę aby informacje z Jira były odczytywane za pośrednictwem serwisów
RESTowych.
Cel
Odczytanie listy wszystkich zagadnień z systemu JIRA, który jest dostępny pod wskazanym
adresem URL, pobranie klucza, nagłówka i opisu z systemu JIRA dla każdego zagadnienia oraz
wyświetlenie wszystkich zagadnień w tabeli w oknie głównym.
Warunki wstępne
P.U. inicjowany przez akwizytora. Serwer JIRA musi być uruchomiony. Zapewniony musi być
dostęp do Internetu (poza przypadkiem, gdy JIRA działa w sieci lokalnej).
Przebieg podstawowy
1. Użytkownik wybiera w lewej części głównego okna Projekt oraz jego wersję.
Następnie, w oknie głównym w zakładce Configuration, naciska przycisk ‘Jira’, aby
załadować dane z pliku konfiguracyjnego ‘bugtracker.properties’. Aby pobrać dane
należy nacisnąć przycisk JIRA w zakładce Fetch. Przed jego naciśnięciem lub po
powrocie do pkt. 1. w przypadku wyświetlenia komunikatu o błędnych danych,
użytkownik może skonfigurować komponent bugtracker, modyfikując adres URL JIRY,
nazwę użytkownika, hasło, nazwę projektu lub filtry pobieranych zagadnień (tj. type,
priority, resolution, status, reporter, assignee, createdBefore, createdAfter,
resolvedBefore oraz resolvedAfter) wpisując w odpowiednie pola dane i
zatwierdzając przyciskiem Save w zakładce Version.
2. Uruchomiony zostaje moduł bugtracker, który z pliku konfiguracyjnego
‘bugtracker.properties’ odczytuje następujące dane: adres URL JIRY, nazwę projektu,
nazwę użytkownika i hasło oraz wyświetlone zostaje okno stanu pobierania danych.
3. Jeżeli w pliku konfiguracyjnym zostały ustawione filtry, po których ma nastąpić
pobieranie zagadnień, to zostaje z nich utworzony filtr zapisany w języku JQL, który
zostaje następnie wczytany do komponentu bugtracker. Jeżeli żadne filtry nie zostały
ustawione, pobrane zostaną wszystkie zagadnienia.
4. Następuje zalogowanie do systemu JIRA dostępnego pod wpisanym adresem przy
pomocy podanej nazwy użytkownika i hasła.
5. Komponent bugtracker łączy się ze wskazanym systemem JIRA i filtruje listę
zagadnień na podstawie utworzonego wcześniej filtru, który zostaje wypisany.
Następuje odczyt klucza (key) i nagłówka (summary) dla każdego zagadnienia
zapisanego w systemie JIRA.
6. Dla każdego pobranego zagadnienia komponent bugtracker odczytuje szczegółowy
opis zagadnienia (description), historię oraz komentarze (jeśli dostępne).
7. Odczytane zagadnienia zostają zapisane w repozytorium, a w oknie stanu pobierania
pasek postępu wypełnia się do końca i zostaje wyświetlony komunikat Collected!.
8. Z komponentu bugtracker do komponentu GUI zwrócona zostaje lista wszystkich
zagadnień znajdujących się w systemie JIRA. Każde zagadnienie składa się z
identyfikatora (ID), klucza (key), nagłówka (summary) oraz opisu zagadnienia
(description).
9. Po zamknięciu okna stanu pobierania za pomocą przycisku OK. lub X następuje
wylogowanie z JIRY.
10. Koniec PU.
Przebiegi alternatywne
4. Błąd podczas logowania:
a. Podany został adres URL, pod którym nie znajduje się system JIRA. Następuje
zgłoszenie wyjątku i wyświetlenie komunikatu ‘Błąd logowania do systemu
JIRA: błędny URL. Wpisz adres poprawnie’. Przejście do pkt. 1. przebiegu
podstawowego.
b. Podane zostały błędne dane logowania. Następuje zgłoszenie wyjątku i
wyświetlenie komunikatu ‘Błąd logowania do systemu JIRA: nieprawidłowy
login lub hasło. Podaj poprawne dane’. Przejście do pkt. 1. przebiegu
podstawowego.
5. W danym systemie JIRA nie występuje żadne zagadnienie. Wyświetlony zostaje
komunikat ‘Brak zagadnień w systemie JIRA (URL)’. Następuje wylogowanie z
systemu JIRA, a następnie przejście do pkt. 9. przebiegu podstawowego.
*1. Komponent bugtracker nie może załadować strony systemu JIRA (bądź ładowanie trwa
zbyt długo), zgłoszony zostaje wyjątek i wyświetlony komunikat ‘Minął czas oczekiwania na
stronę, być może utraciłeś połączenie z Internetem. Spróbuj ponownie za chwilę’. Przejście do
punktu 1. przebiegu podstawowego.
Warunki końcowe
P.U. uznaje się za poprawnie zakończony, gdy moduł bugtracker zwróci listę wszystkich
zagadnień pobranych z systemu JIRA. Każde zagadnienie składa się z identyfikatora (ID),
klucza (key) oraz nagłówka (summary).
P.U. uznaje się za zakończony błędnie, jeżeli w oknie stanu pobierania danych nie został
wyświetlony komunikat Collected!, co oznacza wystąpienie jakiegoś błędu podczas jednego z
punktów przebiegu P.U.