JIRA CORE – proseguiamo la prova su strada

In questo post andremo a proseguire la prova su strada. Passiamo a visionare l’installazione web.

Dove eravamo rimasti

Eravamo rimasti alla pagina iniziale della installazione web, come mostrato nella seguente immagine:

A questo punto, possiamo scegliere due possibili opzioni:

• La prima consiste nel lasciare al setup di fare tutto, fornendo solo alcuni semplici parametri e le indicazioni per staccare la licenza.
• La seconda consiste nel installare manualmente (opzione che andremo a scegliere 🙂 )

Il motivo della scelta è che in questo post voglio spiegare alcuni punti e, se lasciamo l’installazione fare tutto, allora non riesco a mostrarle 😀

Una piccola precisazione

Prima di procedere, abbiamo installato il driver MySQL sul JIRA al termine della installazione.Prima di procedere si è reso necessario un riavvio del servizio. Tutte le istruzioni sono presenti in questa pagina della documentazione di JIRA. Occorre riportare nella <JIRA_HOME>/libs il driver.

Una volta installato, per eseguire il restart del servizio, collegandosi come root, eseguire i comandi stop-jira.sh e start-jira.sh presenti nella <JIRA_HOME>/bin. Se non viene fatto, il driver non sarà disponibile.

Quindi procedere con la creazione del database vero e proprio, usando i seguenti comandi:

• CREATE USER ‘<USERNAME>’@'<JIRA_SERVER_HOSTNAME>’ IDENTIFIED BY ‘<PASSWORD>’;
• CREATE DATABASE jiradb CHARACTER SET utf8 COLLATE utf8_bin;
• GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,INDEX on <JIRADB>.* TO ‘<USERNAME>’@'<JIRA_SERVER_HOSTNAME>’ IDENTIFIED BY ‘<PASSWORD>’;
  flush privileges;

come potete vedere nella pagina che ho indicato prima :-).

Proseguiamo

Andiamo quindi avanti con il setup. Il primo passo che viene richiesto è quello di scegliere il database. Come abbiamo già scritto, scegliamo MySQL e forniamo tutti i parametri per la connessione.

La pagina ci consente di poter eseguire il test di configurazione, verificando se abbiamo inserito tutti i parametri corretti. Quindi procediamo con la fase di installazione, dove sarà creata l’intera struttura di tutte le tabelle. Questa operazione richiede del tempo. Lasciamo che lavori senza alcuna fretta e attendiamo che si concluda :-).

Al termine, ci sarà proposta la fase successiva, come mostrato dalla figura successiva:

Son richiesti i seguenti parametri:

• Il titolo del JIRA CORE: viene richiesto che titolo mostrare quando accediamo al nostro JIRA;
• Modalità di accesso:
  • Pubblico: Gli utenti si possono registrare in autonomia
  • Privato: Solo gli amministratori possono creare nuovi utenti
• Definire la Base Url. Si tratta della URL di base che sarà utilizzata per la gestione del nostro JIRA.

Nella fase successiva viene richiesta la Licence Key. Possiamo, in automagico, ricavarla usando il link generate a JIRA Trial licence, come mostrato dalla figura successiva:

che ci reindirizza al portale my.atlassian.com:

attraverso il quale ricavare subito, sfruttando le nostre credenziali, la licenza di uso:

e quindi riportarla subita nel nostro server e procedere nelle ultime fasi di installazione.

Si passa quindi alla generazione della utenza di amministrazione, molto importante. Si tratta di una utenza attraverso la quale riusciremo ad eseguire l’amministrazione dell’intero JIRA. Come mostrato dalla seguente immagine:

specifichiamo tutti i parametri e andiamo a generare la nostra utenza.

Viene quindi chiesto di specificare un avatar. Questo rimarca molto l’aspetto social di JIRA e dei prodotti Atlassian. Come potete vedere, viene specificato l’avatar dell’utente del portale my.atlassian.com.

Quindi, viene richiesto di settare i parametri per gestire la notifica delle email.

Come possiamo vedere dalla immagine, vediamo che viene suggerito di eseguire dopo questa operazione. Suggerisco di eseguirla in una fase successiva. Quindi passiamo a settare il linguaggio che sarà utilizzato su JIRA, come mostrato nella seguente immagine.

Eseguita tale selezione, l’installazione è formalmente terminata e si passa ad una fase di quick tour del prodotto, dove sono spiegate alcune informazioni. Salteremo queste e procederemo oltre.

Fatto ciò, possiamo subito iniziare. Dato che si tratta della prima installazione, viene proposto di creare il primo progetto. Anche in questo caso, possiamo eseguire l’operazione in una fase successiva, come mostrato nella seguente immagine:

Fatto ciò, abbiamo la nostra installazione di JIRA. La Dashboard viene proposta e possiamo iniziare nelle fasi successive:

Conclusioni

Terminiamo qui questo post, chiudendo l’installazione. Proseguiremo nel prossimo post con la prova su strada, verificando le funzionalità, confrontandole con le precedenti versioni e cercando di capire come si comporta questa nuova versione 7 🙂

Un primo lavoro dell’artigiano

In questo post è adesso disponibile un primo lavoro dell’artigiano. Si tratta della traduzione italiana del libro Guide to Asset Management di Dan Radigan e di Dan Horsfall.

Il libro è reperibile al seguente link nella versione originale in inglese. In questo post metto a disposizione la versione italiana, dove gli autori spiegano come sia possibile utilizzare JIRA e JIRA Service Desk per realizzare un Asset Management.

Troverete la traduzione qui. AssetDOC-IT.

Una piccola precisazione

Appartengo alla razza umana e non sono perfetto. Di conseguenza, segnalatemi tutti gli errori, anche di battitura, che trovate. Sarà mia cura correggere la traduzione e metterla nuovamente a disposizione.

Prova su strada

In questo post andremo a vedere la prova dell’addon descritto in questo post. Questo post sarà propedeutico per un altro, completamente dedicato ad una migrazione vera e propria.

Installiamo

La prima operazione è sempre l’installazione. Guardiamo sempre come viene eseguita, per tenere sempre a mente tutte le operazioni che sono eseguite.

Selezioniamo una licenza Trial e procediamo :-). La prima operazione è quella di download

La barra di avanzamento ci avvisa sulle operazioni in corso

Quindi si procede con la fase di installazione.

Al termine della installazione, come sempre, si deve procedere al rilascio della licenza Trial. Basta fornire le credenziali e abbiamo il rilascio della licenza.

Si comunica con il sito della Atlassian e….

… la licenza è pronta.

Test Test Test Test Test

Procediamo con la nostra prova. La prima cosa da fare è sempre controllare la configurazione. Deve diventare una abitudine, un modo di procedere semplice che ci aiuta sempre ogni giorno.

Nel nostro caso caso, non abbiamo alcuna sezione di configurazione. Questo lo rende molto più semplice.

Passiamo quindi subito all’utilizzo, andando subito al sodo. Per poter usare il tutto, ci posizioniamo sulla schermata delle Issue, come indicato nella figura successiva:

Se andiamo a vedere le opzioni Export (si intende il menù Export in alto, a fianco di Share e Tools.

Le opzioni che sono messe a disposizione sono le seguenti:

• Estrazione commenti, in formato Excel
• Estrazione transazioni, in formato Excel
• Estrazione di TUTTO, in formato CVS.

Possiamo sia eseguire l’estrazione di tutto che del singolo al momento evidenziato.

Applico il tutto ad un progetto di test, che ho utilizzato quando ho trattato l’addon MapIt. I risultati sono i seguenti:

Su Transazioni e su Commenti trovate gli esempi, mentre su ALL trovate l’esempio (in formato Excel) di quanto esportato.

Come si può osservare, quello che otteniamo è un file che possiamo poi usare per i nostri scopi. In aggiunta possiamo anche … importare :-). Vediamo come reperire l’informazione.

Ma prima, alcune considerazioni prima di procedere:

• Non cerchiamo di importare due volte lo stesso CSV. Ricordarsi sempre che gli ID non possono essere duplicati e, come conseguenza, prestare massima attenzione.
• Includere i campi sopra elencati, per evitare gli errori in fase di importazione.

Come indicato nella immagine precedente, possiamo sfruttare la funzione standard JIRA CSV file import wizard, per eseguire l’importazione. Questo perché l’addon mette a disposizione un formato completamente compatibile con la funzionalità standard.

Seguendo sempre le indicazioni della documentazione.

Conclusioni

Abbiamo visto quali funzionalità offre questo addon. Possiamo fare tantissime cose interessanti. Nei prossimi post andremo a sfruttare questa funzionalità per arrivare a realizzare una migrazione verso JIRA 7.

Precisazioni

Per eseguire il test, ho utilizzato JIRA versione 6.3.11#6341. Di conseguenza potremmo avere delle schermate video che potrebbero risultare strane. Semplicemente si tratta di una versione un più vecchia :-), che mi serve anche per dei test di migrazione.

Estendiamo il JQL

In questo post andremo a dare una occhiata su alcuni Addon per JIRA, per capire come possiamo estendere le funzionalità di JQL.

JQL Tricks Plugin

Si tratta di un addon a pagamento, disponibile per le installazioni server, (al momento in cui viene redatto il post), che estende JQL con nuove funzioni di ricerca, che ci aiutano notevolmente.

Abbiamo la possibilità di poter restringere/autorizzare l’uso di tali funzioni in base ai gruppi di appartenenza degli utenti o in base ai progetti.

In questo modo si possono avere funzioni opportune solo per determinati progetti.

Craftware Search Attachments for JIRA

Si tratta di un addon a pagamento, disponibile per le installazioni server, (al momento in cui viene redatto il post), che estende JQL dando la possibilità di poter eseguire delle ricerche del testo contenuto negli allegati alla Issue, sul nome degli allegati o sul tipo.

Un apposito motore si preoccupa di indicizzare gli allegati, in modo da poter facilitare la ricerca

permettendo di poter eseguire le ricerche in maniera opportuna

Craftware Search Linked Issues for JIRA

Questo addon, gratuito (al momento in cui viene scritto il post), consente di poter estendere la ricerca permettendo di identificare i subtask in maniera molto più agevole.

L’addon consente di poter impostare delle condizioni in modo da meglio rintracciare le issue che ci interessano

permettendo di poter identificare le issue che bloccano altre issue particolari.

Conclusioni

Abbiamo visto un insieme di addon il cui obbiettivo è quello di etsendere JQL al fine di aiutarci. Abbiamo visto come tali strumenti ci possono aiutare nella vita lavorativa, per migliorare le ricerche. Nei prossimi post andremo ad esaminarli in dettaglio.

Reference

Articolo del blog di Atlassian

Product Requirements

In questo post andremo ad esaminare come Confluence ci può aiutare nella redazione di product requirements, basandoci sull’articolo del blog ufficiale di Confluence

Andiamo al sodo

Sfruttiamo le funzionalità che Confluence ci mette a disposizione :-). Per realizzare il tutto abbiamo a disposizione opportuni template che ci aiutano nel creare questi contenuti particolari. Semplicemente andiamo a selezionare il template del Product Requirements e andiamo a costruire la nostra pagina.

Seguiamo l’autocomposizioni, cui la Atlassian ci ha abituati in tutti questi anni.

Come possiamo vedere, ci vengono fornite tutte le indicazioni del caso. Non possiamo sbagliare 🙂

Quindi selezioniamo Create. Il risultato è il seguente

A questo punto compiliamo i vari campi e lasciamo libera la nostra fantasia, andando a scrivere tutte le informazioni che servono  :-).

Che altro possiamo fare?

Ovviamente questo è il solo punto di partenza. Confluence ci mette a disposizione tutta una serie di strumenti che permettono di poter personalizzare in base a tutte le esigenze. Possiamo infatti costruire dei template ad hoc, espressamente dedicati per determinati Product Requirements, oppure avere delle diversificazioni in base ai progetti o alle tipologie di progetti. Oppure possiamo sfruttare altre caratteristiche, di cui abbiamo più che ampiamente parlato, quale il Yoikee Creator, Mind Mapping 🙂

In questo Confluence ci aiuta in questa operazione. Possiamo aggiungere altri addon, come descritto in altri post, per poter estendere le funzionalità e aiutarci nel nostro lavoro.

Ripeto il consiglio: Lasciate che il vostro unico limite sia la fantasia :-D.

Conclusioni

Abbiamo visto un ulteriore esempio di come Confluence si dimostra uno strumento eccezionale, sempre rispondente alle nostre esigenze e con caratteristiche superiori.

Reference

• Articolo del blog

JQL – Esempi di uso

Vediamo in questo post alcuni esempi di uso del JQL, ovvero del JIRA Query Language. Si tratta di alcuni esempi di utilizzo che possono aiutare nella vita di tutti i giorni 🙂

Andiamo al dunque

Dopo aver presentato il JQL, vediamo dove è possibile utilizzarlo per svolgere il nostro lavoro.

Confluence

Su Confluence abbiamo diverse possibilità di utilizzo. Abbiamo già mostrato alcuni di essi proprio nella gestione degli Asset Management, dove abbiamo anche collegato alle pagine dell’asset le Issue di riferimento attraverso una apposita macro: JIRA; come mostrato in figura:

Quindi, sfruttiamo il JQL per andare a selezionare le Issue o la Issue che ci interessa.

Come possiamo vedere, esaminando l’ultima immagine, quello che notiamo è che andiamo a selezionare le issue semplicemente andando a comporre la nostra query JQL in maniera opportuna. Quindi, senza fare alcuna fatica, settiamo le proprietà e le informazioni che vogliamo vedere, in modo quasi istantaneo 🙂

JIRA

Su JIRA semplicemente andiamo ad accedere alla sezione delle Issue, dove andiamo ad impostare sia i filtri che ad eseguire tutte le interrogazioni che ci servono.

Una volta identificati i filtri che servono, possiamo semplicemente andare a salvare le query come dei filtri. Semplicemente selezioniamo il tasto Save as posto in alto (vedi precedente figura):

Una volta salvato, possiamo referenziare il filtro semplicemente dalla toolbar laterale:

Conclusioni

Abbiamo  visto alcuni esempi di applicazione di JQL. Nei prossimi post andremo a vedere come possiamo estenderlo in maniera opportuna.

Altro esempio di uso

In questo post andremo ad esaminare quanto descritto nel post del blog ufficiale della Atlassian, cercando di spiegarlo meglio e di fornire quanti più dettagli possibili.

Procediamo….

Andiamo ad esaminare una funzionalità di Confluence, che ci consente di interfacciarci a JIRA, in modo da poter andare a leggere le informazioni delle issue, relative ad un rilascio, e pubblicare il risultato su di una pagina , che raccoglierà tutte queste informazioni.

Andiamo a selezionare dal tasto:

e selezioniamo il template JIRA report.

quindi selezioniamo Change log:

A questo punto, attendiamo che l’autocomposizione di Confluence vada a leggere le informazioni dei progetti JIRA e ci chieda quali parametri passare:

Possiamo andare a imputare i parametri sfruttando la modalità semplice della autocomposizione, oppure, come mostrato nella seguente figura:

possiamo impostare una opportuna query JQL, che ci consente di poter andare a selezionare le issue che ci servono :-). Il risultato è la seguente pagina:

Possiamo identificare le seguenti sezioni:

• Page properties, dove andiamo ad inserire dei metadati che possono risultare utili nel caso di report o recupero delle informazioni;
• Riassunto, dove riportiamo un riassunto delle informazioni;
• Punti chiave del rilascio, dove riportiamo che cosa si è voluto rilasciare
• JIRA Issue, dove è riportato l’elenco delle JIRA ISSUE coinvolte.

Come si vede, abbiamo a disposizione un semplice template che ci consente, attraverso l’uso di pochi passi e delle macro di connessione ai dati JIRA, di poter reperire le varie informazioni, in modo semplice e veloce.

Conclusioni

Abbiamo visto fino a qui delle indicazioni su come realizzare una Release Notes. Una cosa vorrei far notare: Questo funziona anche se non si tratta di un software, ma del rilascio di una nuova macchina, che presenta dei miglioramenti rispetto alla precedente edizione. Analogo discorso per un manuale. Ricordate quindi che quanto dico si può tranquillamente applicare anche ai progetti ed alle realtà NON IT, non di informatica :-).

Reference

• Articolo del Blog della Atlassian.

JQL aka JIRA Query Language

In questo post andiamo ad esaminare questo semplice linguaggio, che consente di poter eseguire delle interrogazioni sulle ISSUE JIRA, come se si trattasse di usare una sintassi simile-SQL.

Che cosa è?

La prima cosa che facciamo è rispondere ad una semplice domanda: Che cosa è JQL? Come indicato nel titolo, JQL sta per JIRA Query Languahge ed è un linguaggio simil-sql che la Atlassian mette a disposizione per ricercare issue su JIRA.

JQL è stato studiato per TUTTI. Non è inteso come uno strumento per pochi, ma per tutti coloro che ne abbisognano. Consente di poter cercare facilmente ed agevolmente le Issue che interessano o abbisognamo.

Possiamo agevolmente accedervi dal menù: ISSUE -> Search for issue come mostrato in figura.

Viene quindi proposta la form JIRA per le ricerche:

Dalla precedente immagine già abbiamo una prima indicazione di come si scrivono queste simil-sql query. In particolare:

Semplicemente andiamo a scrivere delle sequenze di:

• Campo
• operatore
• valore

JIRA ci aiuta con dei suggerimenti (vedi immagine precedente), fornendo dei suggerimenti nella composizione della query JQL. Se torniamo all’esempio della precedente immagine, notiamo che stiamo interrogando JIRA per capire quali sono le issue che risultano NON RISOLTE, ovvero resolution = Unresolved, ordinate per priorita ed aggiornamento.

Notiamo anche che JIRA stesso ci indica se lq query JQL è corretta o meno

aggiungendo una icona che indica se OK o meno. Il risultato è sicuramente ottimo.

Grande risultato, ma possiamo esportare i dati?

Certo che si. La risposta è positiva. Una volta che abbiamo selezionato le informazioni che ci interessano, le issue che vogliamo, possiamo esportarle su Excel :-).

Attraverso l’apposito menù Export, visualizziamo le possibili alternative. Possiamo esportare tutte le informazioni che vogliamo. In questo modo possiamo eseguire ulteriori indagini sulle informazioni presenti in JIRA 🙂

Conclusioni

Abbiamo iniziato a scoprire questa piccola perla. Si tratta di una funzionalità che consente di poter reperire issue da JIRA, in base alle nostre esigenze.

Reference

• Manuale tecnico di JQL
• Articolo del blog ufficiale Atlassian

Organizziamo una roadmap

In questo post andremo ad esaminare come poter realizzare una roadmap sfruttando le potenzialità di Confluence. Riprendiamo quanto riportato nel post ufficiale della Atlassian e proviamo a sviluppare l’argomento.

Procediamo

Andiamo subito al dunque. L’obbiettivo è quello di sfruttare le funzioni, di cui dispone Confluence. La prima cosa da fare è quella di avere subito chiari i seguenti punti:

• Identifichiamo i punti cardini della nostra roadmap
• Inseriamo tutte le informazioni nelle pagine, organizzandole nel modo opportuno
• indirizziamo le persone verso le informazioni che le riguardano.

Possiamo iniziare a riassumere il tutto attraverso la seguente pagina:

Andiamo ad esaminarla ;-), analizzandola in ogni singolo punto.

Come prima cosa vediamo che le informazioni sono organizzate in due colonne, consentendo una migliore organizzazione della pagina. Un suggerimento che sempre  ai vari utenti, è di fare un sapiente uso delle sezioni. Dalla versione 4 di Confluence, l’editor mette a disposizione la possibilità di poter organizzare varie sezioni già in colonne. A loro volta, è possibile aggiungere ulteriori sezioni (con il tempo e l’avanzare delle versioni, Confluence si è notevolmente evoluto 🙂 ):

In questa pagina notiamo anche l’uso del componente standard Userprofile, che abbiamo ampiamente usato e spiegato in vari post  e della Roadmap, anche questa ampiamente spiegato :-). Infine, abbiamo le Page Properties, che ci aiutano tantissimo.

La prima cosa che notiamo è che in questa pagina riusciamo a riassumere tantissime informazioni.  Abbiamo subito le indicazioni del gruppo di lavoro (lo Userprofile è uno strumento molto versatile 😉 ) ed anche il piano di battaglia relativo al lavoro da svolgere.

Questa è una delle pagine principali del progetto, dove abbiamo la prima impressione. E’ una buona abitudine creare sempre una pagina principale che dia subito le informazioni principali. Poi da li, occorre inserire tutti i riferimenti alle altre informazioni.

L’uso della macro Status è utilissimo per arrivare ad identificare uno stato dello sviluppo, di un documento, di una procedura collegata o di qualsiasi altra indicazione relativa al progetto. Già in altri post, quali ad esempio dove abbiamo spiegato come realizzare una scheda contribuente.

Aggiungiamo anche l’uso dei task,  che aiutano nella gestione dei compiti e, sfruttando la parte di messaggistica, consentono una rapida interazione con i vari membri del gruppo, anche se le persone sono distanti km e km.

Conclusioni

Abbiamo visto un esempio di come Confluence sia un valid strumento per aiutarci nel lavoro di tutti i giorni. Da evidenziare è il fatto che, nonostante sia nato per gli informatici, questo strumento ci aiuta notevolmente anche per progetti NON informatici.

Reference

• Articolo del Blog Atlassian

News news news

Questo post è dedicato alle ultime novità dell’Addon ConfiForms per Confluence. Avevamo già parlato di questo addon nel post, dove avevamo descritto come aggiungere delle Form a Confluence.

Andiamo in dettaglio

Vediamo nel dettaglio quali sono le novità che annunciano dalla Vertuna :-).

• Gestione di più di 35 tipi di campi custom. Questo sicuramente aiuta nella gestione di form abbastanza complesse e consente di poter meglio configurare le form 
• Console di amministrazione potenziata 
• Gestione di form Master/Detail e filtri dinamici 
• Gestione di Tabbed form 
• Gestione di Conditional Fields
• CalendarView, che consente di mostrare i dati della form in un Calendario 
• Integrazione con JIRA: Possibilità di poter creare delle JIRA ISSUE 🙂
• Inviare email e notifiche via confiForms ed usare delle form per creare delle pagine
• e tanto altro ancora

Conclusioni

Abbiamo visto solo la punta di un iceberg. Nei prossimi post andremo a testare sul campo le potenzialità di queste nuove features.