Dokumentacja administratora Project Lord 1.0
Spis treści 1. Logowanie... 4 1.1. Logowanie do systemu... 4 1.2. Odzyskiwanie hasła... 5 1.3. Logowanie do projektu... 7 2. Kod firmy... 9 3. Menu górne... 9 4. Profil użytkownika... 11 5. Użytkownicy... 12 5.1. Typ konta... 12 5.2. Rola użytkownika... 13 5.3. Lista użytkowników... 14 5.4. Dodawanie użytkownika... 18 6. Projekty... 20 6.1. Lista projektów... 20 6.2. Usuwanie projektu... 22 7. Grupy projektów... 23 7.1. Lista grup projektów... 23 7.2. Dodawanie grupy projektów... 25 7.3. Usuwanie grupy projektów... 26 8. Uprawnienia... 26 2
9. Inne ustawienia... 29 9.1. Pliki językowe... 30 9.2. Typy zadań... 31 9.3. Role użytkowników... 34 9.4. Historia zmian... 36 3
1. Logowanie 1.1. Logowanie do systemu Rys. 1.1 Logowanie do systemu Do zalogowania się w systemie konieczne jest wypełnienie trzech pól w przypadku abonamentowej wersji systemu oraz dwóch pól w wersji instalowanej na serwerze klienta. Pola login i hasło są standardowymi polami. Pole firma widoczne jest tylko w przypadku systemu w wersji abonamentowej. W systemie zastosowany został Kod firmy, któremu poświęcony jest oddzielny rozdział dokumentacji. Dzięki niemu zapewniona jest izolacja użytkowników różnych firm, które wykupiły abonament na korzystanie z systemu na serwerze producenta. Pozwala on również na unikalność loginów jedynie w danej firmie. Dla ułatwienia pracy z systemem stworzony został mechanizm, który pozwala użytkownikowi pominąć wpisywanie kodu firmy przy każdym logowaniu. Podczas pierwszego logowania z danej przeglądarki w plikach cookies zapamiętana zostaje nazwa firmy. Przy każdym kolejnym logowaniu jest ona pobierana i automatycznie wstawiana, co jest przedstawione na poniższym rysunku. 4
Rys. 1.2 Zmiana nazwy firmy podczas logowania Wypełnione pole z firmą staje się nieaktywne, jest jednak możliwość zmiany nazwy w szczególnym przypadku. Służy do tego pomarańczowy link Wpisz inną nazwę firmy, umieszczony pod nieaktywnym polem z firmą. Po wypełnieniu danych potrzebnych do logowania należy kliknąć w przycisk Zaloguj. Rozpocznie się proces sprawdzenia poprawności wpisanych danych. Jeżeli dane będą poprawne, użytkownik zostanie zalogowany i wyświetlona zostanie kolejna strona systemu, w przeciwnym wypadku wyświetlony zostanie komunikat o błędzie. Podczas pierwszego korzystania z systemu należy zalogować się na konto właściciela, w celu zdefiniowania użytkowników i projektów. Domyślne dane logowania na konto właściciela: Login: owner Hasło: pass Kod firmy: default 1.2. Odzyskiwanie hasła Na stronie logowania nad przyciskiem Zaloguj znajduje się link Nie pamiętasz hasła lub nazwy firmy?, który uruchamia proces odzyskiwania hasła oraz nazwy firmy. 5
Rys. 1.3 Formularz odzyskiwania hasła W górnej części strony znajdują się informacje opisujące proces odzyskiwania hasła oraz kwestie bezpieczeństwa. Aby rozpocząć proces odzyskiwania hasła należy wpisać email, jaki został podany podczas tworzenia konta użytkownika, a następnie kliknąć przycisk Wyślij. Rys. 1.4 Informacja o wysłaniu hasła na adres email Spowoduje to wysłanie maila na podany adres. Mail ten zawiera link, który należy skopiować do okna z adresem w przeglądarce. Spowoduje to wysłanie kolejnego maila z nowym hasłem oraz nazwą firmy przypisaną do użytkownika. Okno z komunikatem wyświetlonym po wejściu na stronę za pomocą linku otrzymanego w mailu zostało przedstawione poniżej. 6
Rys. 1.5 Okno potwierdzające odzyskiwanie hasła W oknie tym poza odpowiednim komunikatem znajduje się również przycisk Logowanie, który przenosi użytkownika do strony logowania. Proces odzyskiwania hasła zapewnia bezpieczeństwo w systemie. Kroki, które użytkownik musi wykonać wykluczają sytuację, w której osoba trzecia zmieni hasło w systemie, znając login czy email użytkownika. 1.3. Logowanie do projektu W systemie przyjęto koncepcję wyboru projektu po zalogowaniu się do systemu. Oznacza to, że bezpośrednio po zalogowaniu się, użytkownik musi wybrać jeden z projektów, w którym chce aktualnie pracować. Służy do tego strona na którą użytkownik jest kierowany po zalogowaniu się. Przedstawiona jest ona na poniższym zrzucie ekranu. 7
Rys. 1.6 Logowanie do projektu W centralnej części strony znajduje się panel z tabelą projektów, do których użytkownik został przypisany i może w nich pracować. Tabela zawiera nazwę projektu, status oraz pole wyboru określające czy projekt jest domyślny. Oznaczenie projektu jako domyślny niesie za sobą tylko jedną konsekwencję polegającą na niewyświetleniu po zalogowaniu opisywanej strony. Użytkownik zostaje wtedy automatycznie zalogowany do wybranego projektu i przekierowany na stronę powiadomień w wybranym projekcie. Kliknięcie w link stanowiący nazwę projektu powodującym zalogowanie się do wybranego projektu. Kolejne zalogowanie się użytkownika do systemu będzie wiązało się z koniecznością ponownego wyboru projektu, w którym chce pracować. Zmiana projektu, do którego aktualnie jest zalogowany użytkownik jest również możliwa po zalogowaniu się do projektu. Służy do tego pomarańczowy link znajdujący się w górnym menu po prawej stronie. Opisany jest on w rozdziale Menu górne. Strona z wyborem projektu zawiera dodatkowo dwie ważne funkcjonalności, przedstawione na powyższym zrzucie ekranu, które nie są jednak dostępne dla wszystkich użytkowników. Pierwszą z nich jest czerwony przycisk znajdujący się w lewym górnym rogu strony Przejdź do panelu administratora. Służy on do 8
przejścia do panelu administratora i jest on widoczny jedynie dla użytkowników, których typ konta to administrator lub właściciel. Druga funkcjonalność polega na utworzeniu nowego projektu. Formularz dodawania pokazywany jest po kliknięciu pomarańczowego linku Nowy projekt znajdującego się pod tabelą z projektami. Link ten również jest widoczny jedynie dla administratora, pokazany został na zrzucie ekranu strony wyboru projektu. Proces dodawania projektu został opisany w rozdziale Dodawanie elementu w podrozdziale Projekt. 2. Kod firmy W abonamentowej wersji systemu dostępnej na stronie producenta każdy klient ma przypisany kod firmy. Dzięki temu w jednym systemie wielu klientów może posiadać konta o tej samej nazwie, a kod firmy służy do rozróżniania klientów. Dodane do systemu projekty, użytkownicy oraz inne informacje są niewidoczne dla pozostałych klientów usługi. W wersji oprogramowania do instalacji na serwerze klienta kod firmy jest ukryty. 3. Menu górne Menu w panelu administratora składa się ze stałych elementów, przedstawionych na poniższym rysunku. Ikona po lewej stronie prowadzi do okna wyboru projektu (Rys. 1.6). Rys. 3.1 Menu górne w panelu administratora Po zalogowaniu się do konkretnego projektu, menu jest generowane dynamicznie w zależności od elementów, jakie zawiera projekt. Stałymi elementami są: ikona, na pierwszym miejscu po lewej, która prowadzi użytkownika do strony powiadomień, oraz Notatki. Dzięki zaznaczeniu aktywnego elementu menu białym kolorem 9
możemy łatwo odczytać informację o tym, na jakiej stronie aktualnie znajduje się użytkownik. Menu zostało przedstawione na poniższym rysunku. Rys. 3.2 Menu górne po zalogowaniu sie do konkretnego projektu, zawierające wszystkie możliwe elementy W prawej części menu została umieszczona nazwa wybranego projektu. Obok niej znajduje się przycisk z ikoną, który służy do wylogowania z systemu. Jest on dostępny na każdej stronie systemu, niezależnie od pozostałych elementów menu. Umieszczony został też tutaj przycisk Przełącz projekt. Po jego kliknięciu użytkownik zostanie przeniesiony do strony z tabelą projektów, które może wybrać. Ostatnim linkiem jest Twój profil: {login}. Kliknięcie tego linku powoduje wyświetlenie panelu do zarządzania danymi zalogowanego użytkownika. Panel ten opisano w rozdziale Profil użytkownika. Opisane elementy menu zostały przedstawione poniżej. Rys. 3.3 Prawa część menu górnego w zalogowanym projekcie Na stronie wyboru projektu oraz w panelu administratora menu zawiera jedynie dwa elementy: przycisk do wylogowania oraz link: Twój profil: {login} co obrazuje poniższy rysunek. Rys. 3.4 Prawa część menu górnego przed zalogowaniem do projektu 10
4. Profil użytkownika Rys. 4.1 Formularz profilu użytkownika Informacje o aktualnie zalogowanym użytkowniku można odczytać i modyfikować na każdej stronie systemu po kliknięciu we wspomniany link Twój profil: {login} znajdujący się w prawej części menu. Po jego kliknięciu rozwija się wyżej przedstawiony panel. Podzielony jest on na kilka części. W pierwszej części użytkownik ma możliwość zmiany domyślnego języka w jakim wyświetlane są mu wszystkie teksty i wiadomości w systemie. Wybrany przez niego język nie ma wpływu na domyślny język całego systemu lub języki wybrane przez innych użytkowników. Drugim polem jest pole wyboru Powiadomienia na email. Po jego zaznaczeniu użytkownik będzie otrzymywał na email informacje o wszystkich zmianach jakie nastąpiły w systemie, związanych z elementami, których jest obserwatorem lub projektami, których jest uczestnikiem. Wiadomości są wysyłane na adres email widoczny w drugiej części panelu. 11
Druga część panelu zawiera informacje personalne oraz kontaktowe użytkownika. Na pole z adresem email zostały nałożone dodatkowe zabezpieczenia przed wprowadzeniem adresu email w niewłaściwym formacie. Błędy w adresie są wykrywane przez system w procesie walidacji danych i wyświetlane użytkownikowi w postaci komunikatu. Dodatkowo w prawej dolnej części umieszczony został link Zmień hasło, który jest wyświetlany zamiennie z linkiem Anuluj zmianę hasła. Linki te służą do wyświetlania i ukrywania trzeciej grupy pól, które są odpowiedzialne za zmianę hasła w systemie. Modyfikacja danych użytkownika podczas zmiany hasła spowoduje zapisanie zmian zarówno odnośnie hasła jak i pozostałych danych. Pola do zmiany hasła muszą być wypełnione. Aby zrezygnować ze zmiany hasła należy użyć linku Anuluj zmianę hasła, który ukryje pola do zmiany hasła. Podczas zmiany hasła należy wypełnić wszystkie trzy pola starym hasłem oraz dwa razy nowym dla zapewnienia, iż wpisano dwukrotnie identyczne nowe hasło. Do zatwierdzenia zmiany hasła służy przycisk Zapisz zmiany. 5. Użytkownicy W systemie Project Lord można dokonać podziału użytkowników ze względu na dwa kryteria.: typ konta oraz rola użytkownika w projekcie. 5.1. Typ konta Każdy z użytkowników w systemie ma przypisany mu na stałe typ konta. Istnieje 5 typów kont: Właściciel (Owner), Administrator (Admin), Pracownik (Employee), Klient(Client), Podwykonawca (Contractor). Każdy typ konta ma inne uprawnienia w systemie. Administrator w systemie może wykonać dowolną funkcję z wyjątkiem zarządzania innymi administratorami. Dostępny jest dla niego panel umożliwiający definiowanie wielu ustawień w systemie. Administrator może również wybrać dowolny projekt, 12
pomimo tego, że może nie być jego uczestnikiem, wybranym podczas dodawania projektu do systemu. Właściciel jest szczególnym przypadkiem administratora, który dodatkowo może zarządzać kontami administratorów. W systemie może istnieć tylko jedno konto właściciela. Konto pracownika jest bardzo elastyczne. Jego uprawnienia zależą od roli jaką pełni w danym projekcie. Konto klienta również ma definiowane przez administratora uprawnienia. Domyślnie klient ma jedynie możliwość wglądu do pewnej części raportów, ale administrator może dowolnie modyfikować jego uprawnienia. W efekcie klient może mieć pełny wgląd do projektu, nie można mu jednak przypisać zadania ani nie może być on obserwatorem jakiegokolwiek elementu. Konto podwykonawcy jest szczególnym rodzajem konta, ponieważ nie można się do niego zalogować. Zostało ono utworzone jedynie w celu informacyjnym. Przykładowo w projekcie X zostało zlecone wykonanie grafiki do strony internetowej zewnętrznej firmie. Ze zleceniem tym związane są koszty, czas pracy. W celu uwzględnienia tych kosztów w projekcie muszą one figurować jako zadanie przypisane do jakiegoś użytkownika. W tym celu tworzy się konto podwykonawcy i przypisuje się jemu zadania zlecone do wykonania zewnętrznej firmie, aby następnie zadaniom tym ustawić czas pracy. W ten sposób w raportach uwzględnione są zadania zlecone firmom zewnętrznym lub innym osobom trzecim wykonującym pracę na zlecenie. 5.2. Rola użytkownika Drugie kryterium podziału użytkownika to rola w projekcie. Dla kont takich jak administrator, właściciel, klient i podwykonawca nie ma możliwości przydziału roli, jest to możliwe jedynie dla pracownika. W systemie domyślnie są zdefiniowane następujące role dla pracownika: deweloper, kierownik. Jest również możliwość definiowania nowych ról, np.: tester, koordynator 13
itp. Administrator nie ma możliwości edycji ani usunięcia domyślnych ról, ale może dowolnie zarządzać rolami dodanymi przez niego lub innych administratorów. Każda rola ma zdefiniowane uprawnienia w projekcie. Proces modyfikacji uprawnień opisany jest w rozdziale Uprawnienia. Kluczowym w stworzeniu tak zdefiniowanych ról użytkowników było stwierdzenie, że ten sam pracownik w różnych projektach może pełnić różne funkcje. Dzięki wprowadzeniu takiego mechanizmu ten sam użytkownik systemu, w jednym projekcie może być kierownikiem i mieć pełny wgląd do wszystkich elementów projektu, dowolnie je dodawać i edytować; w innym projekcie może być deweloperem i mieć możliwość jedynie odczytywania elementów projektu bez możliwości modyfikacji; w trzecim natomiast może być testerem z minimalnymi prawami w projekcie. Podejście takie pozwala na bardzo elastyczne zarządzanie uprawnieniami i daje administratorowi dużą swobodę w konfiguracji systemu. 5.3. Lista użytkowników Funkcja zarządzania użytkownikami znajduje się w panelu administratora. Mają do niej dostęp jedynie administratorzy systemu oraz właściciel. Poniżej znajduje się rysunek przedstawiający listę użytkowników widoczną dla administratora z wszystkimi dostępnymi funkcjami do zarządzania. 14
Rys. 5.1 Lista użytkowników systemu Pomimo istnienia kont administratora oraz właściciela, nie są one widoczne na tej liście, ponieważ administrator, który widzi tę listę, nie ma możliwości zarządzania innymi administratorami. Po zalogowaniu na konto właściciela na liście tej pojawią się również administratorzy. W tabeli przedstawionej na powyższym zrzucie ekranu znajdują się trzy kolumny. Pierwsza kolumna zawiera ogólne informacje o koncie oraz dwa linki. Po kliknięciu w link edytuj pokazany zostanie panel edycji danego użytkownika, po kliknięciu w prawy Zablokuj w systemie na konto danego użytkownika nałożona zostanie blokada, która uniemożliwi mu zalogowanie się do systemu. Środkowa kolumna zawiera jedynie dane kontaktowe użytkowników systemu. Trzecia kolumna zawiera listę nazw projektów wraz z ikoną, która jest linkiem do funkcji blokowania oraz odblokowywania użytkownika w wybranym projekcie. Po zablokowaniu w projekcie, użytkownik może zalogować się do systemu ale w tabeli wyboru projektów przy projekcie, w którym jest zablokowany pojawi się ikona 15
z informacją o blokadzie i nie będzie możliwe wybranie takiego projektu. Przedstawia to poniższy rysunek. Rys. 5.2 Lista projektów wyświetlana po zalogowaniu do systemu W przypadku gdy użytkownik realizuje więcej niż 5 projektów, w prawej kolumnie tabeli dodatkowo pojawia się przycisk więcej, wyświetlający pełną listę przypisanych projektów z możliwością blokowania i odblokowania użytkownika w projekcie. Rys. 5.3 Użytkownik na liście użytkowników przypisany do więcej niż 5 projektów 16
Rys. 5.4 Lista wszystkich projektów do których przypisany jest użytkownik, wyświetlana po kliknięciu przycisku "więcej". Dostępna wyszukiwarka pozwala na proste wyszukiwanie użytkowników po imieniu i nazwisku. Wyszukiwanie można zawęzić do typu konta użytkownika. Wybór typu konta użytkownika zadziała również bez wypełnionego pola do wprowadzenia imienia i nazwiska. Wyszukiwarka zadziała wtedy jak filtr, pokazując jedynie tych użytkowników, których typ konta jest zgodny z typem wybranym w wyszukiwarce. Rys. 5.5 Wyszukiwarka na liście użytkowników 17
5.4. Dodawanie użytkownika W prawym górnym i lewym dolnym rogu listy umiejscowiony został pomarańczowy przycisk Nowy, który pozwala dodać nowego użytkownika. Panel dodawania użytkownika, w zależności od wybranego typu konta dodawanego użytkownika, pokazuje informacje o użytkowniku, które można wprowadzić. Pola te są opisane i w większości nie wymagają tłumaczenia. Pola, które wymagają sprecyzowania: Domyślny język Język wybrany z listy języków dostępnych w systemie. W tym języku dany użytkownik będzie miał wyświetlane wszystkie komunikaty i wiadomości w systemie. Powiadomienia na email Po jego zaznaczeniu użytkownik będzie otrzymywał informację na email o wszystkich zdarzeniach w systemie związanych z elementami, których jest obserwatorem oraz projektami, w których jest członkiem. Firma Pole widoczne tylko w przypadku typu konta Klient oraz Podwykonawca. Wprowadzana jest do niego nazwa firmy, której przedstawiciel ma założone konto klienta lub podwykonawcy. Przy niektórych polach umieszczone są czerwone gwiazdki. Oznaczają one konieczność wypełnienie danego pola. Rys. 5.6 Formularz dodawania użytkownika 18
Po poprawnym wypełnieniu formularza i kliknięciu Dalej pokazywany jest drugi krok procesu dodawania użytkownika, w którym możemy przypisać go do wybranych projektów. Przypisanie użytkownika do projektu umożliwia temu użytkownikowi wybór projektu po zalogowaniu się do systemu. W przypadku dodawania użytkownika o typie konta Pracownik, podczas przypisania do projektu wybieramy rolę, jaką będzie pełnił użytkownik w tym projekcie. Na liście rozwijanej z rolami znajdują się wszystkie dostępne role w systemie. Lista staje się aktywna dopiero po zaznaczeniu pola wyboru, oznaczającego przypisanie do danego projektu. Po prawej stronie tabelki do przypisywania projektów widać listę projektów, do których użytkownik został przypisany wraz z rolą w projekcie. Początkowo może się to wydawać zbędne ale w sytuacji kiedy na liście projektów mamy kilka stron z projektami, a każda z nich zawiera 10 projektów, z każdej strony wybierzemy sobie jeden lub dwa projekty to podsumowanie przypisania znajdujące się po prawej stronie okazuje się pomocne. Rys. 5.7 Przypisanie projektów do użytkownika podczas dodawania użytkownika 19
Kolejne kliknięcie przycisku Dalej przenosi do ostatniego kroku w procesie dodawania podsumowania. Wyświetlone są na nim wszystkie dotychczas wprowadzone informacje. Dopiero po jego zatwierdzeniu, nowy użytkownik zostaje zapisany w systemie. Hasło zostaje wysłane na podany podczas dodawania adres email. Dostępna z poziomu listy użytkowników funkcjonalność edycji danego użytkownika wygląda dokładnie tak samo jak opisany powyżej proces dodawania użytkownika. 6. Projekty 6.1. Lista projektów W panelu administratora dostępna jest tabela projektów zawierająca podstawowe informacje o nich. Pierwsza kolumna, tak jak w całym systemie to kolumna Ogólne, zawierająca ogólne informacje o projekcie: nazwę, datę utworzenia, autora oraz funkcje edycji i usuwania projektu. Proces edycji dostępny jest zarówno z poziomu tej tabeli jak i z poziomu szczegółów projektu dostępnych w aplikacji dla zwykłego użytkownika z odpowiednimi uprawnieniami. Z tego powodu opis edycji projektu znajduje się w części dokumentacji przeznaczonej dla użytkownika. W środkowej kolumnie widoczny jest opis dodany do projektu, a w trzeciej kolumnie aktualny status projektu. Nad tabelką znajdują się linki odpowiedzialne za sortowanie listy projektów. Można posortować projekty po nazwie oraz po dacie utworzenia. 20
Rys. 6.1 Lista projektów zdefiniowanych w systemie Po prawej stronie tabeli umieszczona została wyszukiwarka. Może ona działać w dwóch trybach: prostym i zaawansowanym. W trybie prostym zawiera ona jedynie pole tekstowe do wprowadzenia nazwy, jako kryterium wyszukiwania projektów. Po kliknięciu w link zaawansowane w wyszukiwarce pojawiają się nowe pola, które pozwalają wyszukiwać, uwzględniając przedziały czasowe dat rozpoczęcia, zakończenia i planowanego zakończenia projektu. Pozostawienie wszystkich pól pustych i kliknięcie przycisku Szukaj powoduje wyświetlenie całej listy projektów domyślnie posortowanej. 21
Rys. 6.2 Wyszukiwarka na liście projektów W prawym górnym rogu oraz w lewym dolnym rogu tabeli znajduje się przycisk Nowy uruchamiający funkcję dodawania nowego projektu. Proces dodawania projektu opisany został w części dokumentacji dla zwykłego użytkownika. 6.2. Usuwanie projektu Wspomniany wcześniej link do usuwania projektu przenosi użytkownika na stronę usuwania projektu. Strona ta zawiera podstawowe informacje o projekcie oraz o powiązaniach z zadaniami, przypadkami użycia itp. Jeżeli z projektem są powiązane elementy, administrator musi być świadomy konsekwencji usunięcia projektu. Zanim będzie można definitywnie usunąć projekt trzeba zaznaczyć pole wyboru zabezpieczające przed przypadkowym kliknięciem. UWAGA! Projekt zostanie definitywnie usunięty z bazy danych oraz wszystkie pliki z nim związane. Nie będzie możliwości przywrócenia tych danych. 22
7. Grupy projektów W systemie zaimplementowane zostały grupy projektów. Grupa projektów pozwala klasyfikować wspólne projekty, biorąc pod uwagę dowolne kryterium, np. klienta, dział firmy itp. Zarządzanie grupami projektów dostępne jest jedynie dla administratora. Jest jednak możliwość dodawania grupy projektów przez zwykłego użytkownika z odpowiednimi uprawnieniami podczas procesu dodawania projektu. Nad listą rozwijaną znajduje się link Dodaj grupę wyświetlający okno dialogowe z formularzem dodawania grupy. Opisane zostało to przy opisie dodawania projektu w części dokumentacji dla użytkownika. 7.1. Lista grup projektów Rys. 7.1 Lista grup projektów zdefiniowanych w systemie Lista grup podobnie jak pozostałe listy w panelu administratora, przedstawiona została w postaci tabeli z trzema kolumnami. Lewa kolumna zawiera ogólne informacje oraz funkcje edycji i usuwania. Środkowa kolumna zawiera opis, a trzecia kolumna przedstawia listę projektów, należące do danej grupy. W przypadku, gdy do grupy przypisanych jest więcej niż 5 projektów pojawia się przycisk więcej, który otwiera 23
okno dialogowe z listą wszystkich przypisanych projektów wraz z podstawowymi informacjami o nich. Rys. 7.2 Lista wszystkich projektów przypisanych do wybranej grupy, wyświetlana po kliknięciu przycisku "więcej". Nad tabelką z nazwami grup znajdują się linki umożliwiające sortowanie grup według: nazwy, daty utworzenia oraz autora. Drugie kliknięcie w ten sam link oznacza sortowanie w odwrotną stronę według tego samego kryterium. Wyszukiwarkę można używać w dwóch trybach: podstawowym oraz zaawansowanym. W trybie podstawowym nazwa grupy jest jedynym kryterium wyszukiwania. W trybie zaawansowanym dodatkowymi kryteriami wyszukiwania są data utworzenia oraz autor. Rys. 7.3 Wyszukiwarka na liście grup projektów 24
7.2. Dodawanie grupy projektów W prawym górnym oraz lewym dolnym rogu tabeli znajdują się pomarańczowe przyciski Nowa, które umożliwiają dodanie nowej grupy. Rys. 7.4 Formularz dodawania grupy projektów Formularz ten składa się z dwóch pól tekstowych do wprowadzenia nazwy i opisu. Po poprawnym wprowadzeniu danych i kliknięciu przycisku dalej pojawia się panel podsumowania z wprowadzonymi danymi. Dopiero po zatwierdzeniu wprowadzonych danych grupa projektów zostaje dodana do systemu. Wspomniana wcześniej edycja jest procesem identycznym do przedstawionego wyżej opisu dodawania grupy. 25
7.3. Usuwanie grupy projektów Po kliknięciu w link usuwania grupy, który umieszczony jest w kolumnie Ogólne tabeli z listą grup projektów, wyświetlony zostaje panel z informacjami na temat usuwanej grupy i przyciskiem do potwierdzenia usunięcia. Rys. 7.5 Formularz usuwania grupy projektów W sytuacji, kiedy do grupy należą projekty, przycisk usuwania grupy jest nieaktywny. Można go aktywować zaznaczając pole potwierdzające żądanie usunięcia grupy projektów wraz ze wszystkimi należącymi do niej projektami. Po aktywacji pola wyboru możliwe jest usunięcie grupy. Grupa wraz ze wszystkimi projektami zostaje usunięta z systemu. UWAGA! Grupa oraz wszystkie przypisane do niej projekty zostaną definitywnie usunięte z bazy danych oraz wszystkie pliki z nimi związane. Nie będzie możliwości przywrócenia tych danych. 8. Uprawnienia Każdy użytkownik pełni określoną rolę w projekcie, dzięki czemu można określić jakie czynności ma prawo wykonywać w systemie. Domyślnie zdefiniowane są trzy 26
role, których uprawnienia można modyfikować: deweloper, kierownik oraz klient. Dla każdej nowo dodanej roli również można nadawać uprawnienia. Aby zdefiniować uprawnienia należy wybrać z menu zakładkę UPRAWNIENIA. Rys. 8.1 Wybór roli, której uprawnienia będą modyfikowane Po wybraniu roli pojawi się lista uprawnień, które można jej nadać. Rys. 8.2 Nadawanie uprawnień wybranej roli 27
Uprawnienia dotyczą przeglądania, dodawania, edycji oraz usuwania elementów a także uwzględniają raporty, które będą widoczne dla danej roli. Dodanie uprawnienia do dodawania/edycji/usuwania skutkuje automatycznym nadaniem uprawnienia do przeglądania elementu. Domyślne uprawnienia dla: deweloper przeglądanie projektu / iteracji / pakietów / przypadków użycia / zadań / wydarzeń dodawanie pakietu / przypadku użycia / zadania dostęp do raportów: o wszystkie pakiety / iteracje / przypadki użycia / zadania o szczegóły pakietu / iteracji / przypadku użycia / zadania o obecny stan pracy nad zadaniami o kalendarz o uczestnicy projektu kierownik wszystkie uprawnienia za wyjątkiem usuwania projektu / iteracji / pakietu / przypadku użycia / zadania klient dostęp do raportów: o koszt pracy nad pakietami / iteracjami / przypadkami użycia / zadaniami o obecny stan pracy nad zadaniami Po zmodyfikowaniu uprawnień i kliknięciu przycisku Dalej pojawi się podsumowanie z zaznaczonymi na zielono nowo dodanymi uprawnieniami, a na czerwono z uprawnieniami usuniętymi dla danej roli. 28
Rys. 8.3 Podsumowanie dotyczące zmienionych uprawnień Aby zapisać zmiany należy kliknąć przycisk Zapisz zmiany. 9. Inne ustawienia W tej części panelu administratora znajdują się pozostałe funkcje do konfiguracji systemu: zarządzania plikami językowymi w systemie oraz wyboru domyślnego języka dla całego systemu, zarządzania typami zadań zarządzania rolami użytkowników usuwania historii zmian dla wybranego projektu 29
9.1. Pliki językowe Rys. 9.1 Lista języków zdefiniowanych w systemie W zakładce Pliki językowe znajduje się tabela ze wszystkimi językami dostępnymi w systemie. Zawiera ona nazwę języka, opcję wyboru języka oraz funkcje do usuwania. Na powyższym rysunku widać, że dla języka angielskiego i polskiego funkcja usuwania jest nieaktywna, jest ona aktywna jedynie dla języka rosyjskiego. Jest to spowodowane tym, że język angielski i polski są to domyślne języki w systemie i nie ma możliwości ich usunięcia. Wszystkie pliki językowe dodane przez administratora można usuwać. Wybrany domyślny język zaznaczony jest za pomocą przycisku jednokrotnego wyboru. W celu zmiany wyboru domyślnego języka, po wybraniu innego języka należy nacisnąć przycisk Zapisz zmiany języka. Po poprawnej zmianie tego ustawienia wyświetlany jest odpowiedni komunikat o sukcesie. Pod tabelą po lewej stronie znajduje się drugi przycisk Dodaj nowy język. Po jego wciśnięciu pojawia się okno dialogowe z formularzem służącym do wysłania na serwer nowego pliku ze wszystkimi przetłumaczonymi tekstami. 30
Rys. 9.2 Dodawanie nowego języka do systemu Formularz ten składa się z pola służącego do wyboru pliku z dysku oraz listy rozwijanej z nazwami języków. Kliknięcie zarówno w pole tekstowe przeznaczone na nazwę pliku jak i na przycisk Przeglądaj spowoduje otwarcie okna do wyboru pliku. Po zatwierdzeniu wyboru odpowiedni plik jest wybierany, a jego nazwa jest widoczna w polu tekstowym. Po naciśnięciu przycisku wyślij następuje wysłanie pliku na serwer i zamknięcie okna dialogowego. Link usuń znajdujący się w tabeli również powoduje pokazanie okna dialogowego z prośbą o potwierdzenie usunięcia wybranego pliku. Rys. 9.3 Usuwanie języka z systemu Plik zostaje usunięty dopiero po wciśnięciu przycisku Usuń w oknie dialogowym. 9.2. Typy zadań W systemie występują różne typy zadań. Można je rozumieć jako rodzaj zadania, kategorię do której jest ono przypisane. Typy zadań utworzone dla wygody pracowników i łatwiejszej klasyfikacji zadań. 31
Rys. 9.4 Lista typów zadań zdefiniowanych w systemie Zakładka ta zawiera tabelę z typami zadań. W tabeli znajduje się nazwa typu zadania oraz funkcje edycji i usuwania. Tak samo jak w przypadku plików językowych, w systemie zdefiniowane są domyślne typy zadań, których administrator nie może edytować ani usuwać. Może on zarządzać jedynie zadaniami, które zostały dodane do listy przez jednego z administratorów. Pod tabelą umiejscowiony został pomarańczowy przycisk Nowy typ zadania. Po jego naciśnięciu uruchomi się funkcja dodania nowego typu zadania do systemu. Rys. 9.5 Dodawanie nowego typu zadania do systemu Formularz zawiera tylko jedno pole do podania nazwy typu zadania. Naciśnięcie przycisku Dodaj powoduje dodanie typu zadania do systemu oraz zamknięcie okna dialogowego. 32
Naciśnięcie linku do edycji powoduje pojawienie się takiego samego formularza jak podczas dodawania z wypełnionym polem przeznaczonym na nazwę typu zadania. Nazwę tą można zmienić na inną, która nie została jeszcze wykorzystana w systemie. Modyfikacje zostaną zatwierdzone po wciśnięciu przycisku Zapisz zmiany. Kliknięcie w link usuń, znajdujący się w tabeli po prawej stronie wybranego typu zadania, powoduje pojawienie się okna dialogowego z prośbą o potwierdzenie usunięcia typu zadania. Wciśnięcie przycisku Usuń powoduje usunięcie typu zadania z systemu. Rys. 9.6 Usuwanie typu zadania z systemu W przypadku gdy typ zadania jest przypisany do istniejących zadań w systemie, nie można go bezpośrednio usunąć. W oknie dialogowym potwierdzającym usuwanie pojawia się informacja o powiązanych zadaniach oraz prośba o wybór typu zadania, który zostanie przypisany do wszystkich tych powiązanych zadań. Dla administratora widoczne jest to jako jeden krok składający się z wyboru typu zadania, który zastąpi usuwany typ oraz wciśnięcie przycisku Usuń, który spowoduje zapisanie zmian. Rys. 9.7 Usuwanie typu zadania do którego przypisane są zadania 33
9.3. Role użytkowników W systemie pracownicy realizujący projekty pełnią różne role. Z każdą rolą związane są uprawnienia do wykonywania funkcji w systemie. Rola nie jest na stałe przypisana do użytkownika, może on mieć przypisane różne role w różnych projektach. Do każdej roli definiowane są uprawnienia, które zostały szczegółowo opisane w rozdziale Uprawnienia. Rys. 9.8 Lista ról użytkowników zdefiniowanych w systemie Zakładka Role użytkowników analogicznie do pozostałych zawiera tabelę ze wszystkimi rolami użytkowników. W tabeli znajduje się nazwa roli oraz funkcje do edycji i usuwania. Również i w tym przypadku w systemie zostały zdefiniowane pewne domyślne role użytkowników, których nie można usunąć. Widoczne jest to na powyższym rysunku w postaci szarych, nieaktywnych funkcji edycji i usuwania przy rolach: deweloper, kierownik oraz klient. Pozostałe role, które zostały dodane przez administratora mają aktywne funkcje edycji oraz usuwania. Pod tabelą umieszczony jest przycisk Nowa rola użytkowników. Po wciśnięciu tego przycisku pokazuje się okno dialogowe z formularzem do dodawania nowej roli użytkowników. 34
Rys. 9.9 Dodawanie nowej roli do systemu Formularz zawiera jedno pole do wprowadzenia nazwy roli użytkownika. Dodanie roli następuje po wciśnięciu przycisku Dodaj. Formularz edycji jest taki sam jak dodawania roli, pokazywany jest on po wciśnięciu linku usuń w tabeli z rolami użytkowników. Jedyną różnicą jest przycisk Zapisz zmiany w miejscu przycisku Dodaj, znajdującego się na formularzu dodawania. Powoduje on zapisanie w systemie wprowadzonych zmian nazwy roli użytkownika. Proces usuwania roli użytkownika jest analogiczny do opisanego wyżej procesu usuwania typu zadania. W przypadku, gdy usuwana rola użytkownika nie jest wykorzystywana w projektach dla użytkowników, po kliknięciu w link usuń w tabeli z rolami, pojawia się okno dialogowe z prośbą o potwierdzenie usunięcia roli użytkownika. Naciśnięcie przycisku usuń powoduje usunięcie roli. W przeciwnym przypadku, jeżeli usuwana rola użytkownika jest wykorzystywana, pojawia się komunikat taki jak na poniższym rysunku. Rys. 9.10 Usuwanie roli użytkownika z systemu 35
Żeby w takiej sytuacji usunąć rolę użytkownika należy wybrać inną rolę, która zastąpi tę usuwaną. Oznacza to, że w każdym projekcie w systemie, w którym użytkownik ma przypisaną rolę, którą chcemy usunąć, zostanie mu przypisana rola wybrana do zastąpienia. Po usunięciu wszystkich powiązań usuwanej roli może ona zostać faktycznie usunięta z systemu. Cały ten proces jest uruchamiany po kliknięciu przycisku usuń. 9.4. Historia zmian W systemie można na stałe usunąć zmiany dokonane w elementach projektu. Rys. 9.11 Usuwanie historii zmian dotyczącej wybranego projektu W zakładce tej możliwe jest usunięcie całej historii zmian dla danego projektu od najstarszej zapisanej zmiany do daty podanej przez administratora. Żeby móc usunąć historię zmian najpierw należy z listy rozwijanej z projektami wybrać projekt, którego dotyczy historia zmian. Poniżej listy rozwijanej z projektami wyświetlona jest informacja o dacie najstarszej zmiany jaka jest zapisana w systemie. W celu usunięcia zmian należy wybrać datę do której zmiany mają być usunięte. Można to zrobić na dwa sposoby, korzystając ze specjalnego pola tekstowego. Pierwszy sposób polega na wpisaniu daty w formacie rrrr-mm-dd. Drugi sposób polega na wybraniu daty z wyświetlonego kalendarza, co pokazane jest na poniższym rysunku. 36
Rys. 9.12 Wybranie daty do której mają być usunięte zmiany dotyczące projektu Po wybraniu daty przycisk Usuń staje się aktywny. Po jego wciśnięciu wszystkie zmiany od najstarszej do zmian wykonanych w wybranym terminie zostaną usunięte. UWAGA! Wszystkie zmiany zostaną definitywnie usunięte z bazy danych. Nie będzie możliwości przywrócenia tych danych. 37