1 Studia Podyplomowe IT w Biznesie Inżynieria Oprogramowania Wykład 3 Faza określania wymagań Polsko-Japońska Wyższa Szkoła Technik Komputerowych, Warszawa Wykładowca: dr hab. inż. Kazimierz Subieta profesor PJWSTK [email protected] http://www.ipipan.waw.pl/~subieta
2 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 2 marzec 2002 Plan wykładu Trudność określenia wymagań Poziomy ogólności opisu wymagań Jakość opisu wymagań Metody rozpoznania wymagań Wymagania funkcjonalne Porządkowanie wymagań Wymagania niefunkcjonalne Czynniki uwzględniane przy konstruowaniu wymagań Dokument wymagań
3 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 3 marzec 2002 Określenie wymagań ProjektowanieImplementacjaTestowanieKonserwacja Faza strategicznaAnaliza Instalacja Dokumentacja Celem fazy określenia wymagań jest ustalenie wymagań klienta wobec tworzonego systemu. Dokonywana jest zamiana celów klienta na konkretne wymagania zapewniające osiągnięcie tych celów. Klient rzadko wie, jakie wymagania zapewnią osiągniecie jego celów. Ta faza nie jest więc prostym zbieraniem wymagań, lecz procesem, w którym klient wspólnie z przedstawicielem producenta konstruuje zbiór wymagań zgodnie z postawionymi celami. W przypadku systemu na zamówienie analitycy mają bezpośredni kontakt z przedstawicielami klienta. Faza ta wymaga dużego zaangażowania ze strony klienta, ze strony przyszłych użytkowników systemu i ekspertów w dziedzinie.
4 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 4 marzec 2002 Trudność określenia wymagań Klient z reguły nie wie dokładnie w jaki sposób osiągnąć założone cele. Cele klienta mogą być osiągnięte na wiele sposobów. Duże systemy są wykorzystywane przez wielu użytkowników. Ich cele są często sprzeczne. Różni użytkownicy mogą posługiwać się inną terminologią mówiąc o tych samych problemach. Zleceniodawcy i użytkownicy to często inne osoby. Głos zleceniodawców może być w tej fazie decydujący, chociaż nie zawsze potrafią oni właściwie przewidzieć potrzeby przyszłych użytkowników.
5 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 5 marzec 2002 Poziomy ogólności opisu wymagań Definicja wymagań, to ogólny opis w języku naturalnym. Opis taki jest rezultatem wstępnych rozmów z klientem. Specyfikacja wymagań, to częściowo ustrukturalizowany zapis wykorzystujący zarówno język naturalny, jak i proste, częściowo przynajmniej sformalizowane notacje. Specyfikacja oprogramowania, to formalny opis wymagań. Formalna specyfikacja oznacza bardzo dokładne zdekomponowanie wymagań (najlepiej w pewnym formularzu) na krótkie punkty, których interpretacja nie powinna nastręczać trudności lub prowadzić do niejednoznaczności. Formalna specyfikacja powinna stanowić podstawę dla fazy testowania.
6 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 6 marzec 2002 Jakość opisu wymagań Dobry opis wymagań powinien: Być kompletny oraz niesprzeczny. Opisywać zewnętrzne zachowanie się systemu a nie sposób jego realizacji. Obejmować ograniczenia przy jakich musi pracować system. Być łatwy w modyfikacji. Brać pod uwagę przyszłe możliwe zmiany wymagań wobec systemu. Opisywać zachowanie systemu w niepożądanych lub skrajnych sytuacjach. Najbardziej typowy błąd w tej fazie: koncentrowanie się na sytuacjach typowych i pomijanie wyjątków oraz przypadków granicznych. Zarówno użytkownicy jak i analitycy mają tendencję do nie zauważania sytuacji nietypowych lub skrajnych.
7 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 7 marzec 2002 Zalecenia dla fazy definicji wymagań Wymagania użytkowników powinny być wyjaśniane poprzez krytykę i porównania z istniejącym oprogramowaniem i prototypami. Powinien być uzyskany stan porozumienia pomiędzy projektantami i użytkownikami dotyczący projektowanego systemu. Wiedza i doświadczenia potencjalnej organizacji podejmującej się rozwoju systemu powinny wspomóc studia nad osiągalnością systemu. W wielu przypadkach dużym wspomaganiem jest budowa prototypów. Wymagania użytkowników powinny być: jasne, jednoznaczne, weryfikowalne, kompletne, dokładne, realistyczne, osiągalne.
8 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 8 marzec 2002 Metody rozpoznania wymagań Wywiady i przeglądy. Wywiady powinny być przygotowane (w postaci listy pytań) i podzielone na odrębne zagadnienia. Podział powinien przykrywać całość tematu i powinny być przeprowadzone na reprezentatywnej grupie użytkowników. Wywiady powinny doprowadzić do szerokiej zgody i akceptacji projektu. Studia na istniejącym oprogramowaniem. Dość często nowe oprogramowanie zastępuje stare. Studia powinny ustalić wszystkie dobre i złe strony starego oprogramowania. Studia wymagań systemowych. Dotyczy sytuacji, kiedy nowy system ma być częścią większego systemu. Studia osiągalności. Określenie realistycznych celów systemu i metod ich osiągnięcia. Prototypowanie. Zbudowanie prototypu systemu działającego w zmniejszonej skali, z uproszczonymi interfejsami.
9 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 9 marzec 2002 Wymagania funkcjonalne Opisują funkcje (czynności, operacje) wykonywane przez system. Funkcje te mogą być również wykonywane przy użyciu systemów zewnętrznych. Określenie wymagania funkcjonalnych obejmuje następujące kwestie: Określenie wszystkich rodzajów użytkowników, którzy będą korzystać z systemu. Określenie wszystkich rodzajów użytkowników, którzy są niezbędni do działania systemu (obsługa, wprowadzanie danych, administracja). Dla każdego rodzaju użytkownika określenie funkcji systemu oraz sposobów korzystania z planowanego systemu. Określenie systemów zewnętrznych (obcych baz danych, sieci, Internetu), które będą wykorzystywane podczas działania systemu. Ustalenie struktur organizacyjnych, przepisów prawnych, statutów, zarządzeń, instrukcji, itd., które pośrednio lub bezpośrednio określają funkcje wykonywane przez planowany system.
10 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 10 marzec 2002 Metody specyfikacji wymagań Język naturalny - najczęściej stosowany. Wady: niejednoznaczność powodująca różne rozumienie tego samego tekstu; elastyczność, powodująca wyrazić te same treści na wiele sposobów. Utrudnia to wykrycie powiązanych wymagań i powoduje trudności w wykryciu sprzeczności. Formalizm matematyczny. Stosuje się rzadko (dla specyficznych celów). Język naturalny strukturalny. Język naturalny z ograniczonym słownictwem i składnią. Tematy i zagadnienia wyspecyfikowane w punktach i podpunktach. Tablice, formularze. Wyspecyfikowanie wymagań w postaci (zwykle dwuwymiarowych) tablic, kojarzących różne aspekty (np. tablica ustalająca zależność pomiędzy typem użytkownika i rodzajem usługi). Diagramy blokowe: forma graficzna pokazująca cykl przetwarzania. Diagramy kontekstowe: ukazują system w postaci jednego bloku oraz jego powiązania z otoczeniem, wejściem i wyjściem. Diagramy przypadków użycia: poglądowy sposób przedstawienia aktorów i funkcji systemu.
11 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 11 marzec 2002 Formularz wymagań funkcjonalnych W formularzach zapis jest podzielony na konkretne pola, co pozwala na łatwe stwierdzenie kompletności opisu oraz na jednoznaczną interpretację. Nazwa funkcji Opis Dane wejściowe Źródło danych wejściowych Wynik Warunek wstępny Warunek końcowy Efekty uboczne Powód Edycja dochodów pracownika Funkcja pozwala edytować łączne dochody podatnika uzyskane w danym roku. Informacje o dochodach pracowników uzyskane uzyskanych z różnych źródeł: kwoty przychodów, koszty uzyskania przychodów oraz zapłaconych zaliczek na poczet podatku dochodowego. Informacje o dokumentach opisujących dochody z poszczególnych źródeł. Dokumenty oraz informacje dostarczone przez podatnika. Dane wpisywane przez pracownika firmy podatkowej. Kwota dochodu = kwota przychodu - kwota kosztów (zarówno dla konkretnych dochodów, jak i dla łącznych dochodów podatnika). Łączne kwoty przychodów, kosztów uzyskania dochodów oraz zapłaconych zaliczek są sumami tych kwot dla dochodów z poszczególnych źródeł. Jak wyżej. Uaktualnienie podstawy opodatkowania. Funkcja pomaga przyśpieszyć obsługę klientów oraz zmniejszyć ryzyko popełnienia błędów. Przykład jednej zapełnionej tabeli wg przyjętego formularza:
12 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 12 marzec 2002 Porządkowanie wymagań Hierarchia wymagań funkcjonalnych: Z reguły funkcje można rozbić na podfunkcje. Format tekstowy: Funkcja nadrzędna f1 funkcja f1.1 funkcja f1.2 funkcja f1.3 funkcja f1.3.1 funkcja f1.3.2 funkcja f1.3.3 funkcja f1.4 funkcja f1.4.1 funkcja f1.4.2 funkcja f1.4.3 Notacje graficzne: funkcja f1 funkcja f1.4.3 funkcja f1.4.2 funkcja f1.4.1 funkcja f1.4 funkcja f1.3.2 funkcja f1.3.3 funkcja f1.3 funkcja f1.1 funkcja f1.2 funkcja f1.3.1 funkcja f1 funkcja f1.3 funkcja f1.1 funkcja f1.2 funkcja f1.3.2 funkcja f1.3.3 funkcja f1.3.1 Na każdym poziomie ten sam poziom szczegółowości. Kolejność funkcji nie ma znaczenia. Niektóre funkcje mogą być wykonywane wielokrotnie. Wyszczególniać tylko funkcje widoczne dla użytkowników.
13 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 13 marzec 2002 Zstępujące konstruowanie hierarchii funkcji funkcja f1 funkcja f1.4.3 funkcja f1.4.2 funkcja f1.4.1 funkcja f1.4 funkcja f1.3.2 funkcja f1.3.3 funkcja f1.3 funkcja f1.1 funkcja f1.2 funkcja f1.3.1 funkcja f1 funkcja f1.4 funkcja f1.3 funkcja f1.1 funkcja f1.2 funkcja f1 W ten sposób można dekomponować funkcje do dowolnego poziomu (podejście top-down). Możliwe jest również podejście odwrotne (bottom-up), kiedy składamy kilka funkcji bardziej elementarnych w jedną funkcje bardziej ogólną. Możliwa jest również technika mieszana.
14 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 14 marzec 2002 Przykład: program podatkowy Program ułatwia przygotowanie formularzy zeznań podatkowych (PIT-ów) oraz przechowanie informacji o źródłach przychodów i ulg. Zeznanie może być tworzone przez pojedynczego podatnika lub małżeństwa. Zeznania mogą obejmować informacje o rocznych przychodach (w przypadku małżeństwa z podziałem na przychody męża i żony) oraz o ulgach podatkowych. Przychody podzielone są na klasy ze względu na źródło uzyskania, np. poza-rolnicza działalność gospodarcza, wolny zawód,... W ramach danej klasy przychodów podatnik mógł osiągnąć szereg przychodów z różnych źródeł. Wszystkie przychody opisane są przez kwotę przychodu, kwotę kosztów, kwotę zapłaconych zaliczek oraz kwotę dochodu. Powyższe informacje pozwalają obliczyć należny podatek oraz kwotę do zapłaty lub zwrotu. Zeznanie zawiera także informację o podatniku oraz adres Urzędu Skarbowego. System pozwala wydrukować wzorzec zeznania zawierający wszystkie informacje, jakie podatnik musi umieścić w formularzu. Zeznanie można zabezpieczyć przed dalszymi zmianami (po złożeniu w Urzędzie Skarbowym). System pozwala na tworzenie listy podatników oraz urzędów skarbowych, które mogą być pomocne przy tworzeniu nowego zeznania. Przechowuje także informację o wszystkich złożonych zeznaniach. „Surowy” wynik wywiadów z klientem:
15 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 15 marzec 2002 Program podatkowy: hierarchia funkcji Ewidencja podatników Wydruk zeznania Wyświetlanie rozliczenia Edycja informacji o ulgach Edycja informacji o przychodach Usuwanie zeznania Zabezpieczanie zeznania Ewidencja Urzędów Skarbowych Ewidencja zeznań podatkowych Dodawanie zeznania Edycja zeznania Wyświetlenie rozliczenia (kopia) Wydruk zeznania (kopia) Przeglądanie zeznania (bez możliwości zmiany dla zeznań zabezpieczonych)
16 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 16 marzec 2002 Przykład: system harmonogramowania zleceń Zlecenia dla wydziału przygotowywane są przez dział marketingu. Zlecenie oznacza konieczność wyprodukowania konkretnej ilości pewnego wyrobu przed upływem konkretnego terminu. Czasami może być określony najwcześniejszy pożądany termin realizacji. Dział marketingu wykorzystuje własny system informatyczny, w którym między innymi umieszczane są informacje o zleceniach, pożądane jest więc, aby system harmonogramowania zleceń automatycznie odczytywał te informacje. Wyprodukowanie danego wyrobu (realizacja zlecenia) wymaga wykonania ciągu operacji. Pewne operacje mogą być wykonywane tylko na jednym urządzeniu; w innych przypadkach możliwe jest wykorzystanie kilku maszyn, które mogą różnić się efektywnością pracy. Po wykonaniu pewnych operacji może być konieczna przerwa, zanim rozpocznie się realizacja następnych; z drugiej strony taka przerwa może trwać przez ograniczony czas. Przestawienie maszyn na inne operacje może wymagać czasu. Co pewien czas (np. raz na miesiąc) ustalany jest harmonogram niezrealizowanych zleceń. System powinien opracować harmonogramy w formie łatwej do wykorzystania przez kadrę kierowniczą wydziału oraz przygotowywać zamówienia do magazynu na półprodukty. Zlecenia wykonane są usuwane ze zbioru niezrealizowanych zleceń. „Surowy” wynik wywiadów z klientem:
17 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 17 marzec 2002 System harmonogramowania zleceń: funkcje Zarządzanie zleceniami (ogólna funkcja systemu) Ewidencja zleceńEdycja technologicznego opisu wydziałuHarmonogramowanie zleceń Wczytywanie informacji o zleceniach Wydruk informacji o zleceniach Wyświetlanie informacji o zleceniach Edycja opisu maszyn Sprawdzanie kompletności opisu Wydruk informacji technologicznych Edycja opisu operacji Edycja opisu wyrobów Ustalanie harmonogramu Edycja harmonogramu Graficzna prezentacja harmonogramu Wydruk harmonogramu Przygotowanie kart zadań Przygotowanie zamówień na półprodukty
18 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 18 marzec 2002 Diagramy przypadków użycia Opis funkcji systemu z punktu widzenia jego użytkowników. Opis wymagań poszczególnych użytkowników jest prostszy niż opis wszystkich wymagań wobec systemu. Klasy użytkowników: sekretarka projektant osoba przeglądająca mapę Identyfikacja funkcji dla poszczególnych użytkowników. Przeprowadzając wywiad z konkretna osobą należy koncentrować się na funkcjach istotnych z punktu widzenia roli (ról) odgrywanych przez tę osobę. Metoda przypadków użycia nie jest sprzeczna z hierarchiczną dekompozycją funkcji. Metoda modeluje aktorów, a nie konkretne osoby. Jedna osoba może pełnić rolę wielu aktorów; np. być jednocześnie projektantem i osobą przeglądającą mapę. I odwrotnie, jeden aktor może odpowiadać wielu osobom, np. sekretarka.
19 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 19 marzec 2002 Przykład: system informacji geograficznej - SIG SIG jest rodzajem mapy komputerowej, składającej się z tła (np. mapy fizycznej) oraz szeregu obiektów graficznych umieszczonych na tym tle. Obiekt może być punktem (budynek, firma), linią (rzeka, kolej) lub obszarem (park, osiedle). Każdy obiekt ma swoją nazwę i ewentualny opis, który może być wyświetlony na żądanie użytkownika. Obiekt można opisać szeregiem słów kluczowych. Użytkownik ma możliwość wyświetlenia tylko tych obiektów, które opisano słowami kluczowymi. Zarządzanie SIG (ogólna funkcja systemu) Przeglądanie SIG Projektowanie SIG Edycja słów kluczowych) Przeglądanie SIG (kopia) Wyświetlenie opisu obiektu graficznego Wybór/pomijanie słów kluczowych Wyświetlanie mapy (różnych obszarów w różnym powiększeniu) Dodawanie obiektu Edycja obiektów graficznych Edycja tła Edycja obiektu Usuwanie obiektu Dodawanie słowa kluczowego Edycja słowa kluczowego Usuwanie słowa kluczowego
20 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 20 marzec 2002 Diagram przypadków użycia dla SIG użytkownik Wyświetlenie mapy Wybór/pomijanie słów kluczowych Wyświetlenie opisu obiektu graficznego projektant Edycja tła Edycja obiektu Dodawanie obiektu Edycja obiektów graficznych Usuwanie obiektu Edycja słów kluczowych Edycja słowa kluczowego Dodawanie słowa kluczowego Usuwanie słowa kluczowego uses
21 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 21 marzec 2002 Wymagania niefunkcjonalne Opisują ograniczenia, przy których system ma realizować swoje funkcje. Wymagania dotyczące produktu. Np. musi istnieć możliwość operowania z systemem wyłącznie za pomocą klawiatury. Wymagania dotyczące procesu. Np. proces realizacji harmonogramowania zleceń musi być zgodny ze standardem opisanym w dokumencie XXXA/96. Wymagania zewnętrzne. Np. system harmonogramowania musi współpracować z bazą danych systemu komputerowego działu marketingu opisaną w dokumencie YYYB/95. Niedopuszczalne są jakiekolwiek zmiany w strukturze tej bazy.
22 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 22 marzec 2002 Formularz zapisu wymagań Nr 1 2 3 Wymaganie System powinien zwracać wynik zapytania po max 5-ciu sekundach przy 100 użytkownikach pracujących jednocześnie. Każdy klient powinien mieć przypisany krótki numer identyfikacyjny..... Data wprow. 99/04/14 00/02/05..... Motywacja Inaczej system nie będzie konkurencyjny na rynku Inne identyfikatory (nazwisko, PESEL, numer telefonu) są niestabilne, nie unikalne, lub za długie.... Rozmówca A.Nowak J.Pietrzak K.Lubicz..... Uwagi Może być niestabilne.....
23 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 23 marzec 2002 Weryfikowalność wymagań niefunkcjonalnych Cecha Wydajność Rozmiar Łatwość użytkowania Niezawodność Przenaszalność Weryfikowalne miary Liczba transakcji obsłużonych w ciągu sekundy Czas odpowiedzi Liczba rekordów w bazie danych Wymagana pamięć dyskowa Czas niezbędny dla przeszkolenia użytkowników Rozmiar dokumentacji Prawdopodobieństwo błędu podczas realizacji transakcji Średni czas pomiędzy błędnymi wykonaniami Dostępność (procent czasu w którym system jest dostępny) Czas restartu po awarii systemu Prawdopodobieństwo zniszczenia danych w przypadku awarii Procent kodu zależnego od platformy docelowej Liczba platform docelowych Koszt przeniesienia na nową platformę Wymagania niefunkcjonalne powinny być weryfikowalne - czyli powinna istnieć możliwość sprawdzenia lub zmierzenia czy system je rzeczywiście spełnia. Np. wymagania “system ma być łatwy w obsłudze”, „system ma być niezawodny”, „system ma być dostatecznie szybki”, itd. nie są weryfikowalne.
24 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 24 marzec 2002 Czynniki uwzględniane przy konstruowaniu wymagań niefunkcjonalnych (1) Możliwości systemu: Zestaw funkcji, które ma wykonywać system, uporządkowany hierarchicznie. Objętość: Ilu użytkowników będzie pracować jednocześnie? Ile terminali ma być podłączone do systemu? Ile czujników będzie kontrolowanych jednocześnie? Ile danych będzie przechowywane? Szybkość: Jak długo może trwać operacja lub sekwencja operacji? Liczba operacji na jednostkę czasu. Średni czas niezbędny dla jednej operacji. Dokładność: Określenie stopnia precyzji pomiarów lub przetwarzania. Określenie wymaganej dokładności wyników. Zastąpienie wyników ilościowych jakościowymi lub odwrotnie. Ograniczenia: ograniczenia na interfejsy, jakość, skalę czasową, sprzęt, oprogramowanie, skalowalność, itd.
25 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 25 marzec 2002 Czynniki uwzględniane przy konstruowaniu wymagań niefunkcjonalnych (2) Interfejsy komunikacyjne: sieć, protokoły, wydajność sieci, poziom abstrakcji protokołów komunikacyjnych, itd. Interfejsy sprzętowe: specyfikacja wszystkich elementów sprzętowych, które będą składały się na system, fizyczne ograniczenia (rozmiar, waga), wydajność (szybkość, RAM, dysk, inne pamięci), wymagania co do powierzchni lokalowych, wilgotności, temperatury i ciśnienia, itd. Interfejsy oprogramowania: Określenie zgodności z innym oprogramowaniem, określenie systemów operacyjnych, języków programowania, kompilatorów, edytorów, systemów zarządzania bazą danych, itd. Interakcja człowiek-maszyna: Wszystkie aspekty interfejsu użytkownika, rodzaj języka interakcji, rodzaj sprzętu (monitor, mysz, klawiatura), określenie formatów (układu raportów i ich zawartości), określenie komunikatów dla użytkowników (język, forma), pomocy, komunikatów o błędach, itd.
26 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 26 marzec 2002 Czynniki uwzględniane przy konstruowaniu wymagań niefunkcjonalnych (3) Adaptowalność: Określenie w jaki sposób będzie organizowana reakcja na zmiany wymagań: dodanie nowej komendy, dodanie nowego okna interakcji, itd. Bezpieczeństwo: założenia co do poufności, prywatności, integralności, odporności na hakerów, wirusy, wandalizm, sabotaż, itd. Odporność na awarie: konsekwencje błędów w oprogramowaniu, przerwy w zasilaniu, kopie zabezpieczające, częstotliwości składowania, dziennika zmian, itd. Standardy: Określenie dokumentów standardyzacyjnych, które mają zastosowanie do systemu: formaty plików, normy czcionek, polonizacja, standardy procesów i produktów, itd. Zasoby: Określenie ograniczeń finansowych, ludzkich i materiałowych. Skala czasowa: ograniczenia na czas wykonania systemu, czas szkolenia, wdrażania, itd.
27 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 27 marzec 2002 Dokument wymagań Wymagania powinny być zebrane w dokumencie - opisie wymagań. Dokument ten powinien być podstawą szczegółowego kontraktu między klientem a producentem oprogramowania. Powinien także pozwalać na weryfikację stwierdzającą, czy wykonany system rzeczywiście spełnia postawione wymagania. Powinien to być dokument zrozumiały dla obydwu stron. Często producenci nie są zainteresowaniu w precyzyjnym formułowaniu wymagań, które pozwoliłoby na rzeczywistą weryfikację powstałego systemu. Tego rodzaju polityka lub niedbałość może prowadzić do konfliktów.
28 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 28 marzec 2002 Zawartość dokumentu specyfikacji wymagań (1) Streszczenie (maksymalnie 200 słów) Spis treści Status dokumentu (autorzy, firmy, daty, podpisy, itd.) Zmiany w stosunku do wersji poprzedniej Informacje organizacyjne 1. Wstęp 1.1. Cel 1.2. Zakres 1.3. Definicje, akronimy i skróty 1.4. Referencje, odsyłacze do innych dokumentów 1.5. Krótki przegląd 2. Ogólny opis 2.1. Walory użytkowe i przydatność projektowanego systemu 2.2. Ogólne możliwości projektowanego systemu 2.3. Ogólne ograniczenia 2.4. Charakterystyka użytkowników 2.5. Środowisko operacyjne 2.6. Założenia i zależności 3. Specyficzne wymagania 3.1. Wymagania funkcjonalne (funkcje systemu) 3.2. Wymagania niefunkcjonalne (ograniczenia). Dodatki Zasadnicza zawartość dokumentu Norma ANSI/IEEE Std 830-1993 „Recommended Practice for Software Requirements Specifications”
29 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 29 marzec 2002 Zawartość dokumentu specyfikacji wymagań(2) Wymagania sprzętowe. Wymagania dotyczące bazy danych. Model (architektura) systemu. Słownik terminów (użyte terminy, akronimy i skróty z wyjaśnieniem) Indeks pomocny w wyszukiwaniu w dokumencie konkretnych informacji (dla dokumentów dłuższych niż 80 stron) Kolejność i numeracja punktów w przedstawionym spisie treści powinna być zachowana. W przypadku gdy pewien punkt nie zawiera żadnej informacji należy wyraźnie to zasygnalizować przez umieszczenie napisu „Nie dotyczy”. Dla każdego wymagania powinien być podany powód jego wprowadzenia: cele przedsięwzięcia, których osiągnięcie jest uwarunkowane danym wymaganiem. Wszelki materiał nie mieszczący się w podanych punktach należy umieszczać w dodatkach. Często spotykane dodatki
30 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 30 marzec 2002 Jakość dokumentu wymagań Styl Jasność: jednoznaczne sformułowania, zrozumiały dla użytkowników i projektantów. Strukturalna organizacja dokumentu. Spójność: brak konfliktów w wymaganiach. Modyfikowalność: wszystkie wymagania są sformułowane w jasnych punktach, które mogą być wyizolowane z kontekstu i zastąpione przez inne. Ewolucja Możliwość dodawania nowych wymagań, możliwość ich modyfikacji Odpowiedzialność Określenie kto jest odpowiedzialny za całość dokumentu wymagań. Określenie kto lub co jest przyczyną sformułowania danego wymagania, istotne w przypadku modyfikacji, np. zmiany zakresu lub kontekstu systemu. Medium Dokument papierowy lub elektroniczny. Staranne kontrolowanie wersji dokumentu.
31 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 31 marzec 2002 Słownik Opis wymagań może zawierać terminy niezrozumiałe dla jednej ze stron. Mogą to być terminy informatyczne (niezrozumiałe dla klienta) lub terminy dotyczące dziedziny zastosowań (niezrozumiałe dla przedstawicieli producenta). Wszystkie specyficzne terminy powinny być umieszczone w słowniku, wraz z wyjaśnieniem. Słownik powinien precyzować terminy niejednoznaczne i określać ich znaczenie w kontekście tego dokument (być może nieco węższe). Termin konto konto bankowe klient użytkownik Objaśnienie Nazwana ograniczona przestrzeń dyskowa, gdzie użytkownik może przechowywać swoje dane. Konta są powiązane z określonymi usługami, np. pocztą komputerową oraz z prawami dostępu. Sekwencja cyfr oddzielona myślnikami, identyfikująca stan zasobów finansowych oraz operacji dla pojedynczego klienta banku. Jednostka sprzętowa instalowana w biurach urzędu, poprzez którą następuje interakcja użytkownika końcowego z systemem. Osoba używająca systemu dla własnych celów biznesowych nie związanych z obsługą lub administracją systemu. Synonimy (nie zalecane) katalog użytkownika konto stacja robocza klient
32 K.Subieta. SPIT, Inżynieria Oprogramowania, Wykład 3, Folia 32 marzec 2002 Kluczowe czynniki sukcesu Zaangażowanie właściwych osób ze strony klienta Pełne rozpoznanie wymagań, wykrycie przypadków i dziedzin szczególnych i nietypowych. Błąd popełniany w tej fazie polega na koncentrowaniu się na sytuacjach typowych. Sprawdzenie kompletności i spójności wymagań. Przed przystąpieniem do dalszych prac, wymagania powinny być przejrzane pod kątem ich kompletności i spójności. Określenie wymagań niefunkcjonalnych w sposób umożliwiający ich weryfikację.