Software per la gestione di documenti di progetto, in particolare permette di gestire:
- Requisiti;
- Use Case;
- Attori;
- Fonti;
- Glossario;
- Classi;
- Package;
- Metriche;
- Test.
Per utilizzare PragmaDB è necessario avere installato sulla macchina host (virtuale o fisica che sia):
- PHP: versione > 5.3.10 => questa è stata utilizzata durante il progetto;
- MySQL: versione > 5.1 => necessita del supporto per stored procedure ricorsive.
- Tutti gli elementi che possono appartenere ad una gerarchia (i.e. Requisiti, UseCase, Classi, Package etc.) possiedono un identificativo che viene gestito, modificato e spostato internamente al sistema secondo le indicazioni dell'utente.
- In ogni caso si rimanda al "manuale utente" che consiste in brevi indicazioni su come utilizzare il sistema. Purtroppo, a causa dei tempi stretti in cui è stato sviluppato, non si è riusciti a corredare il codice di una documentazione adeguata, sono presenti alcuni commenti direttamente nel codice.
Prima di caricare i dati di Mysql (tabelle, procedure, funzioni etc.):
- settare correttamente i path assoluti sostituendo la stringa:
<INSERIRE_PATH_ASSOLUTO>
con il path assoluto dell'host.
- modificare tutti i file .sql contenuti nella directory manutenzione in modo che siano specifici per l'utilizzo da parte del vostro team (inserire i valori per la creazione degli utenti, inserire i path etc.).
- creare nel server mysql un database con nome pragmadb associato ad un utente con password.
- Effetuare l'accesso a MySQL con l'utente precedentemente creato.
- selezionare il database precedentemente creato:
use pragmadb;
- invocare:
SOURCE <PATH>/pragmadb/SQL/manutenzione/initializeDB/creator.sql
dove path va sostituito con il path assoluto dell'host che contiene la cartella MySQL.
Sono presenti altri file di manutenzione: alcuni permettono di resettare tutte
le funzioni o le procedure, droppare le tabelle, eseguire dump del database etc.
Ovviamente anche in questo caso vanno settati i vari path e gli eventuali altri valori.
Per connettere php al database è necessario modificare in:
- PHP > Functions > mysql_fun.php
$host="INSERIRE_NOME_HOST";
$user="INSERIRE_NOME_UTENTE_DB";
$pwd="INSERIRE_PASSWD_DB";
$dbname="INSERIRE_NOME_DB";
- PHP > Functions > urlLab.php
settare il path in modo che punti alla directory pragmadb contenente la directory PHP; - L'interfaccia php contiene dei link utili sulla parte destra, sono customizzabili modificando: PHP > Utente > home.php
Alcune sono descritte nel "manuale utente".
Altre vengono brevissimamente menzionate qui:
- È possibile esportare qualsiasi documento direttamente in LaTeX;
- È possibile esportare le tabelle di tracciamento che vengono calcolate internamente al sistema (i.e. tracciamento Requisit-UC, tracciamento TU-Metodi etc.); Per quanto riguarda Classi, Package, Metriche e Test sono semplici da utilizzare quindi non richiedono particolari spiegazioni.
La sezione metriche serve da "cruscotto" in quanto contiene alcune metriche che sono state utilizzate per avere sotto controllo la qualità dell'intero progetto ed in particolare dell'architettura che abbiamo realizzato (qualità ritenute fondamentali perchè il prodotto realizzato potesse essere efficace soddisfacendo quindi i requisiti individuati). Possono essere prese d'esempio ma, in generale, le metriche riguardanti l'architettura vanno ragionate in base alle qualità architetturali specifiche che l'architettura dovrà dimostrare di possedere.
Munari Stefano : parte MySQL
Vedovato Fabio : parte PHP