Un addon utile ed interessante

In questo post, descriveremo un addon per Confluence Cloud, che consente di poter criptare dei testi in maniera semplice, integrato con Confluence.

Descriviamo il funzionamento

L’installazione è molto semplice e non richiede particolari attenzioni. Nei precedenti post, ho avuto modo di descrivere la facilità di utilizzo della procedura di installazione. La Atlassian ha fatto un ottimo lavoro 🙂

Questo addon non mette a disposizione delle macro, ma semplicemente viene messa a disposizione una voce di menù, da dove poter eseguire la criptazione di un testo: vSecure. 

Selezionando la voce di menù, viene mostrata una window, dove poter eseguire la trasformezione. Banalmente, per eseguire la cifratura, inserire il testo, inserire la password (in doppia copia), ed il gioco e fatto.

A questo punto, possiamo inserire i testi, ben protetti e con la sicurezza che non saranno decodificati. Di seguito un esempio di frase cifrata 🙂

Questa è la frase sopra riportata… opportunamente cifrata.

Attenzione

Fare attenzione a non dimenticare la password usata per criptare 😛

Conclusioni

Abbiamo visto come poter inserire dei testi cifrati all’interno di Confluence cloud, in maniera molto semplice e gratuita 😀 (al momento in cui il post viene scritto la situazione è quella descritta).

Un semplice esempio di uso

Mostreremo, in questo post, come creare una semplice scheda carburanti o una scheda molto semplice. Si tratta di un semplice utilizzo di Confluence, ma posso assicurare che si tratta di un ottimo sistema per avere le informazioni sempre disponibili, in un unico punto e con la possibilità di poter elaborare queste informazioni.

Di cosa abbiamo bisogno

Per realizzare questo semplice esempio, faremo uso di:

• CYO Create-Your-Own, un addon per Confluence Cloud che consente di poter integrare Confluence con diversi componenti quali: video, grafici interattivi, Google Spreadsheet e tanti altri.
• Google Spreadsheet (o Fogli, per la versione italiana).

Iniziamo

Una volta installato l’addon, seguendo i semplici passi che la procedura di installazione mette a disposizione, iniziamo a lavorare sull’Addon 🙂

In questo primo esempio, proveremo ad integrare un semplice foglio di lavoro di Google, opportunamente predisposto, come mostrato in figura:

Semplicemente, procediamo inserendo la macro CYO – Create-Your-Own Custom Macro nella pagina. Per mia comodità, mi appoggerò ad un Panel.

La configurazione della macro è abbastanza semplice. Selezionando con il mouse la macro, possiamo entrare nella agevole autocomposizione della macro:

dove possiamo selezionare il modulo che vogliamo inserire. Selezionando l’opzione Create, viene aperto il sito web dell’addon, da dove possiamo impostare il modulo che vogliamo generare, come mostrato in figura:

Da qui andiamo ad eseguire il collegamento impostando il link al nostro foglio, creato in precedenza. Il risultato è veramente notevole:

Abbiamo integrato, senza problemi il foglio su Confluence e, con grande meraviglia, possiamo anche interagire con i dati. Possiamo anche andare a modificare i dati stessi senza alcun problema :-), come mostrato in figura.

Ovviamente questo dipende dal codice che è stato inserito nella macro richiamata. Se vogliamo possiamo solo inserire un foglio in sola lettura.

Questo è solo l’inizio….

Ovviamente questo è solo l’inizio di tutto. Con questo addon è anche possibile aggiungere delle FORM vere e proprie nel nostro Confluence Cloud, in maniera abbastanza semplice, senza dover ricorrere a ulteriori addon specifici :-D. Mostro in anteprima il risultato. Nel prossimo post sarà mostrato come poter eseguire tale integrazione, utilizzando dei servizi online, che consentono di poter creare delle form e di poterle poi inserire all’interno dei propri siti web.

Conclusioni

L’addon indicato consente di poter eseguire delle integrazioni che non sarebbero state possibili prima, con una facilità non indifferente. Questo consente di poter estendere, molto facilmente, le funzionalità di Confluence Cloud e …. stimola la fantasia :-). Faccio i miei complimenti all’autore dell’addon, per l’ottimo lavoro svolto.

Consigli vari ed assortiti

In questo post diamo dei piccoli consigli, sfruttando alcune piccole funzionalità presenti su Confluence e JIRA.

Creare commenti/Issue Jira da testo selezionato aka PINPOINT

Possiamo creare un commento selezionando un testo della pagina corrente, in modo molto semplice. Iniziamo selezionando il testo che ci serve. Vedremo che appare un piccolo gadget sopra il testo, con due opzioni:

• Create inline comment – attraverso il quale creiamo dei commenti in cui il testo selezionato viene evidenziato

• Create Jira Issue – attraverso il quale creiamo una Issue Jira partendo dal commento selezionato.

Queste autocomposizioni possono tornare molto utili per velocizzare diverse operazioni.

Indicare il codice nei commenti JIRA

In alcune occasioni può risultare utile inserire del codice nei commenti di JIRA. Un piccolo consiglio può risultare utile, al fine di rendere il commento adeguatamente formattato. Se si inserisce il commento come mostrato di seguito:

{code}
……<codice>…..
{code}

il codice sarà visualizzato su di un riquadro e formattato adeguatamente. La seguente immagine chiarisce il risultato:

Se si vuole inserire un syntax highlighting al codice scritto, allora occorre impostare il linguaggio nel tag code, come mostrato in figura:

{code:sql}
.....<codice>.....
{code}

Elenchi puntati su commenti di JIRA

Un altro esempio di come indicare degli elenchi puntati, su commenti di JIRA, è riportato di seguito:

* esempio1
* esempio2

– esempio1
– esempio2

Il risultato del seguente esempio è il seguente:

In questo caso, il carattere * ed il carattere – vengono rappresentati come due diversi tipi di pallino per gli elenchi puntati.

E’ possibile impostare diversi livelli di elenchi puntati, utilizzando i seguenti codici:

# esempio
# controesempio
#* interno1
#* interno2
#* interno3
# altro esempio

Questo è il risultato:

Invertendo l’ordine:

* esempio
* controesempio
*# interno1
*# interno2
*# interno3
* altro esempio

Il risultato è il seguente:

Conclusioni

In questo post abbiamo visto dei piccoli consigli, molto semplici, ma che possono aiutare nel proprio lavoro di tutti i giorni :-). Nei prossimi post daremo altri piccoli consigli per formattare o usare tante piccole funzionalità di Confluence e JIRA e aiutare l’uso quotidiano 😀

Gallerie di immagini

Vedremo, in questo post, un semplice esempio di come realizzare una semplice galleria di immagine.

Di cosa abbiamo bisogno?

Quello di cui necessitiamo è:

• allegati a pagina
• Gallery Macro

Semplice no? Andiamo a vedere cosa inserire nella pagina. La seguente immagine mostra che cosa viene inserito nella pagina:

Se andiamo a visualizzare le proprietà della macro, abbiamo alcune sorprese:

Come possiamo vedere possiamo impostare le seguenti caratteristiche:

• Titolo della Gallery
• Numero di colonne con cui si vuole impostare la gallery
• Quali immagini da escludere
• Quali immagini includere
• Quali etichette, associate alle immagini, considerare
• Quali etichette, associate alle immagini, escludere
• Da quale pagina andare a selezionare le immagini allegate.

Risultato? lo vediamo nella seguente immagine:

Se andiamo a selezionare una immagine, questo è il risultato:

Possiamo allegare le immagini su di una pagina specifica, ma possiamo usare una seconda pagina per visualizzare la gallery 🙂

Conclusioni

Abbiamo visto una potenzialità di Confluence, attraverso la quale poter realizzare una gallery di immagini in maniera semplice e veloce.

Reference

Fare riferimento a questo link per la manualistica di Confluence.

Usiamo Confluence

In questo post, cercheremo di fornire un esempio delle potenzialità di Confluence, costruendo una scheda cliente. Questo esempio può essere usato in diversi contesti, dal semplice professionista, che vuole creare una semplice scheda riassuntiva di ogni suo cliente, alla megazienda esagerata, dove un Manager deve gestire l’elenco dei suoi clienti o progetti. I concetti e le funzionalità che possiamo sfruttare sono i medesimi.

Che cosa ci serve?

Per realizzare il tutto, abbiamo bisogno di:

• Uno space dedicato (consigliato. Vi riportiamo tutte le informazioni dei clienti. Sfrutteremo questo anche per altre informazioni)
• Loghi dei clienti (consigliato. Una immagine aiuta più di 1000 parole)
• Page Properties
• Creare una pagina specifica per ogni clienti, come pagina figlia della HOME dello Space
• Template (consigliato. In questo modo, la scheda cliente viene standardizzata e resa di facile lettura)

Usiamo la HOME dello Space per raccogliere le informazioni di tutti i clienti. Sulla singola pagina inseriamo le informazioni del cliente. Un esempio potrebbe essere questo :-), ispirandomi al mitico Will Coyote e Beep Beep

Sfruttando poi l’uso delle Page Properties, quello che possiamo ottenere è il seguente risultato:

Nota Bene
Ricordarsi che le pagine dei clienti specifici devono essere marcate con opportuna/e label/s, in modo da consentire alle macro delle Page Properties,  di selezionare correttamente le informazioni da visualizzare.

Conclusioni

Abbiamo visto un esempio di come possiamo sfruttare Confluence per realizzare delle schede clienti (o progetti o qualsiasi altro ancora). Abbiamo visto come organizzare determinate informazioni e come poterle usare al meglio, sfruttando le impostazioni standard. Quanto visto qui è usabile sia nella versione server che nella versione ondemand. Come sempre, la fantasia è il nostro unico limite 🙂

Permission

In questo post andremo ad esaminare come gestire le permission. Vedremo che cosa sono, come si gestiscono e a che livello.

Diamo una definizione

Sotto questo termine, si intende fondamentalmente la visibilità che andiamo a forniamo ai contenuti di Confluence. Per Contenuti si intende:

• Sito (ovvero l’intero Confluence)
• Space
• Pagine

Confluence consente di poter assegnare delle Permission ai seguenti livelli:

Global

Si tratta delle permission che si possono fornire a livello di intero Confluence. SI tratta di permission GENERALI. Facciamo notare che viene sempre fornita una distinzione nelle seguenti classi di utenti:

• Gruppi;
• Utente singolo;
• accesso anonimo (inteso come accesso a Confluence senza loggarsi);

per tutte le permission.

Dalla figura precedente, possiamo vedere quali Permission possiamo assegnare. La prima, e più importante in quanto stabilisce anche il numero di utenti utilizzati e quindi la licenza (ed i soldi da pagare), è la can use. Tenetela sempre presente e controllatela 🙂

Seguono le permission che consentono di poter:

• Attach file to user profile, che consente di poter allegare file al profilo utente. AL momento soppiantata dalla possibilità di poter creare dei Personal Space.
• Personal Space, che consente di poter creare degli Space personali, dove ogni utente può inserire le proprie informazioni e che può gestire a suo uso e consumo. Dedicheremo un post a questo argomento molto importante 😀
• Create Space(s), che consente di poter creare degli space
• Confluence Administrator, che consente l’accesso alla console di amministrazione
• System Administrator,  che consente l’abilitazione, nella console di amministrazione, di poter accedere a particolari funzionalità che sono normalmente precluse agli utenti amministratori. Fare riferimento alla sezione reference, dove ho riportato la manualistica con le indicazioni delle differenze di quali operazioni sono consentite nei due ruoli.

Nella versione server, il ruolo System Administrator è assegnato al gruppo Administrator. Nella versione onDemand, non abbiamo questo, ma solitamente viene impostata questa distinzione.

La seguente figura riporta le stesse indicazioni ma per gli utenti e per l’accesso anonimo.

Space

In questo caso, viene data la possibilità di poter gestire le permission relative al singolo Space. Qui troveremo le azioni che è possibile eseguire SOLO A LIVELLO DI INTERO SPACE. Solo gli utenti/gruppi che sono stati precedentemente indicati come Space Administrator, possono manipolare tali permission. Anche in questo caso abbiamo la distinzione nelle tre tipologie di utenze, come indicato in precedenza.

Vediamo nel dettaglio che cosa possiamo fare:

• View, possibilità di poter consentire l’accesso;
• Pages, possibilità di creare/modificare/cancellare pagine nello space. Abbiamo la distinzione in due possibilità: Add, per aggiunta/modifica; Delete, per cancellazione;
• Blog, possibilità di poter creare/modificare/cancellare blog post (fondamentalmente pagine di Confluence, ma visibili solo attraverso la sezione Blog Post dello Space).  Abbiamo la distinzione in due possibilità: Add, per aggiunta/modifica; Delete, per cancellazione;
• Comments, possibilità di poter aggiungere/modificare/cancellare commenti alla pagina.  Abbiamo la distinzione in due possibilità: Add, per aggiunta/modifica; Delete, per cancellazione;
• Attachments, possibilità di poter aggiungere (tenendo conto della versione) e rimuovere gli space.  Abbiamo la distinzione in due possibilità: Add, per aggiunta/modifica; Delete, per cancellazione;
• Restrictions, possibilità di poter impostare/rimuovere le restrizioni alla pagina (che vedremo nel dettaglio di seguito). In questo caso abbiamo una unica opzione;
• Mail, possibilità di poter cancellare le email che sono state riportate nello space (Vedi sezione riferimenti)
• Space, possibilità di esportare lo space (Export) o di amministrarlo (Admin).

Da notare che, dalla console di amministrazione di Confluence è possibile definire quali permission di default deve possedere uno Space appena creato. Questo è possi- bile attraverso la sezione Space Permission, presente nella console di amministra- zione. Da qui possiamo impostare quali configurazioni di Default possiede uno Space appena creato. Sta poi all’amministratore impostare le configurazioni particolari da assegnare allo Space appena generato.

Page

In questo caso andiamo ad impostare quali operazioni possono essere eseguite sulla singola pagina dello space. Si tratta dell’entità minima che possiamo andare a trattare. Richiamiamo la funzione attraverso il menù Tools (Rif. al seguente post se utilizzate una delle ultime versioni di Confluence)

Quindi si accede alla funzionalità

Le uniche operazioni che possiamo eseguire sono le seguenti:

• Viewing restricted to, ovvero consentire la sola visualizzazione a utenti/gruppi specificati.
• Editing restricted to, ovvero consentire la modifica a utenti/gruppi specificati

 Conclusioni

In questo post abbiamo esaminato una funzione molto importante di Confluence, che ci consente di poter amministrare il sistema e di poterlo gestire al meglio per i nostri utenti. Anche se al momento la funzionalità è alquanto distribuita nelle varie sezioni di confluence, iniziano ad essere distribuiti degli addons che centralizzano queste funzioni, come il seguente addon, che rappresenta un primo passo. Attendiamo i prossimi sviluppi. .

Reference

Consiglio di leggere la manualistica della Atlassian, completa e molto chiara ma, ahimè, in inglese, sulle permission. Per la parte delle email associate ad uno space, consiglio la seguente pagina della manualista Atlassian.

Ancora news

Con gli ultimi rilasci, abbiamo una nuova modifica su Confluence, come già indicato dal precedente post.

Il menù TOOLS viene modificato (come grafica) è sostituito, come indicato dalla precedente immagine.

Altra modifica riguarda la parte delle notifiche:

Chi dispone della versione su hosting, si troverà già questa nuova modifica 🙂