{"id":76463,"date":"2020-04-02T13:42:40","date_gmt":"2020-04-02T11:42:40","guid":{"rendered":"https:\/\/prohoster.info\/blog\/administrirovanie\/proektirovanie-v-confluence"},"modified":"2020-04-02T13:42:40","modified_gmt":"2020-04-02T11:42:40","slug":"proektirovanie-v-confluence","status":"publish","type":"post","link":"https:\/\/prohoster.info\/it\/blog\/administrirovanie\/proektirovanie-v-confluence","title":{"rendered":"Progettazione in Confluence","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

Ciao a tutti! <\/p>\n

Mi chiamo Masha e lavoro come ingegnere della qualit\u00e0 nel gruppo Tinkoff. Il lavoro nel QA implica molte comunicazioni con diverse persone da vari team, e io, che sono stata anche manager e docente di programmi educativi, ho avuto una rete di comunicazione molto ampia. E a un certo punto ho esploso: ho capito che non potevo pi\u00f9, pi\u00f9, pi\u00f9 riempire tonnellate di tabelle e documenti illeggibili. <\/p>\n

\"Progettazione
\n
\n<\/a><\/noindex>
\nSicuramente ognuno di voi ora si sta immaginando ci\u00f2 di cui parlo e ha sudato freddo: liste di cognomi senza ordine alfabetico, tabelle con centinaia di colonne e formattazione disordinata, tabelle con migliaia di righe in cui bisogna strisciare il dito sulla rotellina del mouse per vedere il titolo, tonnellate di pagine senza numerazione, centinaia di e-mail inviate tra di noi con dati da analizzare e sistematizzare e da infilare in altrettante tabelle illeggibili.<\/p>\n

\"Progettazione
\n
\nE, quando ho preso un po' di distanza, ho deciso di scrivere questo articolo. Parler\u00f2 di come si possa gestire in modo adeguato (e talvolta anche comodo) la documentazione non legata al prodotto. Spero che l'articolo si diffonda in rete e che il livello di caos nei reparti vicini allo sviluppo si abbassi, rendendo le persone (me compresa) un po' pi\u00f9 felici.<\/p>\n

\"Progettazione
\n<\/p>\n

Strumenti<\/h2>\n

\nLa documentazione del prodotto \u00e8 spesso conservata accanto al codice, ed \u00e8 una cosa positiva. La documentazione non legata al prodotto, invece, viene solitamente dispersa. Spesso, le persone cercano di trasferire informazioni da vari luoghi in Confluence, e noi non facciamo eccezione. Quindi, parler\u00f2 di questo in seguito.<\/p>\n

In effetti, Confluence \u00e8 un avanzato motore wiki. Permette di lavorare con i dati in diverse modalit\u00e0 di visualizzazione: testo formattato, tabelle, vari diagrammi. \u00c8 uno strumento molto interessante e potente, ma se non si sa come utilizzarlo correttamente, si rischia di ottenere un'altra discarica di documenti illeggibili. Vi insegner\u00f2 a prepararlo!<\/p>\n

\"Progettazione
\n<\/p>\n

Macro<\/h2>\n

\nQuasi tutta la magia di Confluence si basa sui macro. Ce ne sono molti e possono essere combinati tra loro. Esistono versioni a pagamento e gratuite; seguiranno vari esempi di macro con link alla loro documentazione.<\/p>\n

L'interfaccia per lavorare con i macro \u00e8 estremamente semplice. Per aggiungere un macro, \u00e8 necessario fare clic sul segno pi\u00f9 e selezionare l'elemento desiderato dalla lista.<\/p>\n

\"Progettazione
\n
\nSe il macro \u00e8 autonomo, ovvero non richiede l'inserimento di qualcos'altro al suo interno, appare come un blocco.<\/p>\n

\"Progettazione
\n
\nSe per il funzionamento del macro \u00e8 necessario inserire qualcosa all'interno, appare come un riquadro.<\/p>\n

\"Progettazione
\n
\nIn questo modo, puoi inserire all'interno di un riquadro quanti pi\u00f9 elementi di altri desideri, purch\u00e9 ci sia un senso logico nella tua piramide.<\/p>\n

\"Progettazione
\n
\nOgni macro presenta un'anteprima: qui puoi immediatamente vedere se hai compilato e configurato correttamente il macro.<\/p>\n

Modelli<\/h2>\n

\nOltre ai macro, esiste uno strumento molto utile di completamento automatico del contenuto: il modello.
\nI modelli possono essere utilizzati durante la creazione di qualsiasi pagina: basta fare clic sui tre puntini accanto al pulsante \"Crea\" e selezionare il modello desiderato.<\/p>\n

\"Progettazione
\n
\nIn questo modo, verr\u00e0 aggiunto alla pagina creata tutto il contenuto presente nel modello.<\/p>\n

Chiunque pu\u00f2 creare pagine a partire da modelli, ma solo chi ha i diritti pu\u00f2 creare o modificare i modelli stessi. All'interno di un modello possono essere aggiunte istruzioni aggiuntive su come gestire la pagina.<\/p>\n

\"Progettazione
\n<\/p>\n

La magia delle tabelle<\/h2>\n

\nIn effetti, come tecnico, amo teneramente le tabelle e posso inserire quasi qualsiasi informazione al loro interno (anche se non \u00e8 sempre efficace). Le tabelle stesse sono chiare, strutturate, scalabili, magiche!<\/p>\n

\"Progettazione
\n
\nMa anche una meravigliosa entit\u00e0 come la tabella pu\u00f2 essere rovinata. Oppure pu\u00f2 essere usata con successo e persino migliorata. Di questo parler\u00f2 qui di seguito.<\/p>\n

Filtraggio (plugin a pagamento)<\/h3>\n

\nQualsiasi tabella enorme e illeggibile pu\u00f2 diventare un po' meno enorme e un po' pi\u00f9 leggibile grazie al filtraggio. A tal fine, si pu\u00f2 utilizzare un macro a pagamento. \u00abFiltro tabelle\u00bb<\/a><\/noindex>.<\/p>\n

All'interno di questo macro bisogna inserire la tabella (si pu\u00f2 anche usare la pi\u00f9 brutta, l'importante \u00e8 inserirla per intero). Nel macro \u00e8 possibile scegliere le colonne da filtrare tramite un menu a discesa, filtro testuale, numerico e filtro per date. <\/p>\n

\"Progettazione
\n
\nImmagina che tutte le informazioni sui candidati per tutte le posizioni siano registrate in un elenco tabellare. Naturalmente, non ordinato: le persone non partecipano ai colloqui in ordine alfabetico. E tu devi capire se hai gi\u00e0 intervistato un determinato candidato. Basta inserire questo caos in un macro filtro, aggiungere un filtro testuale per il cognome \u2014 ed ecco, hai le informazioni sullo schermo.<\/p>\n

\"Progettazione
\n
\n\u00c8 importante notare che filtrare enormi tabelle pu\u00f2 influenzare le prestazioni del sistema e i tempi di caricamento delle pagine, quindi inserire un'enorme tabella in un filtro \u00e8 una soluzione temporanea; \u00e8 meglio strutturare un processo in cui le persone non debbano creare enormi tabelle illeggibili (un esempio di processo sar\u00e0 alla fine dell'articolo).<\/p>\n

Ordinamento (plugin a pagamento)<\/h3>\n

\nCon il magico macro \u00abFiltro tabelle\u00bb<\/a><\/noindex> puoi anche impostare un ordinamento predefinito per qualsiasi colonna e numerare le righe. Oppure fare clic su qualsiasi colonna della tabella inserita nel macro filtro, e si attiver\u00e0 l'ordinamento per quella colonna. <\/p>\n

\"Progettazione
\n
\nAd esempio, hai la stessa tabella con i candidati e devi stimare quante interviste sono state effettuate in un mese specifico: ordina per data e goditi il risultato.<\/p>\n

Tabelle pivot (plugin a pagamento)<\/h3>\n

\nPassiamo ora a un caso pi\u00f9 interessante. Immagina che la tua tabella sia enorme e tu debba calcolare qualcosa su di essa. Certamente, puoi copiarla in Excel, fare i calcoli necessari e caricare i dati nuovamente in Confluence. Oppure puoi applicare una volta per tutte la macro \u00abTabella pivot\u00bb<\/a><\/noindex> e ottenere lo stesso risultato, ma anche in modo aggiornato.<\/p>\n

Ad esempio: hai una tabella che raccoglie i dati di tutti i dipendenti, indicando dove si trovano geograficamente e quali sono i loro ruoli. Per contare quante persone ci sono in ogni citt\u00e0, devi selezionare nella macro \u00abTabella pivot\u00bb la riga su cui aggregare i dati (posizione) e il tipo di operazione (somma).<\/p>\n

\"Progettazione
\n
\nNaturalmente, puoi raggruppare per pi\u00f9 criteri contemporaneamente, puoi visualizzare tutte le possibilit\u00e0. nella documentazione<\/a><\/noindex>.<\/p>\n

Diagrammi (plugin a pagamento)<\/h3>\n

\nCome gi\u00e0 detto, non tutti amano le tabelle tanto quanto me. Purtroppo, la maggior parte dei manager le detesta. Tuttavia, tutti adorano i diagrammi colorati e vivaci.
\nI creatori di Confluence ne erano sicuramente a conoscenza (probabilmente hanno anche loro capi che amano report e diagrammi, non si pu\u00f2 farne a meno). Quindi, \u00e8 possibile sfruttare il magico macro \u00abDiagramma da tabella\u00bb<\/a><\/noindex>. In questo macro bisogna inserire la tabella pivot del punto precedente, ed ecco fatto \u2014 i vostri grigi e noiosi dati saranno splendidamente visualizzati.<\/p>\n

\"Progettazione
\n
\nNaturalmente, anche questo macro ha delle impostazioni. Il link alla documentazione di qualsiasi macro pu\u00f2 essere trovato in modalit\u00e0 di modifica di quest'ultima.<\/p>\n

Semplicit\u00e0 di aggregazione<\/h2>\n

\nLe informazioni nei punti precedenti non saranno state per voi una rivelazione. Ma ora sapete sicuramente come usare i macro, e posso passare a una parte pi\u00f9 interessante dell'articolo.<\/p>\n

\"Progettazione
\n<\/p>\n

Etichette<\/h3>\n

\n\u00c8 problematico quando le persone memorizzano informazioni in un unico articolo non strutturato o in un enorme foglio di calcolo. Anche peggio \u00e8 quando parti di queste informazioni non solo sono presentate in modo illeggibile, ma sono anche disperse nei meandri di Confluence. Fortunatamente, \u00e8 possibile raccogliere le informazioni disperse in un unico posto. Per fare questo, \u00e8 necessario utilizzare etichette<\/a><\/noindex> (simili ai tag che tutti conosciamo dai social media).<\/p>\n

\"Progettazione
\n
\nPuoi aggiungere un numero illimitato di etichette a qualsiasi pagina. Se clicchi su un'etichetta, verrai indirizzato a una pagina di aggregazione, dove troverai link a tutti i materiali con quell'etichetta, nonch\u00e9 un insieme di etichette correlate. Le etichette correlate sono quelle che spesso compaiono sulla stessa pagina.<\/p>\n

\"Progettazione
\n<\/p>\n

Propriet\u00e0 delle pagine<\/h3>\n

\nPuoi aggiungere un'altra macro interessante a una pagina per strutturare le informazioni \u2014 \u00abPropriet\u00e0 delle pagine\u00bb<\/a><\/noindex>. All'interno di essa devi fornire una tabella di due colonne, la prima sar\u00e0 la chiave e la seconda il valore della propriet\u00e0. Inoltre, la macro pu\u00f2 essere nascosta dalla pagina, in modo che non disturbi la lettura del contenuto, ma la pagina sar\u00e0 comunque contrassegnata con le chiavi necessarie.<\/p>\n

\"Progettazione
\n
\nAttenzione all'ID: \u00e8 utile assegnarlo per associare diversi gruppi di propriet\u00e0 a pagine differenti (o anche a gruppi di propriet\u00e0 diversi su una sola pagina). <\/p>\n

Report<\/h3>\n

\n\u00c8 possibile raccogliere report per etichetta. Ad esempio, il macro \u00abReport sul contenuto\u00bb<\/a><\/noindex> raccoglie tutte le pagine con un determinato insieme di etichette.<\/p>\n

\"Progettazione
\n
\nMa un report pi\u00f9 interessante \u00e8 il macro \u00abReport sulle propriet\u00e0 della pagina\u00bb<\/a><\/noindex>. Anche questo raccoglie tutte le pagine con un certo insieme di etichette, ma non si limita a elencarle, bens\u00ec compila una tabella (capite il legame con l'inizio dell'articolo?), in cui le colonne rappresentano le chiavi delle propriet\u00e0 della pagina.<\/p>\n

\"Progettazione
\n
\nSi ottiene una tabella riepilogativa con informazioni provenienti da diverse fonti. \u00c8 piacevole notare che ha funzioni comode: layout reattivo, ordinamento per qualsiasi colonna. Inoltre, questa tabella di report pu\u00f2 essere configurata all'interno del macro. <\/p>\n

\"Progettazione
\n
\nNella configurazione \u00e8 possibile rimuovere alcune colonne dal report, impostare uno stato predefinito o il numero di record visualizzati. Inoltre, \u00e8 possibile impostare l'ID della propriet\u00e0 della pagina per vedere solo le informazioni necessarie.<\/p>\n

Ad esempio, hai diverse pagine dedicate ai dipendenti, ciascuna con un insieme di propriet\u00e0 riguardanti la persona: il suo livello, la sua posizione, quando \u00e8 entrato nel team e cos\u00ec via. Queste propriet\u00e0 sono contrassegnate ID = employee_inf<\/i>. E c'\u00e8 un secondo insieme di propriet\u00e0 sulla stessa pagina, che raccoglie informazioni sulla persona come parte del team: quale ruolo svolge, in quale team si trova e cos\u00ec via. Queste propriet\u00e0 sono contrassegnate ID = team_inf<\/i>. Quindi, durante la generazione del rapporto, puoi visualizzare solo le informazioni relative a un singolo ID oppure a entrambi \u2014 a seconda di ci\u00f2 che \u00e8 pi\u00f9 comodo.<\/p>\n

Il bello di questo approccio \u00e8 che ognuno pu\u00f2 creare la propria tabella informativa personalizzata, che non presenter\u00e0 duplicati e si aggiorner\u00e0 automaticamente quando viene aggiornato il contenuto principale della pagina. Ad esempio, per un team leader, non \u00e8 rilevante sapere quando i suoi sviluppatori sono stati assunti, ma \u00e8 importante quale ruolo ciascuno di loro svolge all'interno del team. Quindi il team leader creer\u00e0 un rapporto per il team. Un contabile, invece, non \u00e8 affatto interessato ai ruoli, ma agli incarichi \u2014 rediger\u00e0 un rapporto per le posizioni. In questo modo, la fonte delle informazioni non verr\u00e0 duplicata o trasferita.<\/p>\n

Processo finale<\/h2>\n

<\/p>\n

Istruzione<\/h3>\n

\nPossiamo quindi strutturare e aggregare efficacemente le informazioni in Confluence utilizzando i macro. Ma idealmente \u00e8 necessario fare in modo che le nuove informazioni siano subito strutturate e integrate in tutti i meccanismi di aggregazione gi\u00e0 esistenti.<\/p>\n

Qui entra in gioco la combinazione di macro e modelli. Per incentivare le persone a creare nuove pagine nel formato desiderato, puoi utilizzare il macro \"Crea da modello\". Questo aggiunge un pulsante alla pagina, che, una volta cliccato, crea una nuova pagina utilizzando il modello desiderato. In questo modo, incoraggi le persone a lavorare immediatamente nel formato che necessiti. <\/p>\n

\"Progettazione
\n
\nNel modello da cui consenti la creazione della pagina, devi previamente aggiungere etichette, il macro \"Propriet\u00e0 della pagina\" e una tabella delle propriet\u00e0 necessarie. Ti consiglio anche di includere istruzioni su quali valori dovrebbero essere utilizzati per riempire la pagina e i valori delle propriet\u00e0.<\/p>\n

\"Progettazione
\n
\nIl processo finale sar\u00e0 quindi il seguente:<\/p>\n

    \n
  1. Crei un modello per informazioni di un certo tipo.<\/li>\n
  2. In questo modello aggiungi etichette e propriet\u00e0 della pagina nel macro.<\/li>\n
  3. In qualsiasi luogo conveniente, crei una pagina principale con un pulsante, cliccando sul quale si genera una pagina figlia da un modello. <\/li>\n
  4. Consenti agli utenti di accedere alla pagina principale, che potrebbero generare le informazioni necessarie (secondo il modello richiesto, premendo il pulsante).<\/li>\n
  5. Raccogli un report sulle propriet\u00e0 della pagina attraverso le etichette che hai specificato nel modello.<\/li>\n
  6. Ti godi il fatto che hai tutte le informazioni necessarie in un formato conveniente. <\/li>\n<\/ol>\n

    \"Progettazione
    \n<\/p>\n

    Problemi inaspettati<\/h3>\n

    \nCome ingegnere della qualit\u00e0, posso affermare con certezza che nulla \u00e8 perfetto nel mondo. Anche le tabelle divine non sono prive di imperfezioni. E nel processo sopra menzionato ci sono insidie.<\/p>\n