# Module Insights

> Mostra come si distribuiscono i requisiti di un modulo e quanti sono collegati. Un clic su uno spicchio mostra i requisiti che rappresenta.

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

- Disciplina: Reporting e pubblicazione
- Funziona in: Modulo IBM DOORS Next
- Prodotti supportati: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Sola lettura
- Keywords: statistiche di modulo, cruscotto dei requisiti, distribuzione degli attributi, panoramica degli stati, copertura dei link, tracciabilità, metriche, grafici, qualità, reportistica
- Versione: 1.20 (Rilasciata 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. Aprire il modulo → 2. Impostare i grafici, Add chart se serve → 3. Draw charts: legge il modulo e disegna ogni grafico → 4. Clic su un valore per elencarne i requisiti → 5. Grafici in PNG o JPG, valori in Excel

## Che cos'è e perché esiste
Prima di una revisione, di una baseline o di una riunione di avanzamento tornano sempre le stesse domande: quanti requisiti sono ancora in bozza, chi ne è responsabile, quanti hanno una classificazione di sicurezza, quanti non sono ancora collegati a nulla. Le risposte sono nel modulo, ma contarle significa filtrare, scorrere e sommare a mano, oppure costruire un report in uno strumento di reportistica, con il tempo e l'aiuto dell'amministratore che ciò comporta.

Module Insights risponde a queste domande nell'ELM Mini Dashboard, accanto al modulo. Legge il modulo una volta e disegna grafici dei valori di un qualsiasi attributo e della copertura dei link. Ogni spicchio e ogni barra elencano i requisiti corrispondenti. Il widget legge soltanto: in DOORS Next non cambia nulla.

## Problemi che risolve
- Nessuna visione rapida della distribuzione di un modulo: stato, priorità, responsabile, tipo di artefatto, classificazione, date.
- I requisiti senza link emergono tardi, spesso solo durante una revisione o un audit.
- Contare i valori a mano con i filtri è lento e i numeri sono superati il giorno dopo.
- Un report in uno strumento di reportistica va costruito, mantenuto e condiviso prima di rispondere a una domanda semplice.
- Un numero da solo non basta: la domanda è sempre a quali requisiti corrisponde.

## Vantaggi
- **Risposte in pochi secondi:** aprire il modulo, generare i grafici, leggere la distribuzione. Non c'è alcun report da preparare.
- **Qualsiasi attributo:** enumerazioni come stato o priorità, attributi sì/no, date per mese, le persone che hanno creato i requisiti o ne sono responsabili, i tipi di artefatto.
- **Copertura dei link:** quanti requisiti sono collegati per i tipi di link e la direzione scelti e quanti no, volendo suddivisi per tipo di link.
- **Dal grafico ai requisiti:** un clic su uno spicchio o su una barra elenca i requisiti, con il salto nel modulo per uno solo o per l'intero elenco.
- **Pronto per una riunione:** i grafici e tutti i loro numeri vanno in Excel, con i requisiti di ogni valore.
- **Sicuro per tutti:** il widget legge soltanto, quindi chiunque può usarlo in qualsiasi momento, anche in una baseline.

## Come si usa
1. Apri il modulo e guarda i grafici. Ogni grafico è un blocco grigio che dice cosa conta: i valori di un attributo o la copertura dei collegamenti. **Change** apre le sue impostazioni: un **Name** per il grafico, l'attributo oppure i tipi di collegamento e la direzione, un **Artifact type** per contare solo quelli e una **View**: anello, torta, barre, colonne, lecca-lecca o treemap. **Done** le richiude.
2. Fare clic su **Draw charts** in fondo. Il widget salva i grafici in questo browser, legge il modulo una volta e riempie tutti i grafici; una barra di avanzamento mostra il progresso e si può interrompere in qualsiasi momento. Alla prossima apertura del widget i grafici salvati vengono creati subito per il modulo aperto; se nulla è cambiato il riquadro dice **Read again**. **Clear saved charts** li elimina.
3. **Add chart** aggiunge un altro grafico sotto gli altri, fino a sei; la × ne toglie uno. Fare clic su **Draw charts** per leggerlo e disegnarlo.
4. Fare clic su uno spicchio, una barra o una riga della tabella: i requisiti di quel valore compaiono sotto il grafico. Un clic su una riga ne mostra i dettagli con **Show in module** e **Open in DOORS Next**; **Highlight in module** seleziona l'intero elenco.
5. L'icona immagine salva un grafico, o tutti insieme, come immagine PNG o JPG. **Log** salva in Excel ogni valore di ogni grafico, con un foglio per grafico con i requisiti che lo compongono.

## Buono a sapersi
- I requisiti senza valore per l'attributo compaiono come **(empty)**: spesso lo spicchio più interessante.
- Un grafico colora fino a otto valori; quelli più rari confluiscono in **Other**, che si può selezionare come ogni altro spicchio. Il file Excel li elenca uno per uno.
- Se un attributo può avere più valori contemporaneamente, un requisito conta per ciascuno di essi e le percentuali possono superare il 100 %. Il grafico lo segnala.
- La copertura dei link considera collegato un requisito quando ha almeno un link dei tipi e della direzione scelti. I link verso altre applicazioni IBM ELM non vengono contati.
- Se un link sia contrassegnato come sospetto non è disponibile ai widget, quindi Module Insights non lo mostra.
- I grafici non mostrano mai il testo dei requisiti, solo nomi e identificativi, e il widget non modifica nulla: si può usare in uno stream, in un change set o in una baseline.
- I moduli molto grandi si possono analizzare a tappe: interrompere l'esecuzione, ricaricare la pagina e riprendere da dove si era fermata.