Organizzare un LOG Diary

In questo post, andremo a vedere come organizzare un LOG Diary con Confluence, in maniera molto semplice e pratica.

Procediamo

Per la realizzazione, andiamo a sfruttare il componente BLOG di Confluence. Vediamo come 🙂

Dato che per ogni space è possibile creare un blog, il mio consiglio è il seguente:

• Se si tratta delle proprie attività, consiglio di sfruttare i Personal Space, che Confluence mette a disposizione;
• Se si tratta di attività specifiche, cui più persone possono mettere mano, allora conviene dedicare uno space dedicato, in cui raccogliere tutte le informazioni del progetto/attività.

A questo punto, una volta scelto dove posizionare il BLOG, si procede come segue. Per ogni giornata di lavoro, si genera un BLOG post, in cui andare a segnare tutto ciò che è accaduto, le attività svolte, risultato di riunioni, etc etc etc. In particolare, TUTTO 🙂

Per facilitare il tutto, conviene applicare lo stesso template a tutti i post :-), come il seguente esempio:

dove abbiamo una organizzazione molto più schematica e di semplice lettura. Infatti:

• Riassunto delle attività della giornata, consente di poter avere un quadro completo delle attività svolte, senza grossi problemi e di facile lettura. Riusciamo ad avere il quadro delle ore lavorate, dove abbiamo lavorato, senza entrare nel dettaglio. In questo caso non ci serve il dettaglio.
• Task definiti nella giornata, raccoglie tutti i task che si sono generati, a seguito di altri lavori svolti nella giornata e che devono essere svolti nei prossimi giorni. A tale proposito, ci aiuta la funzione dei task che Confluence ci mette a disposizione. 
• Nella ultima sezione, abbiamo l’esplicitazione del dettaglio delle attività vere e proprie, che sono state svolte. Qui trova posto il dettaglio di tutto, ovvero delle segnalazioni ricevute, dei task eseguiti, delle attività programmate, riunioni, link ad altre pagine, istruzioni, risoluzioni a problemi riscontrati, etc etc.

Che cosa abbiamo quindi?

Quello che otteniamo, una volta compilato, è una situazione in cui abbiamo il riassunto delle operazioni. Sfruttando le potenzialità e le funzionalità stesse di Confluence (in particolare la riocerca), abbiamo la possibilità di rintracciare facilmente i fatti di una specifica giornata, rintracciare un fatto specifico, una soluzione applicata. Il vantaggio non è indifferente.

Riassumendo:

• facilità di compilazione di consuntivi ore
• situazione sotto controllo SEMPRE
• dettaglio di attività
• tracciatura di fatti
• etc etc etc 🙂

Conclusioni

Abbiamo visto un sistema semplice per eseguire una tracciatura delle attività in Confluence, sfruttando delle funzionalità standard (sia su versione server che su versione cloud) e verificando come poter ottenere un grande vantaggio,  anche se per il momento, per la funzionalità BLOG, non esiste la possibilità di poter impostare dei template, come riportato un un mio precedente post, anche se la Atlassian sta lavorando su questa funzionalità, segnalando il crescente interesse da parte degli utilizzatori di Confluence. Attendiamo i prossimi rilasci.

Ultime novità

In questo post andremo a riassumere alcune delle ultime novità per Confluence e JIRA, con qualche piccola puntatina sugli altri prodotti della Atlassian 🙂

Confluence

Su Confluence segnaliamo l’aggiornamento della macro Roadmap, di cui abbiamo già parlato. Adesso viene data la possibilità di poter visualizzare le roadmap in settimane o mesi.

Altro aggiornamento, che riguarda un post su cui abbiamo approfondito un addon molto interessante, riguarda il “ricordare” l’ultima selezione del checkbox notify.

Per chi dispone della versione Cloud, questi aggiornamenti sono disponibili dal 10 di maggio 2015.

Altra segnalazione riguarda la possibilità di poter eseguire delle “query” ad hoc su Confluence, attraverso il CQL, sulle page properties o sulle Label. La macro è stata estesa in modo da poter eseguire delle interrogazioni molto più mirate ed in maniera assai più semplice, come mostrato in figura.

I metadati delle pagine Confluence sono stati …. spostati ed adesso sono visibili in cima alle pagine stesse.

Queste ultime modifiche saranno disponibili dopo gli aggiornamenti del 17 maggio 2015.

JIRA

Su JIRA sono state riportate le seguenti migliorie 🙂

La Basic Search di JIRA è stata estesa in modo da consentire l’interrogazione per lo SPRINT FIELD

Segnaliamo anche il seguente gadget per realizzare il seguente grafico bidimensionale

Conclusioni

Abbiamo visto alcune novità. Nei prossimi post andremo ad approfondirne alcune 🙂

Inseriamo dei grafici

In questo post andremo a vedere come inserire dei grafici su di una pagina di Confluence Cloud. Non si tratta della macro chart, che Confluence mette a disposizione, ma di grafici creati su dati esterni.

Di cosa abbiamo bisogno

Non sono necessarie molte componenti. Cerchiamo di riassumerle 🙂

• Confluence Cloud
• CYO Create-Your-Own addon per Confluence Cloud
• Google Charts
• Google Spreadsheet

Confluence sarà il nostro contenitore, che fungerà da punto centrale di tutte le informazioni. CYO, addon già esaminato in diverse altre occasioni, dove ne abbiamo saggiato la potenza, ci consente di poter fare da tramite per poter aggiungere i grafici su Confluence.

Google Spreadsheet sarà la nostra sorgente dati, mentre useremo Google Charts per poter creare i grafici :-).

Procediamo

Come prima cosa, impostiamo i dati su di un google spreadsheet. Nel nostro esempio inseriamo i dati dei rifornimento di benzina che ho sostenuto da gennaio 2015 in avanti.

Una volta impostato il google spreadsheet, possiamo inserirlo sulla pagina, come già spiegato su questo post, ma adesso possiamo anche fare in maniera tale di poter generare dei grafici :-P. Andiamo ad esaminare come.

Sempre attraverso lo stesso sistema utilizzato, possiamo aggiungere anche un grafico, sfruttando le potenzialità che Google Charts mette a disposizione.

Semplicemente andiamo ad aggiungere il codice javascript per poter richiamare le API di google, eseguendo una banale query sullo spreadsheet precedentemente impostato.

La query che si imposta si basa sulle colonne del foglio elettronico (colonne che sono nominate da A, B, C, … Z, etc.). Fare riferimento al link per maggiori dettagli.

Basandosi sull’esempio indicato sopra, la query ha la seguente struttura

select B, sum(C) where C>0 group by B

ovvero cerchiamo di identificare i consumi per mese :-P.

Una volta impostata la macro nella pagina confluence, come mostrato in figura

Il risultato che otteniamo è il seguente:

Conclusioni

Abbiamo visto come collegare dei grafici, interfacciando le API che google mette a disposizione degli utenti, e utilizzando gli spreadsheet come fonte dati. Nei prossimi post, cercheremo di approfondire l’argomento, cercando di portare ulteriori novità 🙂

Gliffy – Esempio di uso

In questo post andremo a completare quanto indicato in questo post , esaminando un esempio di uso di Gliffy.

Iniziamo

Dopo aver installato l’addon, attraverso l’agevole e semplice procedura di installazione, come mostrato nella figura sottostante:

ed alla conferma della installazione (in questo caso ho installato Gliffy, su di un Atlassian Confluence Cloud, in versione trial):

Procediamo con la fase di configurazione 🙂

Il pannello di configurazione è molto semplice e richiede solo alcuni parametri.

Nella sezione di configurazione ed amministrazione distinguiamo le seguenti sezioni:

• Versione e informazioni sull’addon
• Numero di diagrammi
• parametro autosave
• Protocolli consentiti (http, https, etc)
• possibilità di disabilitare toolbar del viewer etc

Inseriamo i grafi

Procediamo ad inserire un semplice grafo in una pagina, dove andremo a spiegare un semplice algoritmo. Al momento cose molto semplici. Partiamo da una nuova pagina ed inseriamo un diagramma, come mostrato in figura

Richiamiamo la macro che l’addon Gliffy mette a disposizione:

Scegliamo di creare un Flow Chart, che descrive un flusso molto banale. Ai fini di questo articolo non interessa impostare un flusso arzigogolato :-P.  Una volta selezionato la tipologia di grafo, possiamo disegnarlo.

L’editor che viene messo a disposizione è molto semplice, intuitivo e non richiede un training particolare per poter essere usato. Dopo aver disegnato il flow chart, lo andiamo a posizionare nella pagina Confluence.

Il risultato finale è il seguente 🙂

Risultato

Abbiamo inserito un grafico nella nostra pagina Confluence senza grandi problemi ed agevolmente. Come sappiamo, un grafico è sempre molto più esplicativo di una descrizione a parole. Ma non solo 😛

Possiamo anche agganciare dei link a pagine di Confluence :-). Rientrando nell’editor del grafo, selezioniamo l’elemento, a cui vogliamo agganciare il link, come mostrato in figura:

Fatto ciò, sarà visualizzata l’autocomposizione, simile a quella presente in Confluence e a cui siamo molto abituati, che ci consente di poter impostare la pagina Confluence da collegare.

Il risultato sarà il seguente:

Il risultato nella pagina Confluence è il seguente:

Conclusioni

Abbiamo visto un addon molto importante, disponibile sia per le versioni Cloud che per le versioni Server, che consente di completare le pagine di Confluence con diagrammi e grafici molto semplici ed esplicativi. La possibilità di potrerli usare è sicuramente un vantaggio in quanto aiuta la redazione della documentazione. Come sempre, la fantasia è l’unico limite 🙂

Automation

In questo post andiamo ad esaminare le novità che sono presenti in JIRA Service Desk 2.4. Vi rimando ai precedenti post, dove potete esaminare le potenzialità del prodotto già descritte

Novità

Iniziamo con il dettagliare questa importante novità: Automation . Vediamo di che cosa si tratta.

Fondamentalmente sono stati introdotti dei meccanismi che automatizzano diverse operazioni, che possono essere abbastanza pensanti da ripetere manualmente, e che aiutano a ridurre gli errori ed ad aumentare la produttività.

In aggiunta, è stato aggiunto in indicatore numerico che consente di poter valutare l’importanza della segnalazione, migliorando la produttività ed indirizzando le azioni dove effettivamente serve.

Migliorie minori…

Oltre a quanto già indicato, sono state rilasciate le seguenti migliorie, minori come intervento, ma non meno importanti 🙂

E’ stata migliorata la possibilità di poter impostare il logo della propria azienda.

E’ stato esteso l’uso del Rich Text Editor anche nei commenti, evitando agli agenti di dover ricorrere sempre al wiki markup per poter impostare le risposte

Conclusioni

Abbiamo delle novità molto accattivanti. La possibilità, di poter automatizzare determinate operazioni, è sicuramente importante. Nei prossimi post andremo a saggiare queste novità e cercheremo di capire come si comportano e che limiti presentano.

Reference

Si rimanda al seguente video della Atlassian, per maggiori dettagli.

http://www.youtube.com/watch?v=ryoVNiHt8F8

Maggiori informazioni sulla versione 2.4 sono reperibili qui.

Grafici e diagrammi

In questo post iniziamo ad esaminare  un addon molto importante. Si tratta di Gliffy. Sarà fornita una presentazione dello stesso e in un secondo post, ne vedremo un esempio di uso.

Gliffy, che cosa offre…

Disponibile sia per la versione Server che per la versione Cloud, questo addon per Confluence, consente di poter disegnare, in maniera agevole e semplice :

• diagrammi
• grafici
• grafi
• schemi
• Diagrammi di processo
• organigrammi
• diagrammi UML
• tanto altro ancora  🙂

Il tutto mettendo a disposizione un editor molto semplice e di rapido apprendimento. :-). Tutti i diagrammi sono poi memorizzati come attachments di pagine wiki e sono facilmente reperibili, senza difficoltà alcuna.

Possiamo creare diagrammi di processi in maniera semplice e senza dover ricorrere a strumenti molto complessi, il tutto sempre all’interno di Confluence. Questo da un notevole vantaggio: abbiamo tutto quello che ci serve senza dover installare tanti sottware diversi, avendo un unico repository per le nostre informazioni.

Conclusioni

Gliffy è sicuramente un addon indispensabile per gli utenti di Confluence, non solo per il personale IT, ma anche per tutti coloro che devono ricorrere a diagrammi o che devono creare la documentazione in maniera semplice, senza dover ricorrere a strumentazione esterna. Nel prossimo post, andremo a vedere un esempio di utilizzo di Gliffy, andandone a saggiare le potenzialità ed i limiti.

Reference

Video dimostrativo del prodotto

http://www.youtube.com/watch?v=X2q4vnpkmac

Mockup in Confluence

In questo post, andremo ad esaminare come possiamo impostare dei mockup direttamente su Confluence.

Di cosa abbiamo bisogno?

Ecco la lista delle cose che servono:

• Confluence (cloud o Server)
• l’addon Balsamiq mockup
• molta fantasia 😛

Due parole prima di iniziare

Prima di iniziare, spendiamo due parole per spiegare che cosa è un Mockup. Senza fare tanti giri di parole, un mockup è un disegno, uno schizzo che rappresenta l’interfaccia che avrà il nostro futuro applicativo. L’obbiettivo è di rappresentare, nel modo più fedele possibile, quale sarà il risultato finale. In questo modo si dispone di uno strumento che consente, agli sviluppatori ed analisti, di poter mostrare una sorta di anteprima al cliente di quello che sarà.

Iniziamo

L’addon mette a disposizione delle macro che consentono di poter inserire e disegnare dei disegno creati.

In aggiunta consente, sempre via web, di poter creare il mockup direttamente sotto Confluence.

L’editor che viene messo a disposizione, consente la creazione di disegni in maniera molto agevole 🙂

Conclusioni

Sicuramente uno strumento valido e utile. Indispensabile per le aziende di sviluppo software. Nei prossimi post, vedremo un utilizzo vero e porprio, saggiandone potenzialità e limiti.

Query SQL su Confluence

In questo post andremo ad esaminare un altro addon, dedicato alla esecuzione di query su database esterni, al fine di creare dei report interni a Confluence stesso. Abbiamo già esaminato questo nei seguenti post.

PocketQuery – First look

PocketQuery è un addon gratuito (al momento in cui viene redatto questo post), per Confluence Server, che consente di poter eseguire delle query predefinite su database esterni a Confluence, all’interno delle varie pagine. Attraverso una opportuna macro, come mostrato nella figura precedente, è possibile impostare quale query eseguire ed i relativi parametri.

I dati non sono solo visualizzati in forma tabellare, ma viene data la possibilità di poter realizzare dei grafici :-), sfruttando le potenzialità di Google Chart API.

Che utilizzi sono possibili?

Tra i possibili utilizzi di questo addon, vedo la possibilità di poter realizzare delle Dashboard che mostrano informazioni derivate da query implementate ad hoc. Un esempio potrebbe essere quello di mostrare i log di caricamento di determinate procedure. Un altro esempio potrebbe essere l’andamento delle vendite o qualsiasi altra cosa. La fantasia è il nostro unico limite 😛

Conclusioni

Abbiamo un addon che consente di poter realizzare delle dashboard interattive e consente una discreta funzionalità. Nei prossimi post, proveremo ad usarlo e ne saggeremo limiti e pregi 🙂

Domande & Risposte

Proseguiamo quanto iniziato in questo post su confluence e su Jira. Altre domande e risposte su Confluence 🙂

Quando conviene utilizzare Questions?

Questions è uno strumento molto importante, utile come ho evidenziato in questo post. La risposta alla domanda è : SEMPRE. Il motivo è da ricercarsi nel fatto che questo strumento è molto valido per condividere la conoscenza e l’esperienza in ambito aziendale. In questo modo la conoscenza è distribuita e non si disperde.

E’ un modo per aiutare i colleghi dell’azienda a risolvere problematiche cui non sempre affrontano ma è anche un modo per salvare la propria esperienza e far si che si possa riutilzzare.

Come integriamo Confluence con Google?

Atlassian mette a disposizione gli strumenti per poter eseguire l’integrazione con Google Apps, in maniera semplice e veloce, come ho evidenziato in questo post. In aggiunta esistono una serie di addon che si occupano della integrazione :-). Di alcuni ho già parlato, di altri ne tratterò nei prossimi post 🙂

Come usare HTML su Confluence Cloud?

La Atlassian ha disabilitato di default l’addon per la gestione dell’HTML nelle pagine di Confluence Cloud. Il motivo principale è per garantire la sicurezza. Possiamo però eseguire una integrazione dell’HTML utilizzando l’addon CYO Create-Your-Own, che consente una buona integrazione di pagine HTML esterne. Nel mio post, ho evidenziato come può essere utilizzato per integrare i fogli elettronici di Google.

Conclusioni

Rispondo volentieri ad altre domande che mi sono pervenute. Spero che anche queste possano essere utili per poter svolgere il proprio lavoro su Confluence.

Script in Confluence

In questo post andremo ad esaminare come possiamo estendere le funzionalità di Confluence, attraverso un semplice addon, in modo da creare delle semplici Dashboard che consentano di visualizzare dei dati molto semplici.

Di che cosa abbiamo bisogno?

Quello di cui abbiamo bisogno è:

• Confluence Server
• Scripting for Confluence, ovvero l’addon che rende questo possibile

Quest’ultimo rende possibile l’utilizzo di codice all’interno di pagine Confluence, mettendo a disposizione una serie di Macro che, inserendo opportuno codice, consentono di inserire dei contenuti sulle pagine Confluence.

Diamo una prima occhiata

Le macro consentono di poter inserire diversi tipi di codice. I linguaggi supportati sono i seguenti:

• BeanShell
• Groovy
• Gant
• Jython
• Javascript (Rhino)

che non sono pochi e consentono un ampio spettro di possibilità. Possiamo aggiungere anche interrogazione a DB e arrivare a realizzare una visualizzazione dinamica di dati.

Dalle immagini vediamo che la macro consente di scrivere il codice in maniera semplice e con un discreto Syntax highlighting.

Le macro messe a disposizione, consentono di poter definire diversi parametri, tra le quali:

• Come viene generato l’output: Wiki, html, xhtml;
• Dove si trova lo script. ABbiamo la possibilità di poterlo memorizzare direttamente sul Server e di specificare dei percorsi ben precisi oppure se può essere reperito attraverso una URL ben precisa.
• Viene data la possibilità di poter leggere anche un allegato ad una specifica pagina, come origine del dato.

Conclusioni

Da questa prima occhiata, vediamo che lo strumento è valido. Nei prossimi post vedremo degli esempi di uso di questo addon, in modo da saggiarne meglio potenzialità e limiti.

Reference

Fare riferimento qui per la manualistica dell’addon.