Roberto Bizzoni
Domenico Cecchini
Paola Tiberi
Ingegneria del
software
Documentazione
software
Pacchetti software testati:
Ø Rational RequisitePro 3.0
Ø Rational SoDA
Ø Rational Rose98
Rational
RequisitePro 3.0
Requisite Pro aiuta i team di sviluppo a identificare,
organizzare e documentare i requisiti utente e le specifiche applicative,
controllandone l'evoluzione. Favorisce il controllo della qualità dei
risultati, permettendo di verificare l'implementazione delle funzionalità e di
seguire l'impatto dei cambiamenti dei requisiti. Questo avviene grazie alla
possibilità di permettere a ciascun team di accedere alle stesse informazioni,
inoltre riduce il rischio di fallimento.
1.
Fusione di documenti
2.
Tracciabilità dei requisiti
3.
Aggiornamento e Sicurezza
4.
Collegamenti con altri tools
5.
Requisiti di sistema
Fusione di documenti
Poiché ha come supporto Word permette la
realizzazione di un progetto versatile. Inoltre permette l’accesso ai dati del
documento attraverso le funzioni di query
e sort, che consentono di consultare
solo le informazioni interessanti.
Tracciabilità
RequisitePro provvede anche alla tracciabilità,
aiutando l’utente ad assicurare la qualità del prodotto attraverso i
collegamenti con i requisiti ad alto livello.
La tracciabilità è mostrata attraverso matrici o
alberi, di volta in volta generati a seconda delle richieste e delle modifiche.
L’utente può creare relazioni di tracciabilità tra
requisiti presenti in differenti progetti.
Questa utilità permette di dividere il progetto in
sottoprogetti e ridurre quindi la complessità totale.
Quando vi è una modifica ad un requisito,
RequisitePro automaticamente marca tutti i requisiti legati ad esso come
“sospetti” dimodoché l’utente può ricontrollare i collegamenti.
Aggiornamento e Sicurezza
RequisitePro mantiene anche la storia dei
cambiamenti per ogni requisito sia per le modifiche inerenti il testo sia per
quelle inerenti ai valori degli attributi.
RequiditePro da agli utenti la possibilità di
proteggere il proprio progetto attraverso una password.
Un'altra funzione supportata è quella di poter
stabilire una gerarchia “Padre/Figlio” tra i requisiti dello stesso tipo.
Questo significa che un singolo requisito può essere decomposto in più
specifici requisiti; la tracciabilità risultante tra Padre e Figlio è stabilita
automaticamente dal programma.
Collegamenti con altri tools
L’integrazione del RequisitePro con il Rational Rose
da la possibilità di assicurare che il software design venga incontro
all’utente, al sistema e ai requisiti del software.
Il programma si integra anche con SQA Suite aiutando
l’utente a lavorare con il testing.
Un progetto standard è composto da tre principali
tipi di files: la documentazione dei requisiti del prodotto (.PRD); specifica
dei requisiti software (.SRS); specifica del testing (.TST).
Ciascun documento contiene il tipo di richiesta
suggerita dal nome.
Requisiti di sistema
-------------------
Windows
95, NT 4.0, or NT 3.51 Service Pack 5
Memoria:
32 Mbytes
Spazio
su HD: 20 Mbytes
Sistema:
PC Pentium 133 o superiore
Software: MS Word v7.0 o superiore. (Office 95 o migliore)
Rational SoDA
Automatizza la produzione della documentazione del
progetto software, evitando l’estrazione manuale di informazione dagli ambienti
di analisi (RequisitePro), progettazione (Rose98) e sviluppo. Consente una
totale flessibilità di impaginazione, grazie a templates personalizzati di word
processors standard di mercato; permette la rigenerazione incrementale del
documento, senza perdere i dati inseriti manualmente. Rappresenta lo strumento
flessibile per automatizzare la documentazione del software.
Con SoDA si può automaticamente creare documenti dai
modelli Rational Rose. Si può attraversare le relazioni semantiche in un
modello Rational Rose, estraendo informazioni grafiche e testuali per creare
documenti personalizzati ai bisogni specifici.
Con SoDA si può anche documentare il vostro codice
sorgente ed estrarre informazioni direttamente dal codice.
La soluzione SoDA/Rational Rose per la documentazione
Si possono creare e manipolare la informazione
dell’analisi e design con Rational Rose. Per documentare questa informazione,
si usa un template SoDA. I templates definiscono la struttura e il formato dei
documenti finali, e la corrispondenza tra le sezioni del documento e gli
elementi nel modello Rational Rose. Si può utilizzare uno dei templates
standard già forniti con SoDA senza modifiche, oppure creare un template nuovo
con l’interfaccia grafica ed intuitiva.
1.
Generazione di documenti
2.
Fusione di documenti
3.
Consistenza dei documenti
4.
Tracciabilità dei requisiti
5.
Configurazioni
6.
Requisiti di sistema
Generazione di documenti
Una volta creato il template, si può utilizzare di
nuovo per qualsiasi modello Rational Rose, semplicemente specificando il modello
che si vuole documentare e dicendo a SoDA di generare la documentazione.
SoDA può generare un documento completo solo dal
modello Rational Rose, oppure un documento con contenitori per informazione
supplementare. Potete incrementare il documento aggiungendo testo, tabelle,
figure, direttamente nel documento con l’editor WYSIWIG di SoDA.
Fusione di documenti
Quando cambia il modello Rational Rose, SoDA può
rigenerare il documento senza perdere l’informazione supplementare che si è
fornita manualmente. Durante questo processo unico, chiamato Intelligent Document Merging,
SoDA confronta il documento esistente con il modello Rational Rose, aggiorna le
sezioni datate, rimuove le sezioni irrilevanti, e inserisce le nuove sezioni -
tutto senza sovrascrivere la informazione supplementare che avete in precedenza
fornito.
Consistenza del documento
Se, mentre si revisiona un documento, si nota un
errore nel modello Rational Rose, si può aprire l’oggetto Rational Rose
direttamente da SoDA, sistemare l’errore in Rational Rose, e rigenerare la
parte del documento influenzato dalla modifica. Se si sta lavorando su un
modello Rational Rose e si vuole vedere il documento corrente, si può aprirlo o
rigenerarlo da Rational Rose.
Tracciabilità dei requisiti
Si possono assegnare requisiti a delle classi e dei
diagrammi di scenari. Dopo, si può automaticamente generare tabelle di
tracciabilità dei requisiti che mostrano quali classi e scenari soddisfano un
requisito particolare e vice versa. SoDA dà controllo sui requisiti aiutando ad
allocarli, revisionarli ed analizzarli.
Il valore di SoDA
Può creare in modo automatico la documentazione del
software.
Piattaforme su cui è disponibile
SoDA per Word: Windows 95, Windows NT 3.5.1/4.0
SoDA for Frame: SunOS, Solaris, AIX, HP-UX, IRIX,
Digital AXP, Windows 95, Windows NT 3.5.1/4.0
Strumenti di publishing
SoDA per Word richiede Word 7 per Windows 95 oppure
Word per NT (32 bits).
Requisiti di sistema
-------------------
Windows
NT 4.0 or Windows 95
Microsoft Word 7.0 (Word 95) o Word 97
Pentium
90 processor (150 consigliato)
24M RAM
(48M consigliati)
20M di
spazio libero su HD
1.
Gli standard
2.
Supporto ai progetti
3.
Linguaggi supportati
4.
Requisiti di sistema
Rational Rose offre flessibilità e scalabilità alle
applicazioni di grandi dimensioni attraverso:
·
un
browser per ispezionare modelli e trovare componenti riutilizzabili
·
generazione
di codice personalizzabile per specifiche librerie di classi e/o linee guida
per la scrittura di codice
·
assicurazione
della consistenza tra i modelli ed il codice in maniera continua
·
collegamenti
OLE per includere diagrammi di Rational Rose in Microsoft Word
·
facile
Integrazione con Rational SQA Suite, RequisitePro, ClearCase, e lo strumento di
documentazione SoDA per supporto totale del ciclo di vita del software
·
supporto
superiore per il Round-Trip Engineering
·
cicli
di sviluppo più brevi
·
costi
di manutenzione più bassi
Standards
Rational Rose fornisce un supporto per le notazioni
standard, incluso lo Unified Modeling Language (UML), considerato come standard
dell’industria del software per la modellazione ad oggetti. L’UML è progettato
per soddisfare i bisogni degli sviluppatori aziendali ed è focalizzato sul
riuso, l’architettura e la estensibilità.
L’UML descrive il linguaggio per la modellazione di
applicazioni con:
·
modellazione
dei casi d’uso
·
modellazione
di oggetti e di classi
·
modellazione
di componenti
·
modellazione
della distribuzione e del deployment.
Rational Rose supporta anche i metodi Booch e OMT.
Supporto ai progetti
Rational Rose supporta l’approccio dello spazio di
lavoro privato/pubblico familiare alla maggior parte degli ingegneri del
software.
Le modifiche si rendono disponibili agli altri
essendo inserite in un sistema di gestione della configurazione e di controllo
delle versioni. Gli altri sviluppatori possono vedere e utilizzare queste
modifiche. Rational Rose si integra con i maggiori strumenti di gestione delle
configurazioni, inclusi i Rational ClearCase, Microsoft SourceSafe, PVCS, SCCS,
and CVS/RCS.
Rational Rose può anche essere utilizzato con
repositories aziendali, come l’Unisys Universal Repository (UREP) ed il
Microsoft Repository.
Linguaggi
supportati
Il supporto ai linguaggi di programmazione
attualmente comprende:
·
Rational
Rose for Visual Basic
·
Rational
Rose/PowerBuilder
·
Rational
Rose/C++
·
Rational
Rose/Forté
·
Rational
Rose/Java Edition
·
Rational
Rose/Smalltalk
·
Rational
Rose/SQLWindows
Piattaforme su
cui è disponibile
Windows 95, Windows NT, Alpha NT, SGI, Solaris, AIX,
Digital UNIX, HP-UX
Requisiti di sistema
---------------------
- Microsoft Windows 95 or NT 4.0
- PC con processore 486 o (Pentium consigliato)
- 16 Mb di RAM (24MB consigliati)
- 85 Mb di spazio libero su HD
- Scheda video SVGA compatibile (256 o più colori
consigliati)
- Dispositivo di puntamento con almeno due tasti
Note, problemi
e suggerimenti
La versione del programma Rose (Rose98 Evaluation
Edition) è incompatibile con la versione di SoDA provata. Durante
l’importazione dei modelli da Rose a sodasi verifica il seguente errore: “illegal Petal version”.
Per risolvere ciò abbiamo verificato che, durante il
salvataggio del modello Rose, venga selezionato il tipo Rose3.0 o Rose4.0.
Probabilmente ci sono problemi di compatibilità
anche tra il RequisitePro 3.0 e il SoDA che abbiamo testato perché quando si
cerca di generare un documento con SoDA a partire da un progetto RequisitePro
si generano generalmente i seguenti errori:
ERRORS ENCOUNTERED GENERATING IN: C:\Programmi\Rational\SoDA25\Tutorial\Reqts.doc
***error:Unable to evaluate connector unexpectedDomainResponse: Cannot to connect to server
Cannot create an instance of class - Project
***error:Unable to evaluate connector unexpectedDomainResponse: Cannot to connect to server
Cannot create an instance of class - Project
***error:Unable to evaluate REPEAT command Project.Requirements contextNotFound: Project
I programmi provati sono delle versioni dimostrative
perciò presentano le seguenti limitazioni:
Ø Rose98: 30 giorni di prova
(…abbiamo risolto il problema).
Ø RequisitePro: 30 giorni di
prova.
Ø SoDA: gli “oggetti” che
possono essere importati da altri tools sono limitati a 5.
Inoltre durante le ricerche abbiamo trovato i
seguenti programmi che potrebbero essere utili per lo sviluppo del progetto:
Ø SQA Suite (Utile per il testing di
sistemi distribuiti su reti)
Ø UMLNice (Tipo Rose98)
Ø WithClass98 (Tipo Rose 98)
Ø UML RTF (Gestioni DB con UML)
Siti visitati:
www.grd-publications.com/art/tni97/