\nCome puoi estrarre i tuoi dati e presentarli ai tuoi utenti? In realt\u00e0 Twproject ha varie pagine con funzionalit\u00e0 di filtro dinamico che estraggono dati significativi, ma fino alla versione 5.5 mancava un sistema di report personalizzabile.
\nIn questa versione abbiamo integrato\u00a0Jasper Reports<\/a>, uno dei pi\u00f9 potenti motori di report. Jasper reports aggiunge la possibilit\u00e0 di creare il tuo report in pochi minuti usando un editor grafico.
\nI report sono integrati con la flessibile struttura di sicurezza di Twproject in un modo facile e pratico, senza obbligare gli utenti a scrivere query e regole complesse.<\/p>\n
I report possono essere disegnati facilmente con\u00a0iReport Designer<\/a>, che \u00e8 facile, potente, gratuito e open-source, oppure con\u00a0Jaspersoft Studio<\/a>.<\/p>\n Jasper Studio \u00e8 il prodotto principale ed \u00e8 basato su Eclipse. iReport \u00e8 pi\u00f9 facile da configurare, ma sfortunatamente verr\u00e0 abbandonato presto. Se gi\u00e0 conosci l’interfaccia Eclipse, usa Jasper Studio, altrimenti usa iReport. In realt\u00e0 i passi per la configurazione sono molto simili.<\/p>\n Per i nostri scopi iReport funziona perfettamente.<\/p>\n Una volta che iReport\u00a0 \u00e8 installato il primo passo \u00e8 quello di aggiungere le librerie del database all’editor.<\/p>\n 1)\u00a0 Clicca su tools->options e poi sul tab \u201cclasspath\u201d.<\/p>\n I driver del Database sono inclusi nella distribuzione di Twproject, puoi trovarli qui:<\/span><\/p>\n Clicca sul bottone \u201cAdd jar\u201d e selziona il driver per il database che stai usando.<\/p>\n Quindi dovresti aggiungere anche le classi di Twproject, nel caso dovessimo usare qulache funzione di formattazione.<\/p>\n Clicca su \u201cAdd Folder\u201d e seleziona la cartella [twproject root]\\WEB-INF\\lib\\classes<\/p>\n Una volta fatto siamo pronti per connettere il database di Twproject<\/p>\n 1) clicca su \u201cStep 1: Create database connection\u201d<\/p>\n 3) scegli Database JDBC Connection<\/p>\n 4) scrivi il nome della connessione, \u201cTW5 test\u201d per esempio<\/p>\n 5) seleziona il driver del database giusto:<\/p>\n inserisci i dati di connessione al server, nome del database, utente e password:<\/p>\n 6) fai un test della connessione<\/p>\n Se la connessione \u00e8 corretta, possiamo procedere scrivendo il nostro primo report.<\/p>\n Clica su \u201cStep 2 : create a new report\u201c<\/p>\n Il wizard del report si aprir\u00e0 in pop-up. Ci sono vari template:<\/p>\n Seleziona quello che ti piace di pi\u00f9 e clicca su \u201cLaunch Report Wizard\u201d.<\/p>\n Inserisci il nome del report e la location con attenzione: il nome del report e la location sono informazioni cruciali per l’integrazione tra Twproject e iReport. Leggi la sezione dedicata\u00a0sotto<\/a>.<\/p>\n Clicca \u201cNext\u201d<\/p>\n seleziona la tua fonte di dati appena creata \u201cTW5 test\u201d;ora \u00e8 il momento di pensare alla query.<\/p>\n In questo esempio vorremmo riportare il tempo che ogni risorsa impiega sui loro progetti.<\/p>\n Per scrivere una query, \u00e8 obbligatorio conoscere la struttura dati di Twproject. Anche se i nomi delle tabelle sono abbastanza immediati, suggerisco di dare unosguardo a questa sezione:<\/p>\n https:\/\/twproject.com\/support\/it\/utilizzo-avanzato\/import-export\/struttura-del-database\/<\/a><\/p>\n Se sei un mago di SQL puoi scrivere la tua query direttamente, ma se preferisci qualcosa di pi\u00f9\u00a0 \u201cvisuale\u201d clicca sul bottone \u201cDesign query\u201d:<\/p>\n Trascina le tabelle di cui hai bisogno per la query.<\/p>\n Nel nostro caso le ore lavorative sono nella tabella twk_worklog. I record di worklog sono sempre collegati a un’assegnazione. Le assegnazioni creano relazioni tra risorse e progetto ponderate con un ruolo. Quindi dobbiamo aggiugere \u201ctwk_assignment\u201d, \u201ctsk_task\u201d, \u201ctwk_resource\u201d e \u201colpl_role\u201d. Lo strumento di modifica della query user\u00e0 le sql foreign keys per creare i joins.<\/p>\n Salva la query e clicca su \u201cnext\u201d.<\/p>\n Puoi selezionare i campi che vuoi vedere nel tuo report. Nel nostro caso li aggiungeremo manualmente. Clicca su \u201cnext\u201d<\/p>\n Qui definirai alcuni gruppi, ma questo non \u00e8 obbligatorio, puoi aggiungerli anche dopo.<\/p>\n Clicca su \u201cnext\u201d e poi su \u201cfinish\u201d.<\/p>\n Il tuo \u201cschema\u201d del report \u00e8 quasi pronto:<\/p>\n Si noti che un report ha molte sezioni come \u201cTitolo\u201d, \u201cpage header,\u201d intestazione di due gruppi, dettagli, e un footer.<\/p>\n Se clicchi su \u201cpreview\u201d vedrai qualcosa di bruttino come questo:<\/p>\n Torna sul designer e fai qualche modifica:<\/p>\n Cambia il titolo, usa il nome del progetto e della risorsa invece dell’id<\/p>\n Trascina la data di inserimento del worklog, azione e tempo speso dall’area \u201cfields\u201d sul nostro report nella sezione \u201cdetails\u201d:<\/p>\n Con queste semplici modifiche apparir\u00e0 cos\u00ec:<\/p>\n Un po’ meglio, ma:<\/p>\n Adesso siamo cos\u00ec:<\/p>\n Ora potresti volere somme parziali dei gruppi in header\/footers. Questo pu\u00f2 essere fatto introducendo le variabili.<\/p>\n In questo caso avremo bisogno di una variabile per sommare worklog su un gruppo di progetto , vedi \u201dsumGroup1\u201d:<\/p>\n Trascina la variabile appena creata su \u201cgroup footer 1\u201d e formatta il risultato usando la funzione \u201cgetMillisInHoursMinutes\u201d come sopra:<\/p>\n Puoi giocare con il designer per ottimizzare il tuo report. Quando sei pronto salvalo!<\/p>\n Una volta ottenuto il tuo report puoi lanciarlo dentro iReport, direttamente al database, ma se vuoi integrarlo in Twproject nel modo giusto (e.g.: rispettando la sicurezza) devi conoscere alcuni dettagli in pi\u00f9.<\/p>\n Il report appena creato \u00e8 gi\u00e0 disponibile nel tuo Twproject (se lo hai creato nel posto giusto con un nome univoco\u00a0 Per vedere i report installati vai su Admin \u2013> Customizations \u2013> Forms, plugins and reports.<\/p>\n Nella sezione \u201cAdditional iReports\u201d dovrebbe essere elencato il tuo report. Se non \u00e8 cos\u00ec clicca sul bottone \u201creload plugins\u201d (se ancora non appare c’\u00e8 un problema sul report, vedi i log).<\/p>\n Dovresti gi\u00e0 avere un widget speciale (\u201cReport list\u201d su wp_genericReports.jsp file) installato nel tuo Twproject. Aggiungilo al tuo cruscotto se vuoi accedere al tuo report direttamente da Twproject. Il widget contiene gi\u00e0 i tuoi report se sei amministratore altrimenti sar\u00e0 vuoto fino a che non assegnerai i giusti permessi come descritto di seguito.<\/p>\n Ma chi pu\u00f2 eseguire questi report? Come vengono protetti i report in Twproject?<\/span><\/p>\n I nomi dei report sono usati per generare un permesso che \u00e8 necessario selezionare per concedere l’accesso a un report, questo \u00e8 il kotivo per cui i nomi devono essere significativi e univoci.<\/p>\n Ogni report estende l’implementazione standard basata sui ruoli di Twproject aggiungendo un permesso speciale, one for each report. Questi permessi possono essere assegnati a un ruolo esattamente come quelli standard, sa a livello globale che di progetto.<\/p>\n Ecco l’editor del ruolo esteso con i permessi del report:<\/p>\n Per una discussione approfondita sulla sicurezza di Twproject vedi: https:\/\/twproject.com\/support\/it\/usare-twproject\/sicurezza\/<\/a><\/p>\n Una volta aggiunto un permesso del report a un ruolo, questo report sar\u00e0 visibile agli utenti con quel ruolo.<\/p>\n Detto questo, per integrare JasperReports con Twproject dobbiamo occuparci di sicurezza e visibilit\u00e0 dei dati.<\/p>\n Accedendo al database direttamente dal motore di report pu\u00f2 essere accettabile per alcuni report di \u201calto livello\u201d, ma come sai, il modello di sicurezza di Twproject \u00e8 molto flessibile, permettendo di vedere solo un set consentito di dati per ogni utente. Come pu\u00f2 essere possibile creare un report che rispetti il modello di sicurezza di Twproject senza scrivere query complesse?<\/p>\n Abbiamo lavorato duro per risolvere questo problema e abbiamo trovato una soluzione facile e pratica.<\/p>\n Prima di tutto dividiamo i report in \u201cglobali\u201d e \u201centit\u00e8 correlata\u201d.<\/p>\n I report globali sono i pi\u00f9 flessibili e facili da costruire (come quello appena creato); possono usare tutti i tipi di dati di Twproject: progetto , worklog, risorse o ToDo, senza restrizioni.<\/p>\n I report globali testeranno la sicurezza solo a livello di ruoli globali: nel peggiore dei casi chi pu\u00f2 accedere al report pu\u00f2 leggere i suoi dati (e.g progetti e costi), anche se non ha accesso ai \u201cprogetti\u201d da cui provengono i dati. Come dovresti sapere\u00a0 I report a entit\u00e0 correlate, invece, sono correlati a un’entit\u00e0 principale di Twproject come progetti, risorsa, ToDo e l’accesso \u00e8 testato oggetto per oggetto, singolarmente.<\/p>\n Twproject non pu\u00f2 ispezionare il report e sapere se \u00e8 \u201cglobale\u201d, relativo a progetti, a ToDos e cos\u00ec via; devi istruire Twproject circa i contenuti del report mettendoli in una cartella strutturata come di seguito:<\/p>\n
\nJasperReports<\/a> \u00e8 uno strumento di reporting di\u00a0JasperSoft<\/a> (acquisita recentemente da Tibco) largamente usato dalla comunit\u00e0 java orientata alle imprese.<\/p>\nDriver e classpath<\/h3>\n
![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb.png\" "\\"image\\"")
<\/a><\/p>\n\n
![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb1.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb2.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb3.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb4.png\" "\\"image\\"")
<\/a><\/p>\nCrea il tuo primo report<\/h3>\n
![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb5.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb6.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb12.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb10.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb11.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb13.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb14.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb15.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb16.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb17.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb18.png\" "\\"image\\"")
<\/a><\/p>\n\n
\norg.jblooming.utilities.DateUtilities.getMillisInHoursMinutes($F{twk_worklog_duration}). Questa funzione trasformer\u00e0 millisecondi in a Ore:Minuti<\/li>\n<\/ol>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb19.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb20.png\" "\\"image\\"")
<\/a><\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb21.png\" "\\"image\\"")
<\/a><\/p>\nIntegrazione tra i<\/a>Report e Twproject<\/h3>\n
![\"Smile\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/wlEmoticon-smile.png\")
).<\/p>\n![\"screen977\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/screen977.jpg\")
<\/p>\n
\nVedi\u00a0https:\/\/twproject.com\/support\/it\/utilizzo-avanzato\/personalizzazione\/cruscotto\/<\/a>\u00a0per creare una nuova portlet\/widget<\/p>\n![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb23.png\" "\\"image\\"")
<\/a><\/p>\n![\"screen978\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/screen978.jpg\")
<\/p>\nReport location e sicurezza<\/h3>\n
\nSe il tuo report mostra dati sensibili, concedi l’accesso con attenzione.<\/p>\n\u00a0, la sicurezza di Twproject usa a livello alto il concetto di \u201carea di sicurezza\u201d (vedi qui per dettagli: https:\/\/twproject.com\/support\/it\/usare-twproject\/sicurezza\/aree\/<\/a>). Avere il permesso di vedere \u201creport x\u201d sull’\u201carea 1\u201d non significa che tu possa vedere lo stesso report sull’\u201carea 2\u201d. Per risolvere questo problema, Twproject passa al report la lista delle aree su cui hai i permessi. Puoi usare questa lista per filtrare i dati del report da mostrare, per esempio, solo project\/resources\/ToDos\/worklog da \u201carea 1\u201d e non da \u201carea 2\u201d. Spiegheremo come usare questo parametro di seguito.<\/p>\n
![\"image\"](\"https:\/\/twproject.com\/support\/wp-content\/uploads\/2014\/06\/image_thumb9.png\" "\\"image\\"")
<\/a><\/p>\n