Documentazione

di

Content Formatting for Confluence – Test Addon

Content Formatting for Confluence

In questo post andremo a collaudare questo addon, cercando come sempre di capire che cosa ci mette a disposizione e che cosa offre 😀

Installazione

Partiamo come sempre dalla installazione e cerchiamo il nostro addon dalla apposita maschera di ricerca, come mostrato in figura:

Selezioniamo quindi Free trial ….

… accettiamo i termini di licenza ….

… e lasciamo che la procedura esegua tutte le operazioni …

… attediamo che si attivi la fase di generazione della licenza ….

… una volta generata, applichiamola …

… attendendo che si visualizzi il messaggio di termine installazione.

Configurazione

Annuntio Vobis Gaudium Magnum … NON HABEMUS configurazione particolare per l’addon. Possiamo subito iniziare ad usare l’addon 😀

 

Test

Procediamo con il test. Anche in questo caso andiamo a generare uno space ad hoc e andiamo ad inserire i vari elementi in questo space.

Iniziamo a modificare la pagina, inserendo diverse macro, come mostrato in figura:

Per l’elenco puntato, possiamo scegliere diversi stili, come mostrato nella figura seguente:

Il risultato finale è il seguete:

Il messaggio di warning è un messaggio come quelli che lo stesso Confluence genera. Possiamo anche chiuderlo come un messaggio qualsiasi:

 

Conclusioni

Posso concludere questo test con la seguente parola: C A R I N O O O O O :-). L’addon mette a disposizione una serie di macro non indifferenti, che permette di poter generare delle pagine cariche di grafica e stile. Lo consiglio per tutti coloro che vogliono mettere su delle pagine con caratteristiche non indifferenti.

 

Reference

Maggiori informazioni sono reperibili alla pagina del marketplace.

Likes(0)Dislikes(0)
di

Un riassunto del Summit Atlassian europeo di Barcellona 2017

Riassunto in filmati

In questo post vi segnalo alcuni filmati che riassumono il primo summit europeo di Atlassian, che si è tenuto a Barcellona lo scorso Maggio.

Partiamo dal …

… keynote iniziale dell’evento, seguito da tutti i vari video 🙂

con la presentazione di Scott Farquhar.

Ship-IT

Chi ha partecipato all’evento, è riuscito a vedere con i propri occhi Ship-IT e che cosa volesse dire per Atlassian 😀

Video dei vari produttori e Atlassian Partner

Come non citare i vari produttori di Addon e Atlassian Partner europei che hanno partecipato, come valiantys

La portoghese Xpand, grande protagonista di questo Summit 🙂

Ultimi, ma non ultimi …..

Come non concludere con le interviste di diversi personaggi di punta del mondo Atlassian, su Deiser, sponsor dell’evento europeo.

come la Spagnola Deiser ha riassunto, nelle seguenti interviste, cosa ha fatto per Atlassian e che cosa riserva il futuro.

Conclusione

Un grande evento cui parteciperò sicuramente il prossimo anno, sempre a Barcellona, nel settembre del 2018. Non intendo farmelo scappare 😀

Likes(0)Dislikes(0)
di

Risorse su JIRA Service Desk

Risorse per JIRA Service Desk

In questo post andremo ad integrare quanto già esposto in questo post, dove abbiamo introdotto alcune risorse per il mondo Atlassian.

eBook per JIRA Service Desk

Segnaliamo un nuovo libro dedicato interamente a JIRA Service Desk. In un momento in cui JIRA Service Desk si conferma come un o dei prodotti più interessanti nell’ambiente, arrivando ad ottenere la certificazione ITIL, come già descritto qui, questi libri sono un utile spunto per partire con questi prodotti.

Maggiori informazioni sono reperibili qui.

 

 

Likes(0)Dislikes(0)
di

Bitbucket – Proseguiamo la nostra esplorazione

Il viaggio continua

In questo post proseguiamo quanto iniziato dai seguenti post, dedicati a Bitbucket, ovvero:

Proseguiamo….

In questo post andremo ad esaminare le operazioni che sono possibili su BitBucket, che cosa possiamo fare, come possiamo usarlo una volta installato/disponiamo l’accesso.

…. parlando di GIT e BitBucket

Iniziamo l’esplorazione calando i concetti di GIT in BitBucket, e ci facciamo aiutare dai tutorial che la stessa Atlassian mette a disposizione :-), in modo da avere sempre dei validi punti di riferimento.

La prima cosa che andimo a vedere è il concetto di Repository, che non si discosta molto dal concetto di che già usiamo nei progetti di SVN o similari. In soldoni, è il punto dove andiamo a memorizzare i nostri progetti e, di conseguenza, in nostri file. La seguente immagine ci descrive molto bene quello che bitbucket ci mette a disposizione come repository.

Una volta che il repository è creato nel nostro BitBucket, possiamo caricare i file al suo interno. In aggiunta, possiamo anche far importare i nostri progetti direttamente da altri sistemi di controllo versione, senza alcuna difficoltà. Da questo momento sarà lui il nostro repository centrale dove andremo ad eseguire tutte le operazioni di merge

 

Ed una volta caricati i dati?

Una volta che i dati sono stati caricati, possiamo iniziare a lavorare eseguendo delle operazioni di Clone, ovvero per scaricare i dati sul nostro respository GIT locale e da li…. procedere con i nostri sviluppi. Occorre sempre tenere presente che, nei repository GIT locali, noi abbiamo sempre una copia completa di tutto.

Al termine dei nostri sviluppi, una volta che tutto è pronto, inizia la fase più delicata: il Merge. In questa fase andiamo a riportare le modifiche eseguite nel repository locale, sul repository master.

Questa fase è sempre molto delicata e deve essere sempre eseguita con cura, ma in questo BitBucket ci mette a disposizione diversi strumenti per aiutarci. Di conseguenza possiamo stare molto tranquilli.

Conclusioni

Fermiamo qui questa esplorazione. Nei prossimi post andremo a visionare diverse situazioni e cercheremo di analizzare nel dettaglio le varie funzionalità.

Likes(0)Dislikes(0)
di

elearning con Confluence

E-learning

In questo post andremo ad esaminare un aspetto molto importante, dove Confluence e JIRA possono essere usati per poter realizzare dei sistemi di E-learning. In questo post andremo ad esaminare come Confluence ci può aiutare. Nel prossimo post andremo ad esaminare JIRA.

Obbiettivo

Il nostro obbiettivo è quello di sfruttare Confluence e JIRA per realizzare un sistema di E-learning, il tutto sfruttando le potenzialità standard di questi strumenti. Se ci teniamo sullo standard, possiamo anche realizzare il tutto anche su cloud.

Come?

Come utilizziamo questi strumenti? Indubbiamente sfruttiamo le potenzialità di Confluence per realizzare le pagine dove andremo a riportare tutte le nostre nozioni. Ma non solo. Non vogliamo solo mettere delle pagine statiche. Vogliamo anche impostare delle parti multimediali. In questo caso possiamo inserire dei contenuti multimediali, attraverso il widget macro

Attraverso questa macro possiamo aggiungere tanti contenuti multimediali, ma (e qui lo ribadisco ben bene) questi contenuti devono stare su server remoti. Ad esempio: possiamo aggiungere dei filmati di youtube, twitter, e tutte le indicazioni che sono riportate  nella pagina della manualistica.

Se vogliamo aggiungere dei filmati dimostrativi, che abbiamo a disposizione su di un nostro server locale, come possiamo fare? Pensate a questo. Se si tratta di filmati di una certa dimensione (100 Mb, o anche più, giusto per fare un esempio). Non li possiamo caricare sul canale di youtube della nostra aziendale. Se lo possiamo fare, non abbiamo più il problema.

In questo ci vengono in aiuto le User Macro. Un esempio lo trovate in questo blog in lingua inglese, dove l’autore spiega come realizzare questa soluzione. Altra soluzione è presente in questa pagina.

Segnalo anche questo blog, dove viene spiegato come realizzare una macro con l’obbiettivo di usare il tag HTML5 per poter avere dei video.

Ma non solo. Quello che dobbiamo realizzare è anche un percorso di lettura. La persona che deve studiare deve essere letteralmente guidata nella fase di apprendimento.

Questa è la parte più importante ma anche la più difficile. Come possiamo realizzarlo? Gliffy ci può aiutare in questo.

Questo addon, di cui abbiamo già parlato, ci consente di poter creare dei diagrammi collegati a pagine confluence, che ci aiutano a creare dei percorsi veri e propri, come mostrato nella seguente immagine.

questo ci aiuta notevolmente e, come mostrato, ci mette a disposizione un sistema per guidare per mano il nostro lettore.

In questo modo possiamo realizzare della documentazione che ci permette di creare dei percorsi di apprendimento molto importanti, il tutto con l’aggiunta anche di altri componenti.

Che altro?

Possiamo anche sfruttare Questions, che ci consente di poter realizzare dei siti dedicati allo scambio della conoscenza, come realizzato sul sito answer.

Benissimo. Ma cosa realizziamo con JIRA?

Con JIRA possiamo fare delle cose molto interessanti, ma le vedremo nel prossimo post 🙂

 

Likes(0)Dislikes(0)
di

Prendiamo una decisione….

Prendiamo una decisione ….

Sulla falsariga di una pubblicità, usiamo Confluence per aiutare gli utenti di un determinato gruppo di lavoro, nell’ambito di un loro processo decisionale, a prendere una decisione. Ci rifacciamo all’articolo del blog ufficiale della Atlassian, ma cercherò di metterci del mio :-P. L’obbiettivo è quello di stimolare la fantasia degli utenti in modo che siano loro a costruirsi la propria soluzione 🙂

Andiamo in dettaglio

Confluence ci mette a disposizione tutta una serie di strumenti che possono essere usati per definire un processo decisionale. Possiamo utilizzare sia i template che Confluence stesso mette a disposizione. Si tratta del template Decision, che come vediamo possiamo così usare:

decision-01

Come possiamo vedere, inseriamo pochi semplici parametri, e arriviamo a costruire la nostra pagina dedicata alla decisione.

decision-02

Tuttavia, questo non è una regola invalicabile. Possiamo usare anche altri template, come mostrato in precedenza; possiamo anche costruirci il nostro template ad hoc.

Un esempio potrebbe essere questo che segue:

decision-04

Possiamo usare il template che Confluence mette a disposizione, per poi ….. estenderlo a nostro piacere e necessità, aggiungendo ulteriori componenti o togliendone di non necessarie. :-). Questo è il bello di Confluence: Libertà massima.

In questo caso, abbiamo usato i seguenti componenti:

  • Metions, per coinvolgere gli utenti di confluence responsabili della … decisione. Nel caso di altri utenti, non presenti in Confluence, possiamo solo indicare il nome. Questa soluzione è usabile anche nel caso di pagina che consente un accesso anonimo;
  • Page Properties, che andiamo ad usare per inserire una serie di informazioni o metadati alla pagina. Questo risulta assai utile quando vogliamo creare delle pagine riassuntive decision-03
  • Tabelle, che usiamo per definire step, informazioni in maniera strutturata, etc. 
  • Messaggistica, che andiamo ad usare per comunicare informazioni/messaggi/task.

 

Carino, ma è il solo modo?

La domanda sorge spontanea. Possiamo solo usare Confluence? Azzardiamo una soluzione alternativa. Possiamo anche fare uso di JIRA, sfruttando le sue potenzialità. L’uso di JIRA può fornire quella marcia in più per poter aiutare le persone nel percorso decisionale.

Infatti, possiamo sfruttare i workflow in modo da impostare un percorso decisionale, definendo tutti i passi da seguire per arrivare alla decisione.

TAG05

Questo ci può aiutare anche nel definire dei processi approvativi, come mostrato nell’esempio dell’Asset management  e l’uso delle board Agile, ci può aiutare nella fase di cambio stato o nel mostrare lo stato di avanzamento (ovviamente in situazioni limitate o con opportiuni filtri – filtri da verificare).

Usando JIRA, invece di creare delel pagine, andiamo a creare un progetto o più progetti,m dedicati ai processi decisionali. Le relative Issue saranno poi le singole decisioni da prendere.

Possiamo sfruttare le potenzialità delle linked issue per legare eventuali decisioni ad altre, qualora ci siano delle dipendenza. Non male 🙂

Possiamo anche aggiungere una serie di campi custom, dedicati alla fase decisionale, che sicuramente ci aiutano. Ovviamente, in questa soluzione, Confluence può essere o meno usato come supporto. Mi spiego meglio: possiamo usare sempre confluence per documentare /  creare le pagine di documentazione che saranno di di supporto. Ovviamente queste pagine possono anche essere i contenitori di allegati di vario genere e natura.

L’obbiettivo è di sfruttare il più possibile le funzionalità che abbiamo a disposizione. 🙂

Un piccolo chiarimento

Anche se i prodotti sono dedicati prevalentemente allo sviluppo software, possiamo usarli anche per soluzioni che definisco ….. alternative. Quello che voglio esprimere in questi post, è che risulta possibile utilizzare questi strumenti anche per altri scopi,che nulla hanno a che fare con la IT.

Conclusioni

Abbiamo visto due possibili utilizzi delle funzionalità di Confluence e JIRA. Possiamo usare Confluence per aiutarci nel nostro processo decisionale, oppure usarli entrambi in modo da sfruttare meglio le funzionalità di entrambi. Ricordate sempre: La fantasia deve essere il nostro unico limite  🙂

 

 

http://blogs.atlassian.com/2015/09/make-better-decisions-software-team/

Likes(0)Dislikes(0)
di

Come usare JIRA e Confluence ….. #3

Come usare JIRA e Confluence per ……

Proseguiamo questa serie di articoli che tentano di spiegare come usare Confluence e JIRA per ulteriori scopi. In questo post andremo a vedere come usare Confluence e JIRA per ….. la gestione delle commesse.

 

Come possiamo organizzare il tutto

Possiamo pensare di impostare questa organizzazione. Come per la gestione degli Asset, vista nei precedenti post, possiamo sfruttare questo concetto e definire un Issue Type Commessa. In questo modo abbiamo la seguente situazione:

  • Una identificazione univoca delle Commesse. Possiamo in questo modo facilmente ricercarle sfruttando la ricerca che JIRA le mette a disposizione 
  • Possiamo gestirle con un opportuno Workflow, consentendo una gestione mirata 
  • Possiamo anche sfruttare i subtask per gestire tutte le attività che ricadono sotto la commessa. Il vantaggio è di dettagliare in maniera quasi completa tutti i lavori svolti e di avere il totale delle ore dedicate. Con delle semplici interrogazioni possiamo tenere sotto controllo la spesa della commessa 
  • Sfruttiamo Confluence per inserire la documentazione della commessa, specificando tutte le informazioni, cliente di riferimento, persona responsabile, lavori che devono ricadere su tale commessa 

Conclusioni

Abbiamo visto un semplice esempio di come possiamo sfruttare le funzionalità di JIRA e Confluence per gestire una situazione di tutti i giorni. Nei prossimi post andremo a vedere come realizzare una possibile implementazione.

Likes(0)Dislikes(0)
di

Pillole di esperienza su Confluence – Come usare un Wiki al meglio

Pillole di esperienza

In questo post iniziamo a trattare un argomento più complesso, ma anche molto più interessante :-), in quanto iniziamo a capire meglio, oltre che ad usare questo strumento dal punto di vista tecnico, come farlo rendere al meglio. Iniziamo ad introdurre alcuni concetti che stanno alla base dell’uso di un Wiki e che aiutano a migliorare la vita. 😀

 

Alcune precisazioni

Prima di affrontare questo argomento, occorre fare alcune precisazioni. L’argomento trattato può essere facilmente esteso a qualsiasi WIKI, senza alcuna difficoltà, in quanto si tratta di indicazioni che vanno bene per tutti. Il WIKI è uno strumento, e come tale deve essere trattato.

In aggiunta, un WIKI non è uno strumento che vive di vita propria. Deve essere curato costantemente, occorre sempre verificarne pagine e contenuti. Un WIKI Necessita di costante intervento umano, altrimenti non serve assolutamente a nulla. Diventa un banale contenitore di informazioni e ogni utente dovrà perdere tempo nel reperire le stesse.

E’ come se mettiamo degli oggetti in una grande scatola e l’unico sistema per accedere alla scatola è buco dove a malapena entra una mano. Se vogliamo prendere uno degli oggetti dobbiamo infilare la mano e, alla cieca, cercare di prendere l’oggetto che vogliamo. Non ha assolutamente senso.

A cosa serve un Wiki?

Un Wiki è uno Strumento che aiuta ad organizzare le informazioni, in modo efficiente e semplice. Il vantaggio di usare un wiki è che il sistema di organizzazione delle informazioni è molto flessibile e si basa sulla collaborazione degli stessi utenti, il cui obbiettivo non è solo la scrittura e fruizione delle informazioni, ma anche il costante miglioramento delle stesse.

Molto spesso si da per scontato che, una volta adottato un WIKI, tutti i problemi sulla documentazione siano stati superati. Errore numero 1 – Siamo appena all’inizio :-).

Tuttavia, una volta che è stato avviato, nei modi e nei tempi corretti, abbiamo a disposizione uno strumento che ci può semplificare la vita di tutti i giorni. Questo richiede uno sforzo iniziale molto forte, ma se ben fatto il risultato ripaga molto delle fatiche che sono sostenute nella fase iniziale di redazione e tutte le modifiche/estensioni successive sono poi di facile esecuzione.

Wiki come punto centrale

Inserire le informazioni solo su WIKI è un vantaggio enorme. Questo significa che le stesse sono presenti solo li, non sono duplicate o la duplicazione è ridotta al minimo possibile, e, molto importante, sono tutte collegate tra di loro, fornendo un filo logico di lettura e consentendo agli utenti di poterle visionare senza grandi problemi.

Il vantaggio di una centralizzazione è evidente: avere un unico punto dove far risiedere le informazioni riduce la possibilità di errore (non dobbiamo andare a cercare le informazioni a destra e manca) ed aumenta la produttività. Se l’informazione è sul WIKI, questa sarà ricercata li e non su mail o file system o chissà che altro.

In organizzazioni molto strutturate, molto spesso, sono dotati di complessi portali e sistemi farraginosi il cui obbiettivo è la centralità delle informazioni. Molto spesso questo non è vero, in quanto si tratta di soluzioni molto rigide, studiate per una necessità particolare e, come sempre accade, questa necessità non può essere facilmente adattata ai cambiamenti.

Un WIKI è una soluzione tra le più flessibili, in quanto le rigidità dei portali praticamente non esistono. Occorre che gli utenti sfruttino il più possibile questa flessibilità a proprio vantaggio. Il non farlo causa dei grossi problemi in fasi successive, quando si fruisce della informazione stessa. Come scrivevo prima, scrivere delle pagine alla rinfusa, non aiuta affatto, occorre che ci sia uno schema e che le informazioni siano collegate.

Facilità di uso

Le informazioni su WIKI devono essere organizzate in maniera semplice e devono essere fruibili altrettanto facilmente. Di conseguenza, in base alle esigenze aziendali, queste devono essere organizzate, collegate, referenziate in maniera opportuna. Più lo schema adottato è semplice, più è semplice fruirne. Maggiore caos nelle informazioni, maggiore caos nella ricerca, maggiore caos nel reperire le informazioni. Allora non ha alcun senso creare delle pagine su di un WIKI, sperando che gli utenti facciano da soli. Essere utenti non significa essere macchine.

Un primo passo è quello di dotare le pagine di una determinata gerarchia e, successivamente, collegare le pagine in maniera da poterle …. navigare. Avere delle pagine con la semplice informazione, ma letteralmente buttata alla rinfusa, serve a nulla. Avere delle pagine con informazioni e collegate tra di loro, dove un utente può, partendo da una determinata informazione, risalire alle altre, questo si che è un vantaggio non indifferente ed il modo di gestire un wiki. Sul come fare, abbiamo tutti gli strumenti del caso 🙂

Il secondo passo è aggiornare costantemente queste informazioni. Mantenere delle informazioni statiche, non ha molto senso. Aggiornarle costantemente ha il suo vantaggio. Per aggiornarle si intende sia estendere le informazioni presenti nella pagina, sia estendere la rete di collegamenti tra pagine.

Evitiamo le mode

Altro punto fondamentale: Non si usa un wiki solo perchè l’azienda concorrente lo usa e fa affari d’oro. Lo si usa per migliorare l’azienda, dare un valore aggiunto, ridurre la complessità e arrivare prima degli altri ai propri obbiettivi. Discorsi del tipo: loro lo usano e vanno benissimo; non servono a nulla: Errore numero 2. :-).

Uno strumento deve essere adottato in azienda solo se serve, no perché va di moda. Le mode passano. Le metodologie valide rimangono ed i risultati si vedono.

Percorso di Lettura

Altra caratteristica importante per un WIKI, riguarda come si può eseguire la lettura delle pagine. Questo è un concetto molto importante. Ogni pagina deve essere inserita in un opportuno percorso di lettura, attraverso il quale l’utente naviga alla ricerca delle sue informazioni.

Questo significa che la pagina del WIKI non è scollegata, ma è connessa con altre pagine. L’utente deve poter reperire questa pagina principalmente attraverso la navigazione di pagine. La ricerca deve essere l’ultima possibilità di reperire le informazioni, e non la normalità. Se ogni informazione viene reperita solo attraverso la ricerca, allora questo non va bene.

Facciamo un esempio. Supponiamo di avere un applicativo, cui abbiamo realizzato delle personalizzazioni per determinati clienti. Se, ad esempio, dobbiamo cercare una determinata personalizzazione, questa deve essere reperita attraverso:

  • la pagina del cliente. Da li deve essere possibile poter risalire alla personalizzazione. Se questa è comune a più clienti, allora si deve poter risalire dalle pagine dei clienti coinvolti.
  • la pagina dell’applicativo. Dalle indicazioni generali deve essere possibile risalire al particolare sviluppo operato.
  • la pagina delle personalizzazioni. Dalle indicazioni riassuntive delle personalizzazioni, deve poter essere possibile risalire alla informazione particolare del o dei clienti coinvolti.

Se non abbiamo molti elementi, allora conviene cercare per la ricerca.

Come descritto, prima di arrivare a cercare attraverso la maschera di ricerca, siamo transitati dalle pagine principali di altre informazioni, tentando una navigazione che ci porti a quello che stiamo cercando. Questo è l’utilizzo

 

Conclusione

Siamo giunti al termine di questo primo post, dedicato ai concetti fondamentali di un WIKI. Nei prossimi, cercheremo di fornire ulteriori approfondimenti che aiutino gli utenti (utilizzatori e scrittori) a fare meglio il proprio lavoro.

 

Likes(0)Dislikes(0)
di

UserProfile – Esaminiamo questo addon

UserProfile

In questo post andremo a vedere una alternativa alla macro standard Userprofile. Si tratta dell’addon della Communardo.

 

UserProfile: Cosa è?

La UserProfile Macro è una funzionalità che consente di poter visualizzare una scheda riassuntiva degli utenti, come mostrato nella figura successiva.

Questa funzionalità è sicuramente utile, quando in fase di redazione delle pagine di progetto, si realizza la sezione del team di lavoro. Con questo semplice accorgimento, abbiamo nome e cognome di chi si occupa di una determinata mansione, programma, autore; come mostrato in figura:

Questa funzionalità può essere anche utile quando, nella redazione di verbali, si inserisce l’immagine dei partecipanti. Una immagine vale più di 1000 parole.

Alternative?

Abbiamo un addon che mette a disposizione una macro simile, ma con caratteristiche in più. Si tratta di User Profiles for Confluence della Communardo. Ho avuto il piacere di sperimentare questo addon qualche anno fa, rimanendone piacevolmente soddisfatto. Andiamo in dettaglio:

 

Questo addon consente di poter aggiungere delle informazioni aggiuntive al profilo. Queste informazioni possono essere legate anche al sistema LDAP, con possibilità di sincronizzazione, come mostrato in figura:

 

e come si può notare, il sistema di creazione e sistemazione dei campi è molto semplice ed intuitivo.

 

Macro ad hoc permettono di poter rappresentare i profili in differenti maniere, ovvero:

  • tabellare, ovvero come una tabella, dove sono specificate le informazioni richieste;
  • treeview, indicando anche una sorta di gerarchie;
  • avanzato, ovvero comprendente tutte le informazioni, comprese quelle nuove

In aggiunta, viene fornito anche un People Directory esteso:

 

permettendo di poter disporre di un vero e proprio elenco telefonico. Quando lo installai, questa funzionalità non era ancora disponibile, ma a suo tempo inviai una richiesta per realizzarla :-). Adesso è disponibile.

 

Anche l’operazione di ricerca è stata estesa, in modo da poter comprendere anche la ricerca di …. profili. Si tratta di un lavoro eccezionale.

Conclusioni

Abbiamo esaminato una funzionalità molto importante, dal punto di vista grafico, che permette di inserire la propria…faccia su Confluence :-). Abbiamo anche visto un esempio di addon, che mette a disposizione delle ulteriori macro parallele alla funzionalità standard, che consentono di poter aggiungere valore alle nostre pagine Confluence. Al momento, l’addon è disponibile solo per le installazioni server, ma non disperiamo. Come già notato in precedenti post, questo addon potrebbe essere presto disponibile.

Likes(0)Dislikes(0)
di

Stampiamo le pagine Confluence in PDF

Contenuti, Contenuti, Contenuti

In questo post andremo a vedere come possiamo stampare su PDF le pagine del nostro Confluence. Primo di una serie, in questo post andremo a fare una presentazione delle possibilità esistenti.

 

Come portare i contenuti su PDF?

Cerchiamo di dare una risposta a questa semplice domanda.

Abbiamo diverse possibilità, a seconda del nostro portafoglio, delle possibilità e delle potenzialità. Il primo sistema che abbiamo a disposizione è quello di stampare la pagina web su PDF (Opzione nativa su Chrome), sfruttando sia quello che il Browser offre che prodotti di terze parti, che ci creano delle stampanti virtuali che svolgono questa mansione.

Tuttavia, quello che potremmo ottenere, non sempre risulta di nostro gradimento: impaginazione non proprio perfetta, oppure riservarci delle sorprese e…. dover ricominciare da capo.

Altra alternativa è la funzionalità nativa di Confluence, come mostrato in figura:

pdf-01

Si tratta di una funzionalità nativa, messa a disposizione sia della versione server che della versione cloud, che consente di poter eseguire una esportazione, in formato PDF, della pagina correntemente visualizzata. Tuttavia il risultato potrebbe essere il medesimo e l’espressione del nostro viso potrebbe non mutare 🙂

L’operazione è possibile, sia per una singola pagina, che per un intero space/porzioni di space:

Infatti questa modalità ha necessità di essere opportunamente configurata. Ciò deve essere eseguito nella sezione di amministrazione: da COG menù selezioniamo General Configuration, quindi nel pannello di amministrazione cerchiamo la sezione LOOK AND FEEL:

pdf-02

abbiamo due sezioni dedicate alla configurazione:

  • PDF Layout
  • PDF Stylesheet

Il primo è interamente dedicato alla definizione del layout, dove andiamo a definire:

  • Titolo della pagina
  • Header
  • Footer

pdf-03

Il secondo consente di poter impostare un foglio di stile CSS da impostare per determinare lo stile del PDF.

Alternative?

Abbiamo valide alternative alle funzionalità standard di Confluence. Si tratta di un addon molto valido, ovvero Scroll PDF Exporter. Sviluppato dalla K15t Software GmbH, mette a disposizione una serie di funzionalità che semplificano notevolmente la vita dei redattori di documenti. Questo addon è al momento disponibile solo per le installazioni Server, ma confidiamo che funzionalità analoghe saranno presto disponibili su installazioni cloud.

 

Viene data la possibilità di poter definire degli export scheme  personalizzati, in maniera molto semplice, come siamo già abituati.

 

Semplici autocomposizioni consentono agli utenti, anche non espertissimi, di poter configurare un export scheme senza alcuna fatica e con pochi click del mouse.

 

Un addon molto completo e ben semplice, che consente di poter creare, dato un Confluence, un manuale in pochissimi click.

 

Altre alternative?

Abbiamo anche altre alternative, magari meno cool, ma andiamole a vedere. Sono sicuro che saranno molto interessanti 🙂

Iniziamo con PDF Macros for Confluence. Si tratta di un addon che mette a disposizione le seguenti macro, al fine di consentire l’esportazione su PDF delle pagine di Confluence:

  • PDF Pagebreak: Per forzare le interruzioni di pagina
  • PDF Landscape: Mostrare il risultato della pagina in Landscape.
  • PDF Hidden Content: Nascondere il contenuto in fase di esportazione
  • Hide in Web View: Mostrare il contenuto solo su esportazione
  • Current Date and Time: Mostrare data e ora sulle pagine

Addon gratuito (al momento in cui viene scritto questo post), è una valida alternativa per predisporre delle pagine di Confluence, al fine di creare delle sezioni che diventino della manualistica.

 

Conclusioni

Abbiamo visto una panoramica di questo argomento. Nei prossimi post andremo più in profondità, per meglio capire come poter sfruttare queste funzionalità.

Likes(0)Dislikes(0)