Meet O Matic Installazione & Manuale di Utilizzo Autori: Matteo Maggioni Luca Mantovani Matricola: 721923 721014 1
Indice 1 Requisiti di installazione 4 2 Installazione 4 3 Manuale di utilizzo 4 3.1 Registrazione e Login....................... 4 3.2 Operazioni personali....................... 5 3.3 Operazioni sui gruppi....................... 6 3.4 Operazioni sugli utenti...................... 8 4 Note conclusive 8 2
Elenco delle figure 1 Pagina iniziale........................... 5 2 Pannello di controllo....................... 6 3 Dettagli di un gruppo....................... 7 4 Dettagli di un sondaggio..................... 8 5 Pannello di controllo di un gruppo................ 9 3
1 Requisiti di installazione JBoss Application Server 4.2.0 o successivi MySql DBMS Java JDK 1.4 o successivi JDK 5 o successivi (richiesto per l uso degli EJB 3.0) 2 Installazione Creare uno schema chiamato mom nel DBMS usando il seguente comando nella console di MySql: CREATE DATABASE mom;, oppure eseguendo lo script mom.sql. Individuare la cartella nella quale è stato installato JBoss (d ora in avanti verrà usato il riferimento JBOSS HOME). Entrare nella cartella JBOSS HOME/server/default/deploy/ e copiare i file momear.ear. Successivamente è necessario impostare il connettore per il DataBase, aprire il file mom-ds.xml e inserire all interno dei tag <username> e <password> le credenziali di accesso di MySql, salvare il file e copiarlo nella stessa cartella in cui si è copiato momear.ear. Avviare JBoss. L applicazione dovrebbe essere raggiungibile da qualsiasi browser digitando il seguente URL nella barra degli indirizzi: http://jboss.host/momweb/ dove jboss.host è l indirizzo del vostro server JBoss. 3 Manuale di utilizzo 3.1 Registrazione e Login Per poter accedere alle funzionalità di Meet O Matic è necessario registrarsi nel sistema, per poter eseguire questa funzionalità seguire il link Subscribe nella pagina iniziale, riempire tutti i campi della form visualizzata e confermare l operazione. Nota: non è possibile scegliere un username già presente, in casi come questo Meet O Matic notificherà all utente che l operazione dovrà essere rieseguita. A registrazione conclusa correttamente sarà possibile effettuare immediatamente il login. 4
3.2 Operazioni personali Una volta effettuato il login verrà visualizzata la pagina di figura 1. Da qui è possibile creare nuovi gruppi oppure iscriversi o cancellare l iscrizione dai gruppi già presenti. Inoltre nella barra laterale sono indicati gli (eventuali) inviti per la partecipazione ad altri gruppi e le notifiche dei cambiamenti di stato (creazione e terminazione) di tutti i sondaggi appartenenti ai gruppi ai quali si è iscritti avvenuti dall ultimo logout. Le funzioni di ricerca e Logout sono presenti in ogni pagina e dal link Your Control Panel è possibile accedere al pannello di controllo personale, nel quale è presentato il dettaglio delle notifiche e degli inviti e, inoltre, un link che conduce alla funzione di cambio profilo, nel caso si volessero cambiare le informazioni personali. Nota: non è possibile cambiare username Figura 1: Pagina iniziale 5
Figura 2: Pannello di controllo 3.3 Operazioni sui gruppi Per creare un nuovo gruppo, premere Create a New Group nela barra laterale e riempire i campi della form successivamente generata, alla conferma dell operazione Meet O Matic dovrebbe comunicare l avvenuto inserimento del gruppo nel sistema. Il gruppo appena creato viene elencato sotto i Created Groups nella pagina iniziale. Tutti i creatori di un gruppo possono modificare i dettagli del gruppo da loro creato oppure eliminarlo del tutto. Nota: i creatori dei gruppi sono automaticamente VIP per quei gruppi Per vedere i dettagli del gruppo premere [Enter], verrà visualizzata una pagina simile a quella presentata in figura 3. All interno di questa pagina è possibile creare un nuovo sondaggio, attraverso la pressione del link Create a New Agreement posizionato nella barra laterale, successivamente riempire i campi richiesti nella form generata e confermare l operazione. Il sondaggio appena generato verrà elencato nella pagina dei dettagli del gruppo a cui appartiene, per visualizzare i dettagli del sondaggio premere il link [open]. 6
Figura 3: Dettagli di un gruppo Nota: tutti gli utenti possono eliminare, modificare o fermare i sondaggi da loro creati, i proprietari di un gruppo hanno gli stessi privilegi anche per i sondaggi non creati da loro appartenenti al proprio gruppo Nella pagina dei sondaggi, di cui si presenta un esempio in figura 4, è possibile vedere i risultati (eventualmente) finali dei voti e (se il sondaggio non è ancora terminato e non si è ancora votato) è possibile esprimere la propria preferenze, selezionando una delle due alternative proposte e confermando l operazione. Meet O Matic presenterà immediatamente la situazione aggiornata del sondaggio nella stessa pagina. Nota: il valore del voto degli utenti VIP è doppio 7
Figura 4: Dettagli di un sondaggio 3.4 Operazioni sugli utenti Meet O Matic mette a disposizione ai creatori dei gruppi una serie di funzioni per gestire gli utenti iscritti e non al loro gruppo. Per accedere a queste funzionalità premere il link Group Panel nella barra laterale della pagina dei dettagli di un gruppo, vedi figura 5. Nota: il link citato è presente solo se si è creatori del gruppo In questa pagina è possibile vedere l elenco dei gruppi iscritti per categoria (utenti VIP, normali e bannati) ed è possibile modificare lo status di ciascuno di loro premendo i link corrispondenti. 4 Note conclusive Il presente documento è stato realizzato per il corso di Ingegneria del Software 2 tenuto dalla Prof.ssa Di Nitto durante l AA 2007/2008 da: 8
Figura 5: Pannello di controllo di un gruppo Matteo Maggioni (matteomaggioni@tiscali.it) Luca Mantovani (lukus2@msn.com) Per la sua realizzazione sono stati utilizzati i seguenti software: L A TEX per la stesura del documento 9