Note tecniche Estensione e aggiunta di nuove funzionalità grafiche a Mango Allegato tecnico Mango-NoteTecniche

Transcript

1 Mango Project An Open Source Web Application for Project Planning and Control Note tecniche Estensione e aggiunta di nuove funzionalità grafiche a Mango Allegato tecnico Mango-NoteTecniche 1 Organizzazione dei sorgenti dei moduli della distribuzione di Mango Nel package di Mango è contenuta una directory modules in cui sono presenti le cartelle relative a ciascun modulo dell applicazione. Per l estensione e aggiunta di nuove funzionalità, è da prendere in considerazione la cartella tasks che contiene i sorgenti necessari per la modifica e la creazione di tutto ciò che riguarda il modulo che si occupa delle attività di un progetto. Ogni modulo ha una classe corrispondente che contiene i metodi necessari per la manipolazione dei suoi oggetti: così un attività può essere vista come un istanza della classe Ctask e su di essa può essere richiamato ad esempio, un metodo per stabilire se è una foglia. 2 Aspetti tecnici generici Per la realizzazione del punto 2.2 b del capitolato d appalto, le dimensioni fisse specificate nell installazione sono contenute in: $dpconfig[ height_project_img ] (altezza dell immagine) e $dpconfig[ width_project_img ] (larghezza dell immagine). La WBS di un attività è generata attraverso la chiamata del metodo statico Ctask::get- WBS($task_id) che dato l identificativo di un attività ($task_id) genera la WBS corrispondente. Non devono essere modificati file esistenti ad eccezione di quelli descritti in questo documento. Il committente su richiesta del fornitore può richiedere l inserimento di ulteriori parametri di sistema a seconda dell analisi dei requisiti ricevuta. 2.1 Aspetti specifici per la realizzazione della componente Gantt I sorgenti relativi alla generazione dei Gantt sono: viewgantt.php, contiene le funzionalità di lettura e manipolazione dei parametri inseriti dall utente nel tab Gantt Chart di View Project. I dati all interno di questo file sono passati poi a gantt.php; gantt.php, contiene le istruzioni necessarie per la generazione del Gantt attraverso l utilizzo della libreria grafica jpgraph. All interno di questi file, devono essere modificati soltanto le istruzioni del codice inerenti la realizzazione dei requisiti contenuti nel capitolato. 2.2 Aspetti specifici per la realizzazione della componente Task Network Si consiglia di prendere come template i file descritti al punto precedente per la generazione della componente Task Network. Nella distribuzione delta è presente il file: Questo documento fa parte del progetto didattico del corso di TP, Università di Firenze, docente G.A. Cignoni: non può essere utilizzato al di fuori di tale contesto.

2 viewcpm.php, che contiene alcune istruzioni necessarie all integrazione in Mango. Deve essere modificato per gestire la lettura e manipolazione dei parametri per la generazione del grafico della Task Network. L identificativo del progetto a cui si riferisce il grafico è contenuto nella variabile $project_id. Tutte le istruzioni contenute in questo file non devono essere modificate previa autorizzazione del committente. 3 Tabelle della BD coinvolte nella realizzazione delle componenti grafiche PROJECTS Nome campo Tipo Descrizione project_id Identificativo del progetto project_group Identificativo del gruppo a cui il progetto appartiene project_name varchar(255) Nome del progetto project_short_name varchar(10) Abbreviazione del nome del progetto project_url varchar(255) Url del progetto project_start_date datetime Data di inizio del progetto project_finish_date datetime Data di fine del progetto project_today datetime Data di modifica del progetto project_status Stato del progetto (in planning, in progress ) project_effort float Impegno stimato per il completamento del progetto project_color_identifier varchar(6) Colore associato al progetto project_description text Descrizione del progetto project_target_budget project_hard_budget decimal(10,2) Budget previsto per il completamento del progetto decimal(10,2) Limite di budget imposto per il completamento del progetto project_creator Identificativo dell utente che ha creato il progetto project_active tinyint(4) Stabilisce se il progetto è attivo o meno project_current varchar(255) Stabilisce se il progetto è stato caricato da una versione passata oppure è quello attuale project_priority tinyint(4) Priorità associata al progetto project_type smallint(6) Tipo del progetto (amministrativo, operativo ) 2/6

3 TASKS task_id Identificativo dell attività task_name varchar(255) Nome dell attività task_parent Identificativo del padre dell attività (se l attività è radice questo campo è uguale al suo id) task_milestone tinyint(1) Specifica se l attività è una milestone task_project Identificativo del progetto a cui l attività si riferisce task_wbs_index varchar(10) Indice della wbs relativo al livello in cui l attività si trova task_start_date datetime Data di inizio dell attività task_today datetime Data di modifica dell attività task_finish_date datetime Data di fine dell attività task_status Stato dell attività (attivo, inattivo ) task_priority tinyint(4) Priorità associata all attività task_description text Descrizione dell attività task_related_url varchar(255) Url dell attività task_creator Identificativo dell utente che ha creato l attività task_access Relativo ai permessi sull attività task_custom longtext Per la personalizzazione delle attività di un progetto task_type smallint(6) Tipo di attività (amministrativa, operativa ) task_model Modello di distribuzione d impegno associato all attività 3/6

4 USERS user_id Identificativo dell utente user_username varchar(255) Username dell utente user_password varchar(32) Password dell utente user_first_name varchar(50) Nome dell utente user_last_name varchar(50) Cognome dell utente user_ varchar(255) dell utente user_phone varchar(30) Telefono di casa dell utente user_mobile varchar(30) Numero di cellulare dell utente user_address1 varchar(30) Primo indirizzo user_address2 varchar(30) Secondo indirizzo user_city varchar(30) Città dell utente user_state varchar(30) Stato civile dell utente (celibe, sposato..) user_zip varchar(11) Cap dell utente user_country varchar(30) Nazione dell utente user_birthday datetime Data di nascita user_day_hours Numero di ore lavorate dall utente nella giornata (valore di default 8) USER_PROJECTS user_id Identificativo dell utente proles_id Identificativo del ruolo di progetto (responsabile, commerciale ) dell utente project_id Identificativo del progetto a cui l utente partecipa 4/6

5 PROJECTS_ROLES proles_id Identificativo del ruolo di progetto (responsabile, commerciale ) proles_name varchar(24) Nome del ruolo di progetto proles_description varchar(255) Descrizione del ruolo di progetto proles_hour_cost Costo orario associato al ruolo di progetto proles_status tinyint(4) Stato del ruolo di progetto (attivo o inattivo) TASK_DEPENDENCIES dependencies_task_id Identificativo dell attività dependencies_task_type_id Identificativo del tipo di dipendenza (attualmente solo le finish to start sono supportate) dependencies_req_task_id Identificativo dell attività con cui è in relazione USER_TASKS user_id Identificativo dell utente proles_id Identificativo del ruolo dell utente nell attività task_id Identificativo dell attività effort float Impegno stimato dell utente nel ricoprire il ruolo assegnato nell attività perc_effort Percentuale d impegno assegnata all utente per ricoprire il ruolo assegnato nell attività 5/6

6 TASK_LOG task_log_id Identificativo del log task_log_task Identificativo del task a cui il log è associato task_log_name varchar(255) Nome del log task_log_description text Descrizione del log task_log_creator Identificativo dell utente che ha creato il log task_log_hours float Numero di ore di lavoro inserite nel log task_log_creation_date datetime Data di creazione del log task_log_edit_date datetime Data di modifica del log task_log_start_date datetime Data di inizio della sessione di lavoro inserita nel log task_log_finish_date datetime Data di fine della sessione di lavoro inserita nel log task_log_proles_id Ruolo ricoperto dall utente nella sessione di lavoro task_log_progress tinyint(4) Percentuale di completamento dell attività a cui il log si riferisce task_log_problem tinyint(1) Segnalazione di un eventuale problema riscontrato nella sessione di lavoro 6/6