Warszawa, dn. ..... r.
<Nazwa Firmy>
<Nazwa Projektu>
Specyfikacja przypadku użycia: <Nazwa przypadku użycia>
Wersja <1.0>
[Komentarz: Ten szablon dokumentu przeznaczony jest do wykorzystania z metodyką Rational Unified Process. Tekst zawarty w nawiasach kwadratowych i wyświetlony w kolorze niebieskim italic (styl = InfoBlue) jest przewodnikiem dla autorów i powinien być usunięty przed publikacją dokumentu. Paragrafy wprowadzane po tym stylu będą automatycznie formatowane jako normalne (styl = Tekst Podstawowy).]
[Aby zmodyfikować pola automatyczne w Microsoft Word (które są wyświetlane na szarym tle po ich wskazaniu), wybierz Plik>Właściwości i zmień pola Tytuł, Temat i Firma na wartość właściwą dla tego dokumentu. Po zamknięciu okna dialogowego, pola automatyczne będą zaktualizowane przez wybranie Edycja>Zaznacz wszystko (lub Ctrl-A) i naciśnięcie F9, przez wskazanie pola i naciśnięcie F9.Operacja ta musi być wykonana oddzielnie dla Główek i Stopek. Alt-F9 przełącza między wyświetlaniem nazw pól automatycznych i ich aktualną wartością. Szczegółowe informacje o polach automatycznych zawarte są w pomocy dla programu Word.]
1/2
Wersja: <1.0>
Data: <dd.mm.rr>
<identyfikator dokumentu>
Historia Dokumentu
Data
Wersja
Opis
Autor
<dd.mm.rr>
<x.x>
<szczegóły>
<nazwisko>
Spis Treści
1. Krótki opis 4
2. Aktorzy 4
3. Podstawowy przepływ zdarzeń 4
4. Przepływy alternatywne 5
4.1 <Obszar funkcjonalności> 5
4.1.1 < Pierwszy przepływ alternatywny > 5
4.1.2 < Drugi przepływ alternatywny > 5
4.2 <Inny obszar funkcjonalności> 5
4.2.1 < Inny przepływ alternatywny > 5
5. Podprzepływy 5
5.1 < Pierwszy podprzepływ > 5
5.2 < Drugi podprzepływ > 6
6. Kluczowe scenariusze 6
7. Warunki wstępne 6
7.1 < Pierwszy warunek wejściowy > 6
8. Warunki końcowe 6
8.1 < Pierwszy warunek końcowy > 6
9. Punkty rozszerzeń 6
9.1 <Nazwa punktu rozszerzeń> 6
10. Specjalne wymagania 6
10.1 < Pierwsze specjalne wymaganie > 6
11. Dodatkowe informacje 6
[Ten szablon przeznaczony jest do specyfikacji przypadków użycia (Ang.: Use-Case; wymaganie funkcjonalne obserwowane z otoczenia systemu informatycznego) w zakresie opisu cech wymagania. Ten dokument wykorzystywany jest w narzędziach do zarządzania wymaganiami, takich jak Rational RequisitePro, do specyfikowania i klasyfikowania wymagań we właściwościach przypadków użycia.
Diagramy przypadków użycia mogą być budowane w narzędziach do graficznego modelowania oprogramowania, takich jak Rational Rose. Raport przypadków użycia wraz ze wszystkimi cechami wymagań może być generowany z wykorzystaniem Rational SoDA. Więcej informacji zawartych jest w dziale tool mentors w dokumentacji Rational Unified Process.]
[Opis przekazuje w sposób zwarty rolę oraz cel przypadku użycia. Pojedynczy akapit powinien być wystarczający dla tego opisu.]
[Opis ról użytkowników systemu inicjujących i/lub korzystających z wyników realizacji przypadku użycia]
[Przypadek użycia jest aktywowany, gdy aktor coś zrobi. Aktor zawsze inicjuje przypadek użycia. Przypadek użycia opisuje co aktor robi i co robi system informatyczny w odpowiedzi na to. Jest to wyrażone w formie dialogu aktora z systemem.
Przypadek użycia opisuje co dzieje się w systemie, natomiast nie opisuje jak to się dzieje lub dlaczego. Jeżeli wymieniana jest informacja, należy wyspecyfikować, co jest przekazywane w obie strony. Na przykład nie jest jasne stwierdzenie, że aktor wprowadza dane o kliencie, jeżeli nie są one zdefiniowane. Lepiej jest powiedzieć, że aktor wprowadza nazwisko i adres klienta. Słownik terminów (lub bardziej formalnie model domenowy) jest niezbędny do całościowego zarządzania przypadkami użycia. Umożliwia on zdefiniowanie takich haseł jak informacje o kliencie, które pozwalają uczynić specyfikację przypadku użycia bardziej szczegółową i precyzyjną.
Proste alternatywy mogą być przedstawione bezpośrednio w tekście opisującym przepływ. Jeżeli do opisania co dzieje się, w przypadku wystąpienia alternatywy, wystarczające jest kilka zdań, należy to zrobić bezpośrednio w opisie tego przepływu. Jeżeli przepływ alternatywny jest bardziej skomplikowany, należy użyć oddzielnego punktu do jego opisania. Na przykład punkt Przepływy alternatywne przedstawia jak opisywać bardziej skomplikowane alternatywy.
Skomplikowane przepływy zdarzeń powinny być opisane jako podprzepływy. Głównym celem takiego przedstawienia przepływu jest zwiększenie jego czytelności. Podprzepływy mogą być wywoływane wielokrotnie z różnych miejsc. Należy pamiętać, że przypadki użycia mogą wykorzystywać podprzepływy w różnej kolejności, w sekcjach opcjonalnych, pętlach, a nawet wielokrotnie w tym samym czasie.
Należy pamiętać, że rysunek jest częsta znacznie bardziej komunikatywny niż opis słowny, chociaż nie zawsze jest w stanie przedstawić wszystko. Jeżeli zwiększy to zrozumienie, należy umieścić diagramy przepływów, aktywności lub dowolne inne rysunki. Jeżeli diagram przepływów jest przydatny do przedstawienia skomplikowanego procesu decyzyjnego, to oczywiście należy go użyć. Podobnie dla zachowania obiektu zależnego od jego stanu, diagram stanów jest czytelniejszy niż wielostronicowy opis. Należy wykorzystywać właściwe dla problemu formy prezentacji, ale należy się wystrzegać terminologii, notacji lub ilustracji, które mogą być niezrozumiałe dla czytelników dokumentu. Należy pamiętać, że celem jest wyjaśnienie, a nie zaciemnienie zagadnienia.]
[Bardziej skomplikowane alternatywy są opisywane w oddzielnych punktach, do których odnosi się opis przepływu podstawowego. Rozumienie przepływu alternatywnego jest analogiczne do rozumienia alternatywnego zachowania się systemu – każdy alternatywny przepływ reprezentuje alternatywne zachowanie się systemu występujące zazwyczaj z powodu sytuacji wyjątkowych w głównym przepływie. Punkt może być taki długi, jak jest to potrzebne do opisania wszystkich sytuacji wyjątkowych skojarzonych z alternatywnym zachowaniem się systemu.
Należy rozpocząć każdy alternatywny przepływ linią inicjującą wskazującą, gdzie się on rozpoczyna i przy zajściu jakich warunków on występuje.
Każdy przepływ alternatywny musi kończyć się linią, która wyraźnie określa stan systemu po zakończeniu przepływu alternatywnego oraz miejsce gdzie przepływ podstawowy jest wznawiany. Musi to być jawnie wyjaśnione.
Wykorzystanie przepływów alternatywnych zwiększa czytelność przypadku użycia. Należy pamiętać, że przypadki użycia są tylko tekstowym opisem, a ich głównym celem jest udokumentowanie zachowania się systemu informatycznego w sposób jednoznaczny, zwięzły i zrozumiały.]
[Często wiele przepływów alternatywnych skojarzonych jest z tym samym obszarem funkcjonalności (na przykład specjalne funkcje bankomatu, takie jak: obsługa kart kredytowych, pokwitowań). Umieszczenie koncepcyjnie związanych podprzepływów, w jednym dobrze nazwanym punkcie, zwiększa czytelność opisu.]
[Opis przepływu alternatywnego analogiczny do opisu każdego innego przepływu zdarzeń.]
[Przepływ alternatywny Mozę również być podzielony na podprzepływy opisane w podpunktach. Podprzepływy opisane w tych podpunktach mogą być wykorzystane tylko w jednym przepływie alternatywnym.]
[Zazwyczaj jest wiele przepływów alternatywnych w ramach jednego obszaru funkcjonalności. Należy opisywać je w oddzielnych punktach w celu zwiększenia czytelności dokumentu...
ewao