Prova su strada dell’addon

In questo post andremo a provare Colamatech Workflow, già presentato nel post precedente.

Installiamo l’addon

Procediamo con l’installazione dell’addon, come siamo sempre abituati e con estrema facilità. Accettiamo la EULA della Comalatech, come mostrato nella seguente figura:

quindi si procede con il download dell’addon.

Al termine del download, viene eseguita l’installazione.

Si passa quindi alla registrazione della licenza. In questo caso abbiamo scelto la licenza trial per testare il prodotto.

Una volta rilasciata la licenza, l’addon è pronto per poter essere utilizzato 🙂

A questo punto, possiamo vedere che cosa l’addon mette a disposizione :-). Possiamo andare nella sezione degli addon, selezionare il nostro e, una volta che la sezione viene aperta, selezionare il tasto configure, procedendo con la configurazione dello stesso.

Configurazione

Possiamo osservare che, nella sezione delle General Configuration, abbiamo una nuova sezione disponibile, come mostrato in figura:

dove possiamo accedere alle varie opzioni che l’addon mette a disposizione. Se selezioniamo la Configuration, come indicato in precedenza, siamo rediretti nella sezione delle configurazioni dell’addon:

Nelle varie configurazioni, possiamo stabilire chi può fare cosa, a livello generale. Possiamo stabilire, ad esempio:

• Chi può creare/importare dei Workflow
• In quali Space creare i Workflow (tutti o specifici)
• Chi vede le attività del Workflow. In questo caso possiamo scegliere se gli amministratori dello Space + i Page Editors oppure tutti gli utenti
• Il comportamento degli stati delle page
• Sezione sperimentale: Abbiamo anche delle features sperimentali, che sono presenti e che possiamo attivare/disattivare.

Workflow preinstallati

Al momento della prima installazione, abbiamo a disposizione tre Workflow preinstallati

Questo aiuta sicuramente tutti gli utenti che, la prima volta, iniziano ad avvicinarsi a questo addon. Possiamo anche vedere la struttura di questi Workflow, in quanto possiamo anche editarli in maniera grafica:

oppure possiamo anche editarli attraverso un opportuno linguaggio di markup

dove fondamentalmente andiamo a impostare tutti i possibili passaggi di stato che una pagina può … subire.

Proviamo il Workflow

A questo punto, selezioniamo uno dei tre workflow e proviamo ad usarlo nel nostro ambiente di test, andando a capire come si comporta e che risultati abbiamo.

Creiamo uno Space ad hoc, dove andremo a fare tutti i nostri test

Notiamo che, proprio in alto a destra, abbiamo le indicazioni del Workflow:

Al momento non abbiamo ancora aggiunto alcun Workflow. Procediamo con l’aggiunta 🙂

aggiungiamo proprio il Workflow Simple Approval. Al momento in cui eseguiamo il tutto, viene chiesto in quale stato deve essere assegnato alle pagine preesistenti allo space. Nel nostro esempio, impostiamo che tutte le pagine risultino già approvate, come mostrato nella figura successiva

Adesso proviamo a modificare una pagina. Per questo ci affidiamo ad un utente di test ed usiamo un altro browser per l’operazione, per cercare di ricostruire il tutto.

Come mostrato dalla figura precedente, adesso lo stato della pagina è stato modificato. In aggiunta, il revisore che deve approvare la pagina, viene avvisato in diversi modi:

• Abbiamo un messaggio che ci avvisa che la pagina è stata editata da un altro utente. Questo perché eravamo ancora posizionati sulla pagina;
• Il sistema di messaggistica di Confluence è attivo (notiamo in alto a destra che abbiamo un messaggio)
• Anche l’icona dell’addon presenta un messaggio

Se selezioniamo l’icona dell’addon, abbiamo il seguente risultato:

Abbiamo la possibilità di poter operare queste azioni:

• assegnare l’operazione ad altro utente, come mostrato in figura: In questo modo, sempre sfruttando il sistema di messaggistica di Confluence (e le relative email), l’utente assegnatario sarà avvisato.
• Approvare/Rigettare il documento. In questo modo possiamo mutare lo stato del documento. Nel secondo browser, abbiamo questo messaggio: 

Conclusioni

Abbiamo visto un semplice esempio di utilizzo di questo addon, ma abbiamo mostrato solo una piccolissima parte delle sue funzionalità. Nei prossimi post, vedremo anche come poterlo calare in determinate realtà o come poter realizzare dei Workflow ad hoc per determinate situazioni.

https://marketplace.atlassian.com/plugins/com.comalatech.workflow

Diagrammi in Confluence – Alternative

In questo post andremo ad esaminare quali alternative esistono, su Confluence, per poter realizzare dei diagrammi, completando quanto discusso nei seguenti post:

• Gliffy
• Graphviz

Draw.io

Si tratta di un addon, basato su mxGraph che consente di poter realizzare diagrammi e grafici in maniera molto semplice.

Dalle immagini vediamo che consente di poter realizzare dei grafici molto belli e chiari.

L’organigramma non sarà più un problema :-), come mostrato in figura.

Nulla da invidiare a nessuno degli altri addon al momento visti.

Conclusioni

Abbiamo una valida alternativa, da quanto si vede, a dei prezzi molto più bassi rispetto agli altri addon presentati. Nel prossimo post andremo a vedere la prova su strada, cui siamo abituati, per capire vantaggi/svantaggi, pro e contro nell’uso di questo addon.

Reference

• AtlassianMarket Draw.io

Introduciamo FishEye

In questo post andiamo a completare la panoramica dei prodotti Atlassian. Introduciamo FishEye e vediamo come possiamo usarlo per la gestione dei progetti .

Dove introduciamo FishEye?

Fisheye viene introdotto come interfaccia verso il sistema di controllo versione (SVN, Bitbucket, CVS, Mercurial, etc etc etc). L’obbiettivo è quello di avere a disposizione un sistema che, come già indicato in questi posts, aiuti nella gestione del codice.

Grazie alla perfetta integrazione con i prodotti della suite, FishEye consente di poter rintracciare tutte le operazioni che sono riferite ad una determinata Issue JIRA e di arrivare a completare il controllo indicando, sempre tramite JIRA, dove l’intervento è stato eseguito.

Come si può vedere, nella sezione Source abbiamo l’indicazione esatta, reperita proprio tramite FishEye, di dove si è intervenuti nel codice.

I vantaggi sono notevoli. Ve li lascio immaginare: Abbiamo il controllo completo del codice, degli interventi e possiamo rintracciare dove sono stati eseguiti.

In aggiunta possiamo anche operare la Code Review, come già indicato in precedente post, e arrivare a migliorare notevolmente il codice. In questo, Crucible, componente oramai agganciata a FishEye, ci aiuta senza grandi difficoltà.

Conclusioni

Abbiamo fatto una carrellata abbastanza vasta dei vari prodotti della Atlassian, ad eccezione di Bamboo. Questo ultimo, al momento, non viene trattato su questo blog. Spero entro la fine dell’anno di poter iniziare a trattare anche questo splendido prodotto e di poter completare l’analisi e la presentazione di TUTTI i prodotti della Atlassian.

Addons per Cloud

In questo post iniziamo ad analizzare come realizzare un addon per i prodotti Atlassian su Cloud. Parleremo di Atlassian Connect.

Due parole prima di iniziare

Lo sviluppo su Atlassian Connect non può essere fatto allo stesso modo degli addon per installazione Server. Essendo un sistema configurato in maniera differente, deve ragionare in maniera differente. Già in questo post, avevo indicato quali sono le differenze tra i Server e Cloud. Queste differenze si riflettono anche nello sviluppo degli addon per la versione Cloud.

Occorre tenere presente che, fondamentalmente, l’addon per Cloud è una webapp a se stante che si interfaccia con la componente Cloud, sfruttando le chiamate REST e controllandone le risposte che restiruisce.

Che cosa è Atlassian Connect?

Connect è un framework che la Atlassian mette a disposizione per mettere in comunicazione gli Addons, che come indicato in precedenza sono delle web application, con Confluence e JIRA Cloud.

Come indicato nel seguente diagramma, presente nella documentazione Atlassian:

l’addon si interfaccia con l’istanza cloud Atlassian. L’utente finale non vede alcuna differenza: non si deve preoccupare di dover modificare alcuna configurazione: Sarà il Confluence o il JIRA di turno a richiamare la web application e a comunicare con essa.

Come sarà organizzata?

L’addon sarà costruito secondo opportuni criteri e deve essere impostata in modo da riportare delle informazioni (in particolare, determinati contenuti) nella UI dei prodotti Atlassian, in modo da poter richiamare le funzionalità della web application.

L’addon dovrà poi comunicare con i prodotti Atlassian attraverso le chiamate REST e attendere/rispondere a Webhooks.

Conclusioni

Come precedentemente esposto, la realizzazione di addon per Cloud richiede un differente approccio rispetto agli addon per le versioni Server. Nei prossimi post andremo a vedere il classico Hello World .

Reference

La manualistica può essere reperita qui

Esempio di uso

In questo post andremo ad esaminare un addon, forse non molto considerati, ma che può sicuramente risultare utile nel proprio lavoro di tutti i giorni.

A cosa serve?

Questo addon consente di poter copiare una pagina, e la relativa alberatura sottostante, da uno space ad un’altro, specificando lo space dove andare a copiare, come mostrato nella figura precedente.

L’addon mette a disposizione la possibilità di poter modificare i nomi delle nuove pagine copiate e di poter eseguire delle operazioni di renaming/aggiunta prefissi e suffissi agli attachments. Viene anche data la possibilità di poter copiare o meno gli attachments stessi 🙂

UN agevole LOG consente di poter visionare l’avanzamento della operazione di copia, mettendo a disposizione uno strumento agevole.

Che utilizzi possiamo avere?

Questa è sicuramente la domanda più importante. Per quale motivo possiamo utilizzare questo addon?

Schede Clienti

Un primo utilizzo che mi viene in mente potrebbe essere quello di utilizzarlo come sistema per creare delle alberature standard nel nostro Confluence Cloud. Se abbiamo la necessità di disporre, anche su space differenti, di una particolare alberatura di pagine, che sia sempre la medesima, questo sistema è sicuramente il più semplice.

Un esempio banale, potrebbe essere quello di creare delle schede clienti. Potremmo avere necessità di una alberatura standard, dove andare a posizionare le varie informazioni del cliente, e con questo sistema, basta disporre di uno Space che contenga il template, ed il gioco è fatto. 🙂

Template standard

Nel caso in cui il semplice Template non sia sufficiente ai nostri obbiettivi, ovvero abbiamo la necessità di disporre di template di pagine standard per gestire i vari meeting, analisi, documentazione, etc. Questo può essere realizzato sia su installazioni Server che su installazioni Cloud.

Conclusioni

Anche se a prima vista gli addon non sembrano svolgere chissà quale funzione, consiglio vivamente di far correre la fantasia. Vedrete che i vari addon possono sopperire a necessità inaspettate, arrivando a sorprendere sempre 🙂

Ultime news

In questo post, proseguiamo quanto iniziato nei post dedicati agli addon della Kanoah.

• Presentazione
• Test su strada – 1
• Test su strada – 2

Andiamo in dettaglio

Il 2 luglio 2015 è stata rilasciata la versione 1.2.0 dell’addon Kanoah Tests. Di seguito riportiamo le ultime novità:

Possibilità di poter aggiungere dei campi custom nei Test Cases e nei Test Plans

Viene data la possibilità di poter aggiungere campi custom ai Test Cases ed ai Test Plans. Questo consente di poter aggiungere informazioni supplementari che prima non era possibile gestire. Nel caso di situazioni che richiedono informazioni ad hoc, possiamo aggiungere nuove informazioni 🙂

Validazione di campi custom

Viene offerta la possibilità di poter eseguire una validazione dei campi custom, proprio in base ai campi stessi.

Aggiornare i Test Cases massivamente

Viene offerta la possibilità di poter selezionare più Test Cases al fine di poterli aggiornare massivamente.

Conclusioni

Si tratta di migliorie operative, che sicuramente aiuteranno gli operatori nell’espletare il proprio lavoro nelle sessioni di test.

Reference

Maggiori dettagli sono reperibili qui

Workflow su Confluence

In questo post andremo ad introdurre un concetto di Workflow su Confluence.

Che cosa è un Workflow?

Come prima cosa, cerchiamo di dare una definizione di Workflow Per fare ciò, consiglio questo link, dove ho trovato una bella definizione di workflow e consiglio anche la pagina di wikipedia (in inglese, ma la consiglio).

Fondamentalmente, andando al sodo, un Workflow è il flusso di lavoro che deve essere eseguito per svolgere una determinata operazione, in ambito di un business.

Come si può introdurre il concetto di workflow su Confluence?

Spieghiamo in che modo possiamo calare questo concetto su Confluence 🙂

In ambito wiki, si ha la necessità di un Workflow quando si devono pubblicare delle pagine in cui, per evidenti motivi, le informazioni devono essere prima vagliate/approvate da un responsabile che deve accertare che tutte le informazioni presenti siano corrette.

Basti pensare ad un sistema in cui ogni pagina wiki presenta delle informazioni finanziarie di una società. Se questa pagina è visionata da un numero molto elevato di utenti, la pubblicazione di una informazione errata potrebbe scatenare problemi non indifferenti.

Quindi, in situazioni come questa, dove se viene eseguita una pubblicazione senza controllo esiste un grosso rischio, trova la sua naturale applicazione un Workflow.

Come possiamo applicare un Workflow in Confluence?

In Confluence abbiamo a disposizione un Addon che consente di poter aggiungere un Workflow su Confluence. SI tratta del Comala Workflow.

Questo addon consente di poter assegnare uno stato specifico alle pagine di uno space. In aggiunta, possiamo assegnare un Workflow specifico ad ogni singolo space.

Possiamo assegnare task specifici ad un singolo utente, come mostrato nella precedente figura. Questi riceverà una opportuna segnalazione, in modo da poter poi procedere con le operazioni richieste.

Opportune macro consentono di poter creare delle pagine, in cui riassumere gli stati assunti dalle pagine

Nei prossimi post andremo a collaudare questo addon per saggiarne le potenzialità e limiti.

Alternative?

Come prima cosa, l’addon indicato è disponibile solo per installazioni Server, mentre non è affatto disponibile per Cloud. Quindi, sorge spontanea la domanda: Esistono delle alternative?

La risposta è si, e sarà oggetto di un post dedicato esclusivamente a questo punto.

L’idea è la seguente e si basa sull’uso di funzionalità standard.

Come prima cosa, occorre disporre di due space:

• Space Pubblicato, ovvero lo space effettivamente disponibile al pubblico utenti
• Space privato, clone dello space pubblicato, dove gli autori eseguono le correzioni/modifiche/aggiunte.

Come seconda cosa, possiamo associare degli stati agli space basandoci sulle Page properties, descritte in questo mio post, e usate anche in tanti altri esempi 🙂

Come seconda cosa, utilizziamo i Tasks di Confluence, per assegnare i compiti alle persone e mandare loro delle segnalazioni, un pò come avviene con l’addon, ma facendo uso solo delle funzionalità standard.

In questo modo, ed usando un pò di organizzazione, gli utenti lavorano nello space privato, a meno di correzioni del tipo:

• errori di battitura;
• correzioni dell’ultimo minuto, etc

cambiando stato (nelle page properties) ed impostando i task su di una opportuna pagina di uno space di lavoro.

Conclusioni

Abbiamo a disposizione degli strumenti opportuni per poter impostare un Workflow su Confluence, sia come addon specifici, sia come unione di funzionalità standard che, alla fine dei giochi, possono metterci a disposizione un Workflow molto primordiale ma, nel contempo, semplice e funzionale. Questi argomenti saranno approfonditi su altri post.

Prova su strada

In questo post andremo a verificare il funzionamento di questo addon. Facciamo seguito al post pubblicato in precedenza.

Installazione

L’installazione, come sempre molto semplice, non ci preoccupa più di tanto. Una volta rintracciato l’addon, procediamo

Una volta accettata la EULA, possiamo procedere con il download

Terminato quest’ultimo, si procede con l’installazione

Quindi si procede con la richiesta della licenza (come sempre TRIAL)

Inseriti i dati dell’account atlassian, viene generata in automatico la licenza

quindi, se non ci sono stati intoppi, l’addon risulta disponibile.

Al termine della installazione, ci potrebbe essere richiesto di eseguire una operazione di reindex. Questo può capitare quando si installa un nuovo addon che potrebbe prevedere la generazione di nuovi campi custom. In questo caso, consiglio sempre di eseguire questa operazione di reindex subito. L’operazione è safe e normalmente non prevede alcuna controindicazione :-). Dalla immagine sottostante si vede che JIRA stesso richiede di eseguire tale operazione e fornisce il link diretto.

Selezionare l’opzione di Backgroud re-index e dopo pochi istanti l’operazione è conclusa.

Primi passi

A questo punto possiamo procede con l’utilizzo dell’addon stesso. Il primo passo è la generazione di un progetto XRAY Test Project, come mostrato in figura:

Una volta selezionato il progetto evidenziato, viene indicato quale tipologia di issue avremo a disposizione

Come indicato nel post di presentazione, i test sono gestiti sfruttando le ISSUE di JIRA. Proseguendo, assegniamo il nome al nuovo progetto:

Una volta confermato, il progetto viene generato e nella schermata di Overview di progetto.

Gestiamo un TEST

A questo punto, per creare un TEST, semplicemente creiamo una nuova ISSUE, di tipo Test, come mostrato in figura:

Inseriamo un pò di informazioni, per creare il nostro test

Dalla figura precedente, osserviamo che possiamo descrivere in ogni singola componente tutti i vari step che compongono il test, definendo ogni singolo passo che deve essere eseguito al fine di verificare la funzionalità oggetto del test. Possiamo associarlo ad una Test Sets, ovvero ad un insieme di test (lo possiamo definire anche in questa fase)

e possiamo anche eseguire il link alle issue JIRA del progetto

A questo punto a issue è pronta ed usabile per il nostro test. Vediamo adesso come procedere.

Creiamo il nostro Test Sets di lavoro

e quindi creiamo il nostro Test Execution

Procediamo quindi alla esecuzione del test. Spostiamoci nel dettaglio del Test Execution creato in precedenza. Quindi inseriamo i dati di quando iniziamo ad eseguire il test

quindi andiamo nella sezione Tests ed aggiungiamone uno nuovo, o il Test Sets o il Test creato in precedenza.

Supponiamo di aggiungere il nuovo test XRAY-1

A questo punto sarà visualizzata la sezione dedicata alla esecuzione del test.

e possiamo procedere con il test, o attraverso il menù cog, a fianco della colonna status, che compare non appena il mouse si porta proprio li sopra:

dove possiamo lanciare l’esecuzione del test oppure possiamo direttamente settare il risultato del test.

Fatto ciò, abbiamo concluso l’esecuzione del test e possiamo chiudere il task. Una volta selezionato il risultato del test, dalla interfaccia principale del progetto di test, possiamo visualizzare i risultati dei vari test, come mostrat in figura.

Conclusioni

Abbiamo a disposizione un addon molto semplice, che possiamo usare senza grandi problemi o addestramenti particolari. Questo è sicuramente un vantaggio: chiunque disponga di un addestramento su JIRA, può tranquillamente impostare i vari TASK ed usarli senza problemi :-).

In aggiunta, ma non meno importante, il costo molto contenuto, lo rende un addon appetibile  🙂

Prova su strada

In questo post andiamo a provare questo addon, che consente di poter generare degli space in base a template, verificando come poter creare dei template per gli space, come descritto in questi posts.

Installiamo ed usiamo

Procediamo con l’installazione solita dell’addon.

Una volta accettata la EULA, procediamo con il download dell’addon, come siamo sempre stati abituati dalla Atlassian.

Eseguito il download, si procede con l’installazione

Quindi procediamo con la licenza (in questo caso TRIAL):

Fornite le credenziali del nostro account, viene creata la licenza trial:

Quindi, se non si sono verificati dei problemi, l’addon è pronto all’uso.

Passiamo all’utilizzo

Una volta installato e licenziato, l’addon è immediatamente usabile. Basta semplicemente creare un nuovo space e ci accorgiamo subito della sua presenza:

Dalla immagine sopra riportata, notiamo subito la presenza di Mind Map Space, che attiva il nostro addon :-). Se lo selezioniamo, possiamo vedere subito quali scelte ci permette:

Possiamo creare (come mostrato dalla figura sopra riportata):

• New Product (public)
• New Project (public) 
• New Marketing Campaign (public)
• Se abbiamo i nostri template, questi sono visualizzati di seguito. Nella immagine sopra riportata, abbiamo un esempio, in quanto abbiamo creato un template di prova (che abbiamo chiamato Home Page (public)) e che abbiamo importato da file.

Le prime tre voci ci consentono di creare un template partendo da uno schema predefinito. Se li selezioniamo, accediamo alla interfaccia che si occupa della generazione del template, come mostrato nella figura successiva:

L’interfaccia che viene messa a disposizione è semplice e consente di poter … disegnare il template indicando quali saranno le pagine principali dello Space. Fondamentalmente viene creata l’ossatura del nuovo space. :-). Nella immagine seguente è mostrato il menù principale di questo editor di template. Questo mette a disposizione delle funzioni importantissimi, non ultima il link diretto alla documentazione dell’addon.

Possiamo esportare/importare il template, verificare le configurazioni. Abbiamo anche un menù di tasto destro del mouse, che si attiva se selezioniamo un elemento del template, come mostrato in figura.

che non è affatto male avere. In questo modo possiamo creare tutti i template che vogliamo, senza grossi problemi. Non sono infatti presenti particolari configurazioni o altre indicazioni particolari. Quindi non sono necessari skill ad hoc per gestire il tutto.

Limitazioni e suggerimenti

Analizzando l’addon, quello che si vede è che: chiunque può creare uno space, può creare il proprio template usufruendo dell’addon. Non sarebbe male che le versioni successive potessero implementare una limitazione sulla creazione di un nuovo space. Questo per evitare che, nella peggiore delle ipotesi, ci sia un proliferare di space oltre un certo limite. Quello che si può suggerire, in questo caso, è che nelle Global Permission sia organizzato in maniera tale da poter che gli utenti generici non possano creare degli space. In questo modo si evita che ci sia una proliferazione di template.

Conclusioni

Abbiamo a disposizione un addon veramente importante, di semplice utilizzo e che ci mette a disposizione la possibilità di poter impostare un template di space in maniera semplice e veloce. Possiamo creare degli space su misura per le nostre esigenze e possiamo anche pensare di organizzare il nostro Confluence in maniera standard, al fine di avere le informazioni… al loro posto. 🙂

Gestiamo i test con JIRA

In questo post andremo ad esaminare un nuovo addon, che può estendere JIRA in modo da poter gestire dei TEST. Vediamo una alternativa a questi addon.

Vediamo le caratteristiche

Questo addon estende le funzionalità di JIRA e consente di poter gestire i test.

In particolare:

• Crea i test come issue JIRA. Questo facilità l’approccio per tutti coloro che sono abituati alla gestione delle issue JIRA;
• Aiuta nella definizione dei passi del test stesso e nella definizione dei risultati aspettati.
• Consente di inserire le informazioni su quali argomenti sono coperti dai test, quali requireents e defects
• Precondizioni e informazioni associate al test
• Consente di poter raggruppare i test
• Aiuta nella gestione ,assegnazione, guida passo passo e verifica dei progressi del test

In aggiunta, reportistica e grafici sono a disposizione di chi deve gestire il tutto

Conclusioni

Da una prima analisi, l’addon sembra molto semplice e di rapido apprendimento. Sembra integrarsi molto bene con le caratteristiche e le funzionalità di JIRA ed i costi sono molto contenuti. Nei prossimi post andremo a eseguire la classica…. prova si strada.

Riferimenti

• Atlassianmarket
• Articolo (in Portoghese Brasiliano) che parla dell’addon.
• http://www.youtube.com/watch?v=w_9-Un6moGk