{"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, lavoro come ingegnere della qualit\u00e0 nel gruppo di aziende Tinkoff. Il lavoro di QA prevede molte comunicazioni con persone diverse provenienti da vari team, e io, essendo stata anche manager e docente di programmi educativi, ho avuto una rete di comunicazioni molto ampia. A un certo punto, per\u00f2, ho avuto un'esplosione: ho capito che non potevo pi\u00f9, non potevo pi\u00f9, non potevo pi\u00f9 riempire tonnellate di tabelle e documenti illeggibili. <\/p>\n

\"Progettazione
\n
\n<\/a><\/noindex>
\nSicuramente ognuno di voi ora ha immaginato ci\u00f2 di cui parlo e ha sudato freddo: elenchi di nomi privi di ordine alfabetico, tabelle con centinaia di colonne con layout disordinati, tabelle con migliaia di righe in cui bisogna strofinare il dito sulla rotellina del mouse per vedere il titolo, tonnellate di pagine di istruzioni non numerate, centinaia di email inoltrate l'una all'altra con dati da analizzare e sistematizzare e inserire in altrettante tabelle illeggibili.<\/p>\n

\"Progettazione
\n
\nE cos\u00ec, quando mi sono un po' calmata, ho deciso di scrivere questo articolo. Parler\u00f2 di come gestire normalmente (a volte anche in modo comodo) la documentazione non di prodotto. Spero che l'articolo venga condiviso in rete e che il livello di caos nei vari reparti che lavorano a contatto con lo sviluppo diminuisca almeno un pochino, e che le persone (compresa me) diventino un po' pi\u00f9 felici.<\/p>\n

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

Strumenti<\/h2>\n

\nLa documentazione di prodotto \u00e8 spesso archiviata vicino al codice, e questo \u00e8 positivo. La documentazione non di prodotto, invece, di solito viene conservata in modo casuale. Spesso le persone cercano di trasferire informazioni da diversi luoghi in Confluence, e noi non facciamo eccezione. Quindi, tutto il resto del racconto parler\u00e0 di questo.<\/p>\n

In generale, Confluence \u00e8 un avanzato motore wiki. Permette di lavorare con dati in varie forme di visualizzazione: testo formattato, tabelle, vari grafici. \u00c8 uno strumento molto interessante e potente, ma se non sai come prepararlo, otterrai solo un'altra discarica di documenti illeggibili. Ti insegner\u00f2 a prepararlo!<\/p>\n

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

Macro<\/h2>\n

\nQuasi tutta la magia di Confluence si basa sulle macro. Ce ne sono molte, e possono essere combinate tra loro. Alcune sono a pagamento e altre gratuite; ci saranno vari esempi di macro con link alla documentazione per ciascuna di esse.<\/p>\n

L'interfaccia per lavorare con le macro \u00e8 estremamente semplice. Per aggiungere una macro, basta cliccare sul segno pi\u00f9 e selezionare l'elemento desiderato dall'elenco.<\/p>\n

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

\"Progettazione
\n
\nSe per il funzionamento del macro \u00e8 necessario inserire qualcosa al suo interno, appare come una cornice.<\/p>\n

\"Progettazione
\n
\nAllo stesso modo, \u00e8 possibile inserire quante pi\u00f9 cornici si desidera, purch\u00e9 ci sia logica nella vostra piramide.<\/p>\n

\"Progettazione
\n
\nOgni macro ha un'anteprima: qui si pu\u00f2 vedere subito se il macro \u00e8 stato compilato e configurato correttamente.<\/p>\n

Modelli<\/h2>\n

\nOltre ai macro, esiste uno strumento comodo per il precompilamento dei contenuti: \u00e8 il modello.
\nI modelli possono essere utilizzati nella creazione di qualsiasi pagina: basta fare clic sui tre punti accanto al pulsante 'Crea' e selezionare il modello desiderato.<\/p>\n

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

Chiunque pu\u00f2 creare pagine da modelli, ma solo chi ha i diritti pu\u00f2 creare o modificare i modelli stessi. \u00c8 possibile aggiungere istruzioni aggiuntive all'interno del modello su come gestire la pagina.<\/p>\n

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

La magia delle tabelle<\/h2>\n

\nIn realt\u00e0, come tecnico, amo teneramente le tabelle e posso quasi racchiudere qualsiasi informazione in esse (anche se non sempre \u00e8 efficace). Le tabelle sono chiare, strutturate, scalabili, magiche!<\/p>\n

\"Progettazione
\n
\nMa anche una meravigliosa entit\u00e0 come la tabella pu\u00f2 essere rovinata. Al contrario, pu\u00f2 essere utilizzata con successo e persino migliorata. Di questo parleremo 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. Per questo si pu\u00f2 utilizzare un macro a pagamento. \u2018Filtro tabelle\u2019<\/a><\/noindex>.<\/p>\n

All'interno di questo macro bisogna inserire la tabella (pu\u00f2 anche essere la pi\u00f9 brutta, l'importante \u00e8 inserirla per intero). All'interno del macro \u00e8 possibile selezionare colonne per il filtro da un elenco a discesa, un filtro testuale, numerico e un filtro per date. <\/p>\n

\"Progettazione
\n
\nImmaginate di registrare tutte le informazioni sui candidati per tutte le posizioni in un elenco tabellare. Naturalmente, non \u00e8 ordinato - le persone non si presentano ai colloqui in ordine alfabetico. E voi dovete capire se avete gi\u00e0 fatto un colloquio con un determinato candidato. Basta inserire questo caos nel macro di filtraggio, aggiungere un filtro testuale per il cognome - ed ecco, l'informazione \u00e8 sullo schermo.<\/p>\n

\"Progettazione
\n
\nVa notato che la filtrazione di enormi tabelle pu\u00f2 influenzare le prestazioni del sistema e il tempo di caricamento delle pagine, quindi infilare un'enorme tabella in un filtro \u00e8 una soluzione temporanea; \u00e8 meglio strutturare il processo in modo che le persone non debbano creare tabelle enormi e illeggibili (un esempio di processo sar\u00e0 alla fine dell'articolo).<\/p>\n

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

\nCon il magico macro \u2018Filtro tabelle\u2019<\/a><\/noindex> \u00e8 possibile anche impostare l'ordinamento predefinito su qualsiasi colonna e numerare le righe. Oppure, cliccando su qualsiasi colonna della tabella infilata nel macro filtro, si effettuer\u00e0 l'ordinamento su quella colonna. <\/p>\n

\"Progettazione
\n
\nAd esempio, avete la stessa tabella con i candidati e volete calcolare quante interviste sono state svolte in un determinato mese: ordinate per data e godetevi il risultato.<\/p>\n

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

\nOra passiamo a un caso pi\u00f9 interessante. Immaginate che la vostra tabella sia enorme e dobbiate fare dei calcoli su di essa. Certo, si pu\u00f2 copiare in Excel, fare i calcoli necessari e caricare nuovamente i dati in Confluence. Oppure si pu\u00f2 applicare una volta il macro \"Tabella pivot\"<\/a><\/noindex> e ottenere lo stesso risultato, ma con la funzione di aggiornamento.<\/p>\n

Ad esempio: avete una tabella che raccoglie i dati di tutti i dipendenti \u2014 dove si trovano e quali ruoli ricoprono. Per contare quante persone ci sono in ogni citt\u00e0, dovete selezionare nel macro \"Tabella pivot\" la riga per cui aggregare i dati (posizione) e il tipo di operazione (somma).<\/p>\n

\"Progettazione
\n
\nNaturalmente, \u00e8 possibile raggruppare per pi\u00f9 criteri contemporaneamente; tutte le possibilit\u00e0 possono essere visionate nella documentazione<\/a><\/noindex>.<\/p>\n

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

\nCome ho gi\u00e0 detto, non tutti amano le tabelle tanto quanto me. Sfortunatamente, i manager, per la maggior parte, non le amano affatto. Tuttavia, tutti adorano i grafici colorati e vivaci.
\nI creatori di Confluence ne erano sicuramente consapevoli (sicuramente hanno anche un dirigente che ama i report e i grafici, che ci vuoi fare). Pertanto, \u00e8 possibile utilizzare il magico macro \"Grafico da tabella\"<\/a><\/noindex>. In questo macro dovete inserire la tabella pivot del punto precedente e voil\u00e0 \u2014 i vostri dati grigi e noiosi sono bellamente visualizzati.<\/p>\n

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

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

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

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

Tag<\/h3>\n

\n\u00c8 un problema quando le persone conservano informazioni in un'unica grande voce disorganizzata o in un'enorme tabella. Ancora peggio \u00e8 quando parti di queste informazioni non sono solo poco leggibili, ma sono anche sparse in giro su Confluence. Fortunatamente, esiste la possibilit\u00e0 di raccogliere queste informazioni in un unico luogo. Per questo motivo, \u00e8 necessario utilizzare etichetta<\/a><\/noindex> (note a tutti per i tag dei social media).<\/p>\n

\"Progettazione
\n
\nSu ogni pagina \u00e8 possibile aggiungere qualsiasi numero di etichette. Se cliccate su un'etichetta, verrete portati a una pagina di aggregazione, dove sono presenti collegamenti a tutti i materiali con quell'etichetta, nonch\u00e9 a un insieme di etichette correlate. Le etichette correlate sono quelle che si trovano frequentemente sulla stessa pagina.<\/p>\n

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

Propriet\u00e0 della pagina<\/h3>\n

\n\u00c8 possibile aggiungere un altro interessante macro alla pagina per strutturare le informazioni \u2014 \u00abPropriet\u00e0 della pagina\u00bb<\/a><\/noindex>. All'interno di esso, \u00e8 necessario fornire una tabella di due colonne, la prima sar\u00e0 la chiave e la seconda il valore della propriet\u00e0. Inoltre, \u00e8 possibile nascondere il macro dalla pagina, in modo che non distragga dalla lettura del contenuto, ma la pagina sar\u00e0 comunque contrassegnata con le chiavi necessarie.<\/p>\n

\"Progettazione
\n
\nFate attenzione all'ID \u2014 \u00e8 utile impostarlo per applicare diversi gruppi di propriet\u00e0 su pagine diverse (o anche diversi gruppi di propriet\u00e0 sulla stessa pagina). <\/p>\n

Rapporti<\/h3>\n

\n\u00c8 possibile raccogliere report tramite le etichette. Ad esempio, il macro \u00abRapporto sui contenuti\u00bb<\/a><\/noindex> raccoglie tutte le pagine con un determinato insieme di etichette.<\/p>\n

\"Progettazione
\n
\nMa il rapporto pi\u00f9 interessante \u00e8 il macro \u00abRapporto sulle propriet\u00e0 della pagina\u00bb<\/a><\/noindex>. Anche questo raccoglie tutte le pagine con un determinato insieme di etichette, ma non si limita a fornire un elenco; compila una tabella (capite il collegamento con l'inizio dell'articolo?), i cui colonne sono le chiavi delle propriet\u00e0 della pagina.<\/p>\n

\"Progettazione
\n
\nSi ottiene quindi una tabella pivot delle informazioni provenienti da diverse fonti. \u00c8 piacevole che abbia funzionalit\u00e0 convenienti: layout reattivo, ordinamento per qualsiasi colonna. Inoltre, \u00e8 possibile configurare una tabella di report all'interno del macro. <\/p>\n

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

Ad esempio, hai molte pagine di dipendenti, e ciascuna di queste pagine ha un insieme di propriet\u00e0 riguardanti la persona: a quale livello si trova, dove si trova, 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 la persona, in quale team si trova e cos\u00ec via. Queste propriet\u00e0 sono contrassegnate ID = team_inf<\/i>. Quindi, durante la creazione di un rapporto, puoi estrarre solo informazioni relative a un unico ID o a entrambi \u2014 come preferisci.<\/p>\n

Il bello di questo approccio \u00e8 che ciascuno pu\u00f2 creare la tabella informativa di cui ha bisogno, che non duplicher\u00e0 nulla e si aggiorner\u00e0 quando viene aggiornata la pagina principale. Ad esempio: al team leader non interessa quando i suoi sviluppatori sono stati assunti, ma \u00e8 importante sapere quale ruolo ciascuno di loro svolge nel team. Il team leader raccoglier\u00e0 il report sul team. E al contabile non importa chi svolge quale ruolo, ma le posizioni sono importanti \u2014 raccoglier\u00e0 il report sulle posizioni. In questo modo, la fonte delle informazioni non verr\u00e0 duplicata o trasferita.<\/p>\n

Processo finale<\/h2>\n

<\/p>\n

Istruzioni<\/h3>\n

\nQuindi, possiamo strutturare in modo elegante ed aggregare in modo efficace le informazioni in Confluence utilizzando i macros. Ma in ideale, dovrebbe essere fatto in modo che le nuove informazioni siano immediatamente strutturate e rientrino in tutti i meccanismi di aggregazione gi\u00e0 utilizzati.<\/p>\n

Qui entra in gioco la combinazione di macros e template. Per incoraggiare le persone a creare nuove pagine nel formato corretto, puoi utilizzare il macro \"Crea da modello\". Questo aggiunge un pulsante alla pagina, cliccando sul quale viene creata una nuova pagina dal template necessario. In questo modo costringi le persone a lavorare sin dall'inizio nel formato che desideri. <\/p>\n

\"Progettazione
\n
\nNel template da cui si permette di creare la pagina, \u00e8 necessario aggiungere in anticipo i tag, il macro \"Propriet\u00e0 della pagina\" e la tabella delle propriet\u00e0 necessarie. Consiglio anche di aggiungere istruzioni su quali valori devono essere inseriti nella pagina e sui valori delle propriet\u00e0.<\/p>\n

\"Progettazione
\n
\nQuindi il processo finale apparir\u00e0 cos\u00ec:<\/p>\n

    \n
  1. Crei un template per informazioni di un certo tipo.<\/li>\n
  2. In questo template aggiungi tag e propriet\u00e0 della pagina nel macro.<\/li>\n
  3. In qualsiasi luogo conveniente, crei una pagina principale con un pulsante, cliccando sul quale viene creata una pagina secondaria da un modello. <\/li>\n
  4. Permetti agli utenti di accedere alla pagina principale, che potrebbero generare le informazioni necessarie (secondo il modello richiesto, cliccando sul pulsante).<\/li>\n
  5. Raccogli un report sugli attributi della pagina tramite i tag che hai specificato nel modello.<\/li>\n
  6. Ti rallegra: hai tutte le informazioni necessarie in un formato comodo. <\/li>\n<\/ol>\n

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

    Inconvenienti<\/h3>\n

    \nIn qualit\u00e0 di ingegnere della qualit\u00e0, posso affermare con certezza che nulla di perfetto esiste al mondo. Anche le tabelle divine non sono perfette. Ci sono delle insidie nel processo sopra descritto.<\/p>\n