Czym jest diagram przeglądu interakcji#

Diagram przeglądu interakcji (interaction overview diagram) jest diagramem interakcji UML, który przedstawia przepływ sterowania między większymi fragmentami zachowania. Łączy strukturę podobną do diagramu aktywności z odwołaniami do interakcji, takich jak szczegółowe diagramy sekwencji.

Stosuj go, gdy scenariusz jest zbyt rozbudowany, by wygodnie zmieścić wszystkie komunikaty na jednym diagramie sekwencji. Przegląd pokazuje, które interakcje następują po sobie, gdzie występuje decyzja lub równoległość i do jakiego szczegółowego modelu prowadzi dany fragment.

Diagram przeglądu interakcji jest odmianą diagramu aktywności, ale jego węzły mogą reprezentować całe interakcje. Nie należy mylić go z diagramem komunikacji ani traktować jako automatycznego spisu wszystkich sekwencji systemu.

Węzły i przepływ#

Diagram używa wielu znanych elementów aktywności: węzła początkowego i końcowego, przepływów sterowania, decyzji, scalania, rozwidlenia i synchronizacji. Węzły interakcji reprezentują zawartość interakcji, a niekoniecznie pojedyncze działanie. Można je opisać krótką nazwą, np. Weryfikacja zamówienia.

Odwołanie do interakcji (interaction use) wskazuje inną zdefiniowaną interakcję. W notacji UML często jest prezentowane jako ramka z nagłówkiem ref i nazwą odwoływanego fragmentu. Szczegółowy scenariusz może znajdować się na osobnym diagramie sekwencji lub innym diagramie interakcji. Czytelnik powinien móc ustalić, do którego modelu prowadzi odwołanie.

Warunki umieszcza się przy wychodzących przepływach z węzła decyzji, zwykle w nawiasach kwadratowych. Dla każdego przypadku warto określić warunek domyślny, jeśli diagram ma obejmować wszystkie możliwe wyniki. Równoległość pokazuj węzłami rozwidlenia i synchronizacji, o ile rzeczywiście zachodzi współbieżne wykonanie.

Przykład: obsługa zamówienia#

Proces rozpoczyna otrzymanie zamówienia. Następuje szczegółowa interakcja weryfikacji, po której decyzja rozdziela przebieg na płatność lub obsługę odmowy. Każde odwołanie może prowadzić do osobnego diagramu sekwencji, dzięki czemu przegląd pozostaje czytelny.

Diagram przeglądu interakcji prowadzi od otrzymania zamówienia przez odwołanie do interakcji weryfikacji, decyzję, a następnie do odwołania do płatności lub obsługi odmowy i kończy proces.
Przepływ procesu z odwołaniami do osobno opisanych interakcji.

Słowo ref w etykietach sygnalizuje, że krok jest skrótem do szczegółowej interakcji. Diagram jest uproszczoną wizualizacją przepływu: w pełnym modelu UML należy przedstawić odpowiednie węzły i ramki odwołań oraz nazwać interakcje tak, by można je było odnaleźć. Sam tekst na diagramie nie tworzy technicznego linku do innego diagramu.

Jak zaprojektować przegląd interakcji#

  1. Określ granice procesu: co go uruchamia i jaki wynik go kończy.
  2. Podziel zachowanie na spójne interakcje, które można opisać osobno.
  3. Umieść w przeglądzie tylko decyzje i zależności potrzebne do zrozumienia całości.
  4. Zastąp szczegóły wymiany komunikatów nazwanymi węzłami lub odwołaniami do interakcji.
  5. Dodaj warunki na przepływach wychodzących z decyzji i uwzględnij istotny przypadek domyślny.
  6. Pokaż równoległość tylko wtedy, gdy fragmenty rzeczywiście mogą przebiegać współbieżnie.
  7. Sprawdź, czy każde odwołanie wskazuje istniejącą interakcję o zgodnych nazwach.
  8. Przejdź cały diagram od początku do końca i sprawdź, czy wszystkie ścieżki są zrozumiałe.

Najczęściej szczegóły pojedynczego kroku najlepiej opisać diagramem sekwencji. Przegląd ma kierować czytelnika do tych szczegółów i objaśniać ich kolejność, a nie powtarzać wszystkie komunikaty.

Diagram przeglądu interakcji a diagram aktywności#

Diagram aktywności opisuje przepływ działań, decyzji i współbieżnych ścieżek. Diagram przeglądu interakcji korzysta z podobnej logiki przepływu, lecz jego węzły mogą odwoływać się do całych interakcji. Gdy modelujesz kroki procesu, aktywność zwykle wystarcza. Gdy kolejne kroki mają osobne diagramy komunikacji lub sekwencji, przegląd interakcji porządkuje je na wyższym poziomie.

Diagram przeglądu interakcji a diagram sekwencji#

Diagram sekwencji pokazuje uczestników i komunikaty w jednym scenariuszu. Diagram przeglądu interakcji pokazuje, jak większe fragmenty zachowania łączą się w proces oraz które warianty prowadzą do których fragmentów. Można ich użyć razem: przegląd wyjaśnia strukturę procesu, a sekwencje dokumentują wymianę komunikatów wewnątrz wybranych kroków.

Typowe błędy#

  • Powielanie całych diagramów sekwencji. Zbyt dużo szczegółów usuwa korzyść z przeglądu.
  • Niejasne odwołania. Nazwa węzła powinna odpowiadać konkretnej interakcji, którą da się odnaleźć.
  • Brak warunków przy decyzji. Odbiorca nie wie wtedy, którą ścieżkę wybrać.
  • Niekompletne warianty. Przemyśl ścieżkę błędu, odmowy i przypadek domyślny.
  • Używanie ref jako ozdobnej etykiety. Odwołanie powinno wskazywać rzeczywiście istniejący fragment zachowania.
  • Zbyt wysoki poziom szczegółowości. Przegląd powinien prezentować przebieg między interakcjami, nie zastępować ich treści.
  • Nadmierna liczba odwołań na jednej planszy. Duży proces podziel na czytelne poziomy lub osobne diagramy.
  • Mylenie przepływu sterowania z komunikacją. Strzałka przepływu w przeglądzie nie musi być komunikatem między obiektami.

Co diagram przeglądu interakcji pokazuje, a czego nie#

Diagram przeglądu interakcji pokazuje ogólny przepływ między większymi częściami zachowania, decyzje między nimi oraz odwołania do szczegółowych interakcji. Jest mapą, która pozwala przejść od opisu procesu do właściwych modeli szczegółowych.

Nie opisuje samodzielnie pełnej wymiany komunikatów, struktury klas, fizycznego wdrożenia ani wszystkich reguł biznesowych. Uzupełnij go diagramami sekwencji, aktywności lub innymi widokami odpowiednimi do dokumentowanych szczegółów.