Torniamo alla didattica

In questo post andremo a descrivere un componente che potrebbe sempre risultare molto utile nel nostro lavoro. SI tratta dell’Issue Collector.

Le presentazioni

Cerchiamo, come prima cosa, di andare a descrivere che cosa è.

The issue collector allows you to easily embed a Jira feedback form into your own web site. This form is typically accessed by clicking a ‘trigger’ tab exposed along the edge of pages in your web site.

When used by people visiting your web site click this trigger tab and submit the resulting Jira feedback form, an issue is conveniently created in Jira.

Visitors to your web site do not require a user account in Jira to use the Jira feedback form.

Cerchiamo di dare una spiegazione in Italiano. 🙂

Questa caratteristica di Jira permette di poter integrare una form all’interno di un sito web per gestire il feedback attraverso la generazione di una issue Jira.

Come funziona?

Sfruttiamo nuovamente le GIF, grande potenzialità, per descrivere come costruire il nostro issue collector

Attraverso una semplice autocomposizione, possiamo generare il tutto in maniera molto semplice ed il risultato è un codice da inserire nel nostro sito.

Abbiamo la possibilità di poter integrare il codice sia come HTML che come Javascript.

Una volta creato il tutto?

Possiamo aggiungere il codice nel nostro sito o nelle nostre pagine web. Il risultato è avere i vari feedback su issue Jira e poi … possiamo gestirli come vogliamo.

Ovviamente possiamo disabilitare/rimuovere il tutto quando vogliamo.

Un piccolo riassunto della situazione

In questo post andremo a fare una minianalisi per capire quali possibilità abbiamo per poter inserire delle formule matematiche all’interno delle nostre pagine Confluence.

Quali possibilità?

Lo standard out-of-the-box non permette di poter inserire delle formule matematiche. Normalmente, nello sviluppo software, questo non costituisce una limitazione, dato che non sempre è necessario impostare formule nelle pagine.

Normalmente. Il problema si pone nel caso in cui abbiamo la necessità di dover riportare a formula di un calcolo che viene implementato da un codice e magari questa formula è  necessaria per scrivere il documento di analisi da condividere con cliente/sviluppatore/commerciale/etc.

Esplorando il marketplace Atlassian, vediamo che abbiamo tante Apps che ci permettono di estendere Confluence e disporre di tali funzionalità, sia per Server che per Cloud.

Alcune di queste App si basano sullo standard LaTeX, per scrivere le formule vere e proprie, con dei risultati non indifferenti. Si tratta di uno standard molto usato nelle università (usato anche da me).

Alcuni di questi sono a pagamento ed altri gratuiti e ne abbiamo per tutte le nostre necessità.

Conclusioni

Abbiamo visto come poter reperire facilmente, attraverso il marketplace, Apps che permettono di gestire delle formule matematiche. Nei prossimi post andremo ad esaminarli e testarli, cercando di capire come funzionano e che cosa offrono.

Sulla personalizzazione di PORTAL

In questo post andremo a vedere come possiamo impostare delle personalizzazioni del PORTAL di JIRA Service Desk, affinché possa eseguire delle transazioni di Workflow che preveda delle screen particolari.

Una precisazione ….

Come sappiamo benissimo, possiamo avere delle transazioni di workflow che permettono di visualizzare una screen, al fine di inserire delle informazioni sui campi….desiderati. Nella seguente immagine è riportato un esempio di screen in cui è possibile settare l’assegnatario della issue.

Tuttavia, quando ripetiamo questa operazione su PORTAL (dura realtà), non è possibile impostare delle screen in cui sia possibile, per il cliente, fissare dei valori su dei campi predefiniti.

Il risultato è che molto spesso i gestori lamentano questa lacuna….

Possibile soluzione?

Alla InTENSO hanno una loro soluzione, che andiam a dettagliare :-). Si tratta di Actions per JIRA Service Desk. Questo addon permette di poter definire delle Azioni che svolgono la funzione descritta in precedenza anche per gli utenti che accedono a PORTAL

Si tratta di azioni che sono distinte da quelle che possiamo attivare per le transazioni del Workflow. Occorre tenere presente questo punto.

Il risultato di questo addon è il seguente:

e di conseguenza di poter automatizzare delle operazioni.

Conclusioni

Un addon sicuramente indispensabile per la gestione del nostro Jira Service Desk. Nei prossimi post andremo ad esaminare nel dettaglio ciò che offre e cercheremo di scoprire limiti e vantaggi.

Reference

Maggiori informazioni sono presenti nella pagina del marketplace.

Curiosiamo tra gli addon

In questo post proseguiamo la nostra esplorazione tra i addon per Confluence. Oggi analizziamo Subspace della Communardo

Che cosa mette a disposizione?

Si tratta di un addon, per Cloud e per Server, che permette di organizzare la navigazione degli Space.

Cloud

Su Cloud permette di poter generare un semplice menù di navigazione, che ci permette di organizzare gli space per argomento, come mostrato in figura.

Permette di avere una buona libertà per organizzare gli Space

Permette di generare un semplice menù di navigazione

Server

Come per la versione Cloud, permette di organizzare gli Space su menù. Ovviamente, data la differenza delle apps tra Cloud e Server, il risultato grafico è differente:

Il tutto facilmente configurabile:

Come per la versione Cloud, anche la versione Server permette di generare un semplice menù

Conclusioni

Molto molto molto interessante. Questi strumenti sono sempre utili per organizzare le informazioni e per renderle fruibili. Nei prossimi post andremo a testare l’App.

Reference

Maggiori informazioni sulla versione Cloud alla seguente pagina del marketplace. Per la versione Server, fare riferimento alla seguente pagina del marketplace.

Esplorazione continua

In questo post andremo ad esplorare una sinergia esistente tra Atlassian e Lucidchart. Vedremo cosa è possibile realizzare attraverso questi due prodotti e dove possiamo spingerci.

Le presentazioni, prima di tutto

Come sempre, prima di iniziare qualsiasi elucubrazione, occorre fare le presentazioni del caso.

Lucidchart è un servizio web che permette ai gruppi di utenti di lavorare e collaborare insieme e di realizzare dei diagrammi di flusso, schemi e grafi. Come riportato nella pagina wikipedia (in inglese), Lucidchart è l’arternativa online di Visio di Microsoft.

Lo strumento è molto versatile è permette di disegnare qualsiasi grafico:

e il tutto via web e direttamente sul nostro browser, come possiamo v edere dalla seguente GIF animata:

Interessante ma ….

…. come lo andiamo ad integrare con i prodotti Atlassian? Mi allaccio al seguente articolo di Lucidchart, dove abbiamo una descrizione, in inglese, di come avviene questa integrazione.

Attraverso opportune apps (ex addons) è possibile utilizzare il servizio on line ed integrare direttamente i grafici generati su Confluence, Jira , Hipchat e BItbucket.

Per BitBucket (al momento solo la versione cloud), possiamo generare diagrammi UML, come mostrato in figura:

mentre per Confluence e JIRA abbiamo a disposizione sia la versione cloud che la versione Server.

Su Hipchatr, al momento, abbiamo a disposizione la versione Cloud. Includo il seguente video per meglio capire (audio in inglese) come funziona il tutto:

https://youtu.be/e49GEM27C-s

Conclusioni

Abbiamo sbirciato solamente in questo argomento. Nei prossimi post approfondiremo il tutto e cercheremo di capire che altro offre il marketplace, confrontando e analizzando quali possibilità offrono.

Ci riproviamo nuovamente ….

In questo post cercheremo di riassumere un Webnair della Portoghese XPand-IT, in cui viene descritto XRay ed Xpand, due prodotti indispensabili per il lavoro.

Parleremo di ….

….. XRay usando quanto visto durante il webnair e da li cercheremo di descriverlo raccontando quanto descritto ed i punti salienti. Poi non vi lamentate se vi faccio venire la voglia di registrarvi e vedere il prossimo :-P.

Mi servirò delle slide e delle schermate che sono state usate durante il webnair, oltre ai post che ho già pubblicato. Creeremo un percorso virtuale che descrive funzionalità salienti ed i punti interessanti.

Partiamo

Partiamo con questo cammino virtuale con la slide di presentazione.

dove lo speaker presenta gli argomenti del webnair. Gli argomenti trattati sono molto interessanti emi permetto di citare ance il punto 6…..

…. dove viene descritto un argomento molto a cuore di coloro che eseguono i test 🙂 . Il Webnair ha descritto in maniera esaustiva e completa tutti gli aspetti dell’addon, partendo dalla configurazione (attraverso la quale l’App si adatta alle nostre esigenze) ….

E’ stata mostrata la facilità di creare i task di test e le varie parti coinvolte nella generazione/gestione dei test.

Particolare attenzione agli step dei test, che possiamo importare anche da altre fonti in maniera mooooooooooooooooooooooooooooooolto più agevole (se ci semplifichiamo la vita siamo sempre molto più contenti).

che come abbiamo visto il tutto si è stato importato velocemente e bene 🙂

Grande, ma vediamo qualcosa di interessante?

Certamente 🙂 . Durante il Webnair è stato presentato anche come utilizzare i test automatici attraverso Cucumber.

Durante il webnair è stato mostrato il funzionamento, con un semplice esempio ma efficace, sfruttando cucumber.

E la versione 3.0? che sorprese?

Una delle novità riguarda il Test Repository per il progetto

Sono stati anche introdotti degli strumenti ulteriori, per semplificare/automatizzare la vita degli sviluppatori. A tale proposito è stato mostrato come Xport introduce ulteriore valore aggiunto:

Abbiamo anche la possibilità di eseguire delle ricerche

Reports?

Possiamo rispondere solo come segue: Quanti ne vogliamo :-D.

E la integrazione con AGILE?

La abbiamo :-D.

Al termine del webnair, una esaustiva sessione delle Q&A, dove i tecnici Xpand hanno risposto a tutte le domande.

terminando il tutto con la indicazione della documentazione/esempi di uso

Conclusioni

Sono eventi molto ben fatti ed organizzati (si lo so: sono in inglese, ma datemi tempo e presto saranno in Italiano) e il mio suggerimento e di parteciparvi. Sono gratuiti e li potete visionare direttamente da casa vostra/ufficio. La possibilità di intervenire è garantita dal mezzo utilizzato per il webnair. Se poi potete solo vederli in parte (tutti lavoriamo e tutti sappiamo come funziona il mondo), non vi preoccupate. Il webnair viene registrato e vi arriva il link alla registrazione. Potete rivederli e riesaminarli, anche se volete ricontrollare/riesaminare una sezione particolare.

Utile strumento per Confluence

In questo post andremo ad testare un nuovo addon per Confluence, che ci riserva delle belle sorprese.

Aggiornamento

Questo articolo è stato sottoposto a revisione, in base alla segnalazione della Midori stessa, che mi ha fatto una segnalazione in merito a questo articolo e, personalmente, riconosco di aver inserito una GIF sbagliata per descrivere il funzionamento:

Provvedo a sostituirlo con le indicazioni corrette. Ringrazio Levente Szabo per le indicazioni che mi ha fornito.

Dove eravamo rimasti?

Avevamo concluso la spiegazione della configurazione. Passiamo adesso alla fase di test dell’addon. Passiamo adesso al test vero e proprio dell’addon 🙂

Test

Data la complessità del test, credo sia necessario utilizzare delle GIF animate…

Come prima cosa abbiamo impostato una configurazione, in cui abbiamo indicato all’addon come identificare le pagine da archiviare/segnalare ai vari utenti.

Si è impostato una configurazione di test, che vada ad indentificare più facilmente le pagine da  elaborare, nell’ambiente di test che ho utilizzato.

Adesso andiamo ad eseguire il test verso e proprio 😛

… e come potete vedere l’utilizzo è molto complicato 😛 . Le operazioni sono molto semplici :D. L’addon legge la configurazione e procede con l’archiviazione e come potete vedere identifica le pagine che ho inserito e le …. archivia.

Conclusioni

Abbiamo finalmente concluso il test di questo addon. Data la sua complessità, ha richiesto uno spazio maggiore, ma i risultati non sono da sottovalutare: Abbiamo a disposizione uno strumento che ci aiuta nella gestione dei contenuti e che ci permette di automatizzare facilmente delle operazioni manuali. Non sottovalutiamo questo aspetto.

Reference

Maggiori informazioni sono presenti alla pagina del marketplace.

Utile strumento per Confluence

In questo post andremo ad testare un nuovo addon per Confluence, che ci riserva delle belle sorprese.

Installazione

Partiamo come sempre dalla installazione. Andiamo a cercare, dalla maschera di ricerca il nostro addon

Selezioniamo Free trial  per far partire l’installazione ….

Una volta installato ….

… attendiamo che si attivi la generazione della licenza trial ….

… seguiamo tutta la procedura e successivamente ….

… confermiamola sul nostro server fino alla conclusione della installazione.

Al termine della installazione viene visualizzata la guida dell’addon, come mostrato in figura:

dalla quale possiamo iniziare ad imparare e verificare le varie funzionalità e che vi permette di migliorare il nostro uso di Confluence. Passiamo adesso alla fase successiva :-D.

Configurazione

Proseguiamo nella configurazione. L’installazione ha introdotto i seguenti menù:

attraverso i quali eseguire le operazioni di configurazione/utilizzo. Iniziamo ad esaminarli singolarmente per capire che funzionalità introducono.

Content Quality

Se selezioniamo questo menù viene richiesto di creare un indice, che dobbiamo costruire la prima volta, necessario per il fnzionamento dello stesso. In questa sezione andiamo a gestire tale indice.

Una volta seguita la procedura di generazione dell’indice, che richede qualche istante, abbiamo questo risultato:

Start Archiving

Selezionando questa opzione, se non abbiamo generato l’indice (come indicato nel precedente paragrafo), abbiamo ancora un messaggio che ci invita a generarlo 🙂

se invece lo abbiamo generato, questo è ciò che vediamo:

ovvero ci mette a disposizione l’opzione per attivare l’archiviazione degli allegati.

Archiving Configurations

In questa sezione andiamo a configurare il nostro addon. Qui andiamo a definire la configurazione generale che poi possiamo selezionare nei nostri Space.

Selezionando Add configuration possiamo andare a definire la configurazione da usare per archiviare il nostro space. Come possiamo vedere dalla seguente figura:

andiamo a definire le regole per poter eseguire l’archiviazione, ovvero: archiviare una pagina se non viene vista per più di X giorni, achiviarla se non viene aggiornata per più di Y giorni, etc.

Possiamo anche definire se inviare le notifiche, che esaminiamo nel prossimo paragrafo.

Notification Emails

In questa sezione andiamo a definire, utilizzando Velocity, il formato delle mail da inviare per determinati eventi. Dalla seguente pagina:

Vediamo la lista delle mail disponibili per default. Se ne selezioniamo uno:

vediamo il dettaglio. In qesto caso, per riuscire a configurare il tutto, occorre un attimo di preparazione su Velocity e, come primo consiglio, suggerisco di non modificare questa sezione se non dopo che siamo abbastanza sicuri.

Archiving Events

In questa sezione abbiamo un log di tutti gli eventi di archiviazione che sono accaduti. Come possiamo vedere dalla seguente immagine:

(Anche se non abbiamo eseguito alcuna archiviazione) possiam oeseguire tutte le interrogazioni del caso.

Blacklisted Spaces

In questa configurazione andiamo ad indicare quali Space non saranno soggetti alle regole di archiviazione, impostate dalle precedenti configurazioni.

Getting Started

Selezionando questa opzione, andiamo a visualizzare nuovamente quanto viene visualizzato al termine della installazione, ovvero la seguente immagine:

Conclusioni

Concludiamo con la descrizione della configurazione questo post, e riprendiamo nel successivo la parte di test. :-). In questo modo non sovraccarichiamo il post con troppe informazioni.

Reference

Maggiori informazioni sono presenti alla pagina del marketplace.

Un altro piccolo tutorial

In questo post continuiamo con i nostri tutorial, per guidarci nella impostazione della nostra istanza di Confluence.

Una precisazione

Ringrazio Lud per i suoi commenti, che vi invito a leggere.

Grazie alle sue precisazioni ho verificato che effettivamente sono stato troppo veloce nello scrivere il post e di conseguenza non era molto chiaro. Mi scuso con i lettori. Il post è stato quindi sottoposto a revisione per meglio spiegare l’argomento.

Confluence Administrator Contact Form

Vediamo come configurare la Confluence Administrator Contact Form. Si tratta di una Form per contattare gli amministatori che Confluence mette a disposizione. Questa form viene proposta sempre quando si presenta una situazione spiacevole: Un errore 500, come mostrato dalla seguente figura:

Questa è la maschera che viene proposta agli utenti:

Come per il precedente tutorial, dedicato a Jira, anche in questo caso con pochi semplici passi andiamo a configurare il tutto

Come procediamo?

Selezioniamo la pagina di amministrazione del nostro Confluence e cerchiamo la sezione System.

Dalla sezione Site Configuration andiamo ad attivarla (abbiamo apposita checkbox) e da li andiamo a configurare anche il testo della nostra Contact form. Teniamo conto che il testo che possiamo proporre, possiamo inserire il Wiki Markup, per inserire formattazioni ed altro ancora.

Tutto?

Consiglio di avere attivato l’invio delle email e di tenere sotto controllo le notifiche. In aggiunta possiamo introdurre anche il captcha, per evitare che …. lo spam regni sovrano. Come mostrato nella precedente immagine, abbiamo una voce del menù di amministrazione di Confluence che ci permette di attivare e configurare tale opzione e di riuscire .

Dalla manualistica potete vedere che questa opzione si attiva per più componenti, quale i commenti o l’editazione di pagina. Date una occhiata al precedente link per maggiori dettagli.

Ma non è finita. Potete richiamate la maschera di contatto anche dal seguente link:

https:// < Base-URL > / contactadministrators.action

Reference

Consiglio anche la lettura (lo so: è in inglese; ma la consiglio lo stesso) di questa pagina della manualistica, per avere un quadro completo.

Una piccola novità

In questo post andremo ad esaminare una piccola novità per Confluence. SI tratta di un addon che permette di poter inserire dei Banner con dei semplici annunci, simili a quanto può eseguire JIRA con le proprie funzioni native 🙂

Che cosa permette?

Questo addon, come già indicato in precedenza, permette di poter gestire dei banner per gli annunci sotto il nostro Confluence

La precedente immagine ci fornisce un esempio di cosa possiamo fare :-), il tutto con pochi semplici click. Dalla seguente immagine:

vediamo che possiamo gestire il tutto semplicemente e con poche istruzioni.

Lo provo subito

Come in altre occasioni, lo provo subitissimo :-P. L’installazione non richiede che pochi semplici passi.

Dato che l’app è gratuita, la procedura di installazione è anche più semplice.

L’addon introduce una nuova voce di menù

nella sezione Look and Feel della sezione di amministrazione. Da li accediamo alla sezione di configurazione/attivazione/disattivazione del banner.

dove impostiamo il nostro Banner di test.

e verifichiamo subito il risultato:

Conclusioni

Abbiamo a disposizione un addon GRATUITO (al momento in cui viene redatto il post, l’addon è gratuito) che colma una delle funzionalità mancanti di Confluence. Sono sicuro che dalle prossime versioni ci sorprenderà con altre caratteristiche interessanti :-D.

Reference

Maggiori informazioni sull’addon sono reperibili alla pagina del marketplace.