# Module Insights

> Pokazuje od razu, jak rozkładają się wymagania w module i ile z nich jest powiązanych, a z każdego wycinka prowadzi prosto do wymagań, które go tworzą.

Source: https://widgets.doorsnext.com/pl/widgets/module-insights/

- Dyscyplina: Raportowanie i publikacja
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Tylko odczyt
- Keywords: statystyki modułu, przegląd wymagań, rozkład atrybutów, przegląd statusów, pokrycie powiązaniami, identyfikowalność, wskaźniki, wykresy, jakość wymagań, raportowanie
- Wersja: 1.20 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Otwórz moduł → 2. Ustaw wykresy, w razie potrzeby Add chart → 3. Draw charts: odczytuje moduł, rysuje każdy wykres → 4. Kliknij wartość, aby zobaczyć wymagania → 5. Wykresy w PNG lub JPG, wartości w Excelu

## Czym jest i po co powstało
Przed przeglądem, bazą odniesienia albo spotkaniem statusowym zawsze padają te same pytania: ile wymagań jest jeszcze w wersji roboczej, kto za nie odpowiada, ile ma klasyfikację bezpieczeństwa, ile nie jest jeszcze z niczym powiązanych. Odpowiedzi są w module, ale policzenie ich oznacza filtrowanie, przewijanie i dodawanie ręcznie albo zbudowanie raportu w narzędziu raportowym, co zajmuje czas i często wymaga pomocy administratora.

Module Insights odpowiada na te pytania w ELM Mini Dashboard, obok modułu. Czyta moduł raz i rysuje wykresy wartości dowolnego atrybutu oraz pokrycia powiązaniami. Każdy wycinek i każdy słupek wypisuje wymagania, które za nim stoją. Widget tylko czyta; w DOORS Next nic się nie zmienia.

## Jakie problemy rozwiązuje
- Brak szybkiego przeglądu rozkładu w module: status, priorytet, właściciel, typ artefaktu, klasyfikacja, daty.
- Wymagania bez powiązań ujawniają się późno, często dopiero podczas przeglądu lub audytu.
- Ręczne liczenie wartości filtrami jest wolne, a liczby następnego dnia są nieaktualne.
- Raport w narzędziu raportowym trzeba najpierw zbudować, utrzymywać i udostępnić, zanim odpowie na proste pytanie.
- Sama liczba nie wystarcza: pytanie zawsze brzmi, których wymagań dotyczy.

## Korzyści
- **Odpowiedzi w kilka sekund:** otwórz moduł, narysuj wykresy i odczytaj rozkład. Nie trzeba przygotowywać raportu.
- **Dowolny atrybut:** wyliczenia takie jak status czy priorytet, atrybuty tak/nie, daty według miesięcy, osoby, które utworzyły wymagania lub nimi zarządzają, typy artefaktów.
- **Pokrycie powiązaniami:** ile wymagań jest powiązanych dla wybranych typów powiązań i kierunku, a ile nie, opcjonalnie w rozbiciu na typy.
- **Od wykresu do wymagań:** kliknięcie wycinka lub słupka wypisuje wymagania, z przejściem do modułu dla jednego albo dla całej listy.
- **Gotowe na spotkanie:** wykresy i wszystkie liczby trafiają do Excela wraz z wymaganiami dla każdej wartości.
- **Bezpieczne dla każdego:** widget tylko czyta, więc może z niego korzystać każdy i w każdej chwili, także w bazie odniesienia.

## Jak używać
1. Otwórz moduł i zobacz wykresy. Każdy wykres to szary blok, który mówi, co liczy: wartości atrybutu albo pokrycie powiązaniami. **Change** otwiera jego ustawienia: **Name** wykresu, atrybut albo typy powiązań i kierunek, **Artifact type**, jeśli chcesz liczyć tylko ten typ, oraz **View**: pierścień, kołowy, słupki poziome, kolumny, lizak albo mapa drzewa. **Done** zwija je z powrotem.
2. Kliknij **Draw charts** na dole. Widget zapisuje wykresy w tej przeglądarce, czyta moduł raz i wypełnia wszystkie wykresy; pasek postępu pokazuje stan, a przebieg można w każdej chwili zatrzymać. Przy następnym otwarciu widżetu zapisane wykresy budują się od razu dla otwartego modułu; gdy nic się nie zmieniło, kafelek nazywa się **Read again**. **Clear saved charts** usuwa je z przeglądarki.
3. **Add chart** dodaje kolejny wykres pod pozostałymi, maksymalnie sześć; × usuwa wykres. Kliknij **Draw charts**, żeby go odczytać i narysować.
4. Kliknij wycinek, słupek albo wiersz tabeli: wymagania dla tej wartości pojawią się pod wykresem. Kliknięcie wiersza pokazuje szczegóły z **Show in module** i **Open in DOORS Next**; **Highlight in module** zaznacza całą listę.
5. Ikona obrazka zapisuje wykres albo wszystkie wykresy naraz jako obraz PNG lub JPG. **Log** zapisuje do Excela każdą wartość każdego wykresu oraz arkusz na wykres z wymaganiami, które się na nią składają.

## Warto wiedzieć
- Wymagania bez wartości atrybutu pokazują się jako **(empty)**, zwykle najciekawszy wycinek.
- Wykres koloruje do ośmiu wartości; rzadsze trafiają do **Other**, które można kliknąć jak każdy inny wycinek. Plik Excel wymienia je pojedynczo.
- Jeśli atrybut może mieć kilka wartości naraz, wymaganie liczy się przy każdej z nich, więc udziały mogą przekroczyć 100 %. Wykres to sygnalizuje.
- Pokrycie powiązaniami uznaje wymaganie za powiązane, gdy ma co najmniej jedno powiązanie wybranych typów i kierunku. Powiązania do innych aplikacji IBM ELM nie są liczone.
- To, czy powiązanie jest oznaczone jako podejrzane, nie jest dostępne dla widgetów, więc Module Insights tego nie pokazuje.
- Wykresy nigdy nie pokazują treści wymagań, tylko nazwy i identyfikatory, a widget niczego nie zmienia: można go używać w strumieniu, w zestawie zmian i w bazie odniesienia.
- Bardzo duże moduły można przeanalizować etapami: zatrzymaj przebieg, przeładuj stronę i kontynuuj od miejsca, w którym się zatrzymał.