{"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\/ro\/blog\/administrirovanie\/proektirovanie-v-confluence","title":{"rendered":"Proiectare \u00een Confluence","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

Salut tuturor! <\/p>\n

Numele meu este Masha, lucrez ca inginer QA \u00een grupul de companii Tinkoff. Activitatea \u00een QA implic\u0103 multe comunica\u021bii cu diferite persoane din echipe diverse, iar eu am fost \u0219i manager \u0219i lector pentru programe educa\u021bionale, astfel c\u0103 harta mea de comunica\u021bii a fost extrem de extins\u0103. \u0218i \u00eentr-un anumit moment, am explodat: am realizat c\u0103 nu mai pot, nu mai pot, nu mai pot umple tone de tabele \u0219i documente ilegibile. <\/p>\n

\"Proiectare
\n
\n<\/a><\/noindex>
\nCu siguran\u021b\u0103, fiecare dintre voi \u0219i-a imaginat acum despre ce vorbesc, \u0219i a tras o s\u0103geat\u0103 rece: liste de nume f\u0103r\u0103 o ordine alfabetic\u0103, tabele cu sute de coloane cu formatare str\u00e2mb\u0103, tabele cu mii de r\u00e2nduri \u00een care trebuie s\u0103 \u00ee\u021bi freci degetul pe roti\u021ba mouse-ului pentru a vedea titlul, tone de pagini de instruc\u021biuni nep\u0103strate \u00een ordine, sute de e-mailuri trimise unii altora cu date care trebuie analizate \u0219i sistematizate \u0219i \u00eenghesuite \u00een tabele la fel de ilegibile.<\/p>\n

\"Proiectare
\n
\n\u0218i iat\u0103 c\u0103, dup\u0103 ce m-am mai calmat, am decis s\u0103 scriu acest articol. Voi vorbi despre cum putem gestiona \u00een mod corect (chiar uneori confortabil) documenta\u021bia non-produs. Sper c\u0103 articolul se va r\u0103sp\u00e2ndi pe re\u021bea \u0219i nivelul haosului din departamentele din jurul dezvolt\u0103rii va sc\u0103dea pu\u021bin, iar oamenii (inclusiv eu) vor deveni pu\u021bin mai ferici\u021bi.<\/p>\n

\"Proiectare
\n<\/p>\n

Instrumente<\/h2>\n

\nDocumenta\u021bia de produs este adesea p\u0103strat\u0103 al\u0103turi de cod, ceea ce este bine. \u00cen schimb, documenta\u021bia non-produs este de obicei stocat\u0103 \u00een locuri diverse. Adesea, oamenii \u00eencearc\u0103 s\u0103 transfere informa\u021bii din diferite loca\u021bii \u00een Confluence, iar noi nu suntem o excep\u021bie. A\u0219adar, toat\u0103 povestea de mai departe este despre acesta.<\/p>\n

\u00cen general, Confluence este un motor wiki avansat. Permite lucrul cu date \u00een diferite forme de afi\u0219are: text formatat, tabele, diverse diagrame. Este un instrument foarte interesant \u0219i puternic, dar dac\u0103 nu \u0219tii cum s\u0103-l configurezi, vei ob\u021bine o nou\u0103 gr\u0103mad\u0103 de documente ilegibile. Te voi \u00eenv\u0103\u021ba cum s\u0103-l configurezi!<\/p>\n

\"Proiectare
\n<\/p>\n

Macrosuri<\/h2>\n

\nAproape toat\u0103 magia Confluence se bazeaz\u0103 pe macrosuri. Exist\u0103 foarte multe macrosuri \u0219i le po\u021bi combina \u00eentre ele. Acestea pot fi pl\u0103tite sau gratuite, urmeaz\u0103 diferite exemple de macrosuri cu linkuri c\u0103tre documenta\u021bia lor.<\/p>\n

Interfa\u021ba de lucru cu macrosurile este extrem de simpl\u0103. Pentru a ad\u0103uga un macros, trebuie s\u0103 dai clic pe plus \u0219i s\u0103 alegi elementul dorit din list\u0103.<\/p>\n

\"Proiectare
\n
\nDac\u0103 un macro este autosuficient, adic\u0103 nu necesit\u0103 inserarea altceva \u00een interior, acesta arat\u0103 ca un bloc.<\/p>\n

\"Proiectare
\n
\nDac\u0103 pentru func\u021bionarea macro-ului este nevoie s\u0103 se pun\u0103 ceva \u00een interiorul acestuia, el se prezint\u0103 ca un cadru.<\/p>\n

\"Proiectare
\n
\n\u00cen interiorul unui cadru se pot \u00eencadra oric\u00e2te alte cadre, at\u00e2ta timp c\u00e2t logic\u0103 exist\u0103 \u00een piramida voastr\u0103.<\/p>\n

\"Proiectare
\n
\nFiecare macro are o previzualizare: din aceasta se vede imediat dac\u0103 a\u021bi completat \u0219i configurat corect macro-ul.<\/p>\n

\u0218abloane<\/h2>\n

\nPe l\u00e2ng\u0103 macro-uri, exist\u0103 un instrument util de completare automat\u0103 a con\u021binutului - acesta este \u0219ablonul.
\n\u0218abloanele pot fi utilizate la crearea oric\u0103rei pagini: trebuie doar s\u0103 face\u021bi clic pe cele trei puncte de l\u00e2ng\u0103 butonul \u201eCreeaz\u0103\u201d \u0219i s\u0103 alege\u021bi \u0219ablonul dorit.<\/p>\n

\"Proiectare
\n
\nAtunci, \u00eentreaga con\u021binut pe care \u00eel are \u0219ablonul va fi ad\u0103ugat pe pagina creat\u0103.<\/p>\n

Oricine poate crea pagini din \u0219abloane, dar doar cei care au permisiuni pot crea sau edita \u0219abloanele \u00een sine. \u00centr-un \u0219ablon pot fi ad\u0103ugate instruc\u021biuni suplimentare despre cum ar trebui s\u0103 fie gestionat\u0103 pagina.<\/p>\n

\"Proiectare
\n<\/p>\n

Magia tabelelor<\/h2>\n

\nDe fapt, ca specialist tehnic, \u00eemi iubesc cu sinceritate tabelele \u0219i pot transforma aproape orice informa\u021bie \u00een ele (de\u0219i nu este \u00eentotdeauna eficient). Tabelele \u00een sine sunt clare, structurate, scalabile, magice!<\/p>\n

\"Proiectare
\n
\nDar chiar \u0219i o entitate remarcabil\u0103, cum este tabela, poate fi stricat. Dar poate fi utilizat\u0103 cu succes \u0219i chiar \u00eembun\u0103t\u0103\u021bit\u0103. Despre asta mai jos.<\/p>\n

Filtrare (plugin pl\u0103tit)<\/h3>\n

\nOrice tabel uria\u0219 \u0219i ilizibil poate fi f\u0103cut pu\u021bin mai pu\u021bin uria\u0219 \u0219i pu\u021bin mai lizibil prin filtrare. Pentru aceasta, poate fi utilizat un macro pl\u0103tit. \u201eFiltru tabele\u201d<\/a><\/noindex>.<\/p>\n

\u00cen interiorul acestui macro trebuie s\u0103 introduci tabela (poate chiar cea mai ur\u00e2t\u0103, important e s\u0103 o incluzi complet). \u00cen macro pot fi selectate coloanele pentru filtrare dintr-o list\u0103 derulant\u0103, filtrul text, numeric \u0219i filtrul de date. <\/p>\n

\"Proiectare
\n
\nImagina\u021bi-v\u0103 c\u0103 toat\u0103 informa\u021bia referitoare la candida\u021bi pentru toate posturile disponibile este \u00eenregistrat\u0103 sub form\u0103 de list\u0103 tabelar\u0103. Evident, aceasta nu este sortat\u0103 - oamenii vin la interviuri nu \u00een ordine alfabetic\u0103. Iar voi trebuie s\u0103 \u00een\u021belege\u021bi dac\u0103 a\u021bi avut un interviu cu un anumit candidat anterior. Tot ce trebuie s\u0103 face\u021bi este s\u0103 introduce\u021bi acest haos \u00een macro-ul de filtrare, s\u0103 ad\u0103uga\u021bi un filtru text pe nume \u0219i voila, informa\u021bia este pe ecranul vostru.<\/p>\n

\"Proiectare
\n
\nEste important de remarcat faptul c\u0103 filtrarea tabelelor mari poate afecta func\u021bionarea sistemului \u0219i timpul de \u00eenc\u0103rcare a paginilor. Prin urmare, a crea un tabel imens cu filtru este o solu\u021bie temporar\u0103; ar fi mai bine s\u0103 concepe\u021bi un proces \u00een care utilizatorii s\u0103 nu fie nevoi\u021bi s\u0103 creeze tabele mari \u0219i greu de citit (un exemplu de proces va fi la finalul articolului).<\/p>\n

Sortare (plugin pl\u0103tit)<\/h3>\n

\nPrin intermediul macro-ului magic \u201eFiltru tabele\u201d<\/a><\/noindex> se poate, de asemenea, stabili o sortare implicit\u0103 pentru orice coloan\u0103 \u0219i numerota r\u00e2ndurile. Sau se poate face clic pe orice coloan\u0103 a tabelului inclus \u00een macro-ul filtrului, iar acesta va fi sortat dup\u0103 aceast\u0103 coloan\u0103. <\/p>\n

\"Proiectare
\n
\nDe exemplu, ave\u021bi acela\u0219i tabel cu candida\u021bi \u0219i trebuie s\u0103 estima\u021bi c\u00e2te interviuri au avut loc \u00eentr-o anumit\u0103 lun\u0103 \u2014 sortati dup\u0103 dat\u0103 \u0219i bucura\u021bi-v\u0103.<\/p>\n

Tabele pivotante (plugin pl\u0103tit)<\/h3>\n

\nAcum s\u0103 trecem la un caz mai interesant. Imagineaz\u0103-\u021bi c\u0103 tabelul t\u0103u este imens \u0219i trebuie s\u0103 calculezi ceva pe baza lui. Desigur, po\u021bi s\u0103-l copiezi \u00een Excel, s\u0103 faci calculele necesare \u0219i s\u0103 impor\u021bi datele \u00eenapoi \u00een Confluence. Sau po\u021bi aplica o dat\u0103 macro-ul \u201eTabel pivotant\u201d<\/a><\/noindex> \u0219i s\u0103 ob\u021bii acela\u0219i rezultat, doar c\u0103 acesta va fi \u0219i actualizat.<\/p>\n

De exemplu: ai un tabel care adun\u0103 datele tuturor angaja\u021bilor \u2014 unde se afl\u0103 geografic \u0219i ce func\u021bii ocup\u0103. Pentru a num\u0103ra c\u00e2\u021bi oameni sunt \u00een fiecare ora\u0219, trebuie s\u0103 selectezi \u00een macro-ul \u201eTabel pivotant\u201d r\u00e2ndul pe care se agreg\u0103 datele (loca\u021bia) \u0219i tipul de opera\u021biune (adunare).<\/p>\n

\"Proiectare
\n
\nDesigur, se pot grupa dup\u0103 mai multe criterii simultan, toate posibilit\u0103\u021bile pot fi consultate \u00een documenta\u021bie<\/a><\/noindex>.<\/p>\n

Diagram\u0103 (plugin pl\u0103tit)<\/h3>\n

\nA\u0219a cum am men\u021bionat, nu toat\u0103 lumea iube\u0219te tabelele la fel de mult ca mine. Din p\u0103cate, managerii, \u00een majoritatea lor, nu le plac deloc. Cu toate acestea, toat\u0103 lumea iube\u0219te diagramele colorate \u0219i vibrante.
\nCreatorii Confluence, f\u0103r\u0103 \u00eendoial\u0103, erau con\u0219tien\u021bi de acest lucru (din p\u0103cate, \u0219i ei au \u0219efi care iubesc rapoartele \u0219i diagramele, nu-i a\u0219a?). Prin urmare, po\u021bi utiliza macro-ul magic \u201eDiagram\u0103 din tabel\u201d<\/a><\/noindex>. Acest macro necesit\u0103 s\u0103 pui tabelul pivotant din punctul anterior \u0219i, voil\u00e0 \u2014 datele tale plictisitoare \u0219i gri sunt frumos vizualizate.<\/p>\n

\"Proiectare
\n
\nDesigur, acest macro are \u0219i set\u0103ri. Leg\u0103tura c\u0103tre documenta\u021bia oric\u0103rui macro poate fi g\u0103sit\u0103 \u00een modul de editare al acestuia.<\/p>\n

Simplitatea agreg\u0103rii<\/h2>\n

\nInforma\u021biile din punctele anterioare nu v-au fost cu siguran\u021b\u0103 o noutate. Dar acum \u0219ti\u021bi cu siguran\u021b\u0103 s\u0103 folosi\u021bi macrocomenzi, iar eu pot trece la partea mai interesant\u0103 a articolului.<\/p>\n

\"Proiectare
\n<\/p>\n

Etichete<\/h3>\n

\nEste nepl\u0103cut c\u00e2nd oamenii p\u0103streaz\u0103 informa\u021biile \u00eentr-un singur articol nestrukturat sau \u00eentr-un tabel imens. \u0218i mai r\u0103u este c\u00e2nd p\u0103r\u021bi din aceste informa\u021bii sunt nu doar greu de citit, ci \u0219i \u00eempr\u0103\u0219tiate prin Confluence. Din fericire, exist\u0103 posibilitatea de a str\u00e2nge informa\u021biile \u00eempr\u0103\u0219tiate la un loc. Pentru aceasta, trebuie s\u0103 folosi\u021bi etichetele<\/a><\/noindex> (cunoscute tuturor din re\u021belele sociale).<\/p>\n

\"Proiectare
\n
\nPe orice pagin\u0103 se pot ad\u0103uga un num\u0103r nelimitat de etichete. Dac\u0103 da\u021bi clic pe o etichet\u0103, ve\u021bi ajunge pe o pagin\u0103 de agregare, unde sunt linkuri c\u0103tre toate materialele cu acea etichet\u0103, precum \u0219i cu un set de etichete \u00eenrudite. Etichetele \u00eenrudite sunt cele care apar frecvent pe aceea\u0219i pagin\u0103.<\/p>\n

\"Proiectare
\n<\/p>\n

Propriet\u0103\u021bile paginilor<\/h3>\n

\nPe pagin\u0103 se poate ad\u0103uga un alt macrocomand\u0103 interesant pentru structurarea informa\u021biilor \u2014 \u201ePropriet\u0103\u021bile paginilor\u201d<\/a><\/noindex>. \u00cen interiorul s\u0103u trebuie s\u0103 introduce\u021bi un tabel cu dou\u0103 coloane, prima fiind cheia, iar a doua \u2014 valoarea propriet\u0103\u021bii. De asemenea, macrocomanda poate fi ascuns\u0103 de pe pagin\u0103, astfel \u00eenc\u00e2t s\u0103 nu perturbe lectura con\u021binutului, dar pagina va fi totu\u0219i marcat\u0103 cu cheile necesare.<\/p>\n

\"Proiectare
\n
\nAten\u021bie la ID \u2014 este convenabil s\u0103-l seta\u021bi pentru a asocia diferite grupuri de propriet\u0103\u021bi pe pagini diferite (sau chiar diferite grupuri de propriet\u0103\u021bi pe aceea\u0219i pagin\u0103). <\/p>\n

Rapoarte<\/h3>\n

\nPe baza etichetelor se pot genera rapoarte. De exemplu, macrocomanda \u201eRaport despre con\u021binut\u201d<\/a><\/noindex> str\u00e2nge toate paginile cu un set specific de etichete.<\/p>\n

\"Proiectare
\n
\nDar un raport mai interesant este macrocomanda \u201eRaport despre propriet\u0103\u021bile paginii\u201d<\/a><\/noindex>. Acesta str\u00e2nge de asemenea toate paginile cu un set specific de etichete, dar nu doar le listeaz\u0103, ci creeaz\u0103 un tabel (observa\u021bi leg\u0103tura cu \u00eenceputul articolului?), \u00een care coloanele reprezint\u0103 cheile propriet\u0103\u021bilor paginii.<\/p>\n

\"Proiectare
\n
\nRezultatul este un tabel de sumar cu informa\u021bii din diferite surse. Este pl\u0103cut c\u0103 are func\u021bii convenabile: design adaptabil, sortare pe orice coloan\u0103. De asemenea, acest tabel de raport poate fi configurat \u00een cadrul macrocomenzii. <\/p>\n

\"Proiectare
\n
\nC\u00e2nd face\u021bi configura\u021bia, pute\u021bi elimina anumite coloane din raport, stabili un st\u0103ri implicit\u0103 sau un num\u0103r de \u00eenregistr\u0103ri afi\u0219ate. De asemenea, pute\u021bi defini ID-ul propriet\u0103\u021bii paginii pentru a vedea doar informa\u021biile necesare.<\/p>\n

De exemplu, ave\u021bi mai multe pagini ale angaja\u021bilor, iar aceste pagini au un set de propriet\u0103\u021bi despre persoan\u0103: ce nivel are, unde se afl\u0103, c\u00e2nd a venit \u00een echip\u0103 \u0219i a\u0219a mai departe. Aceste propriet\u0103\u021bi sunt marcate ID = employee_inf<\/i>. \u0218i exist\u0103 un al doilea set de propriet\u0103\u021bi pe aceea\u0219i pagin\u0103, \u00een care este adunat\u0103 informa\u021bia despre persoan\u0103, ca parte a echipei: ce rol are persoana, \u00een ce echip\u0103 se afl\u0103 \u0219i a\u0219a mai departe. Aceste propriet\u0103\u021bi sunt marcate ID = team_inf<\/i>. Astfel, la generarea raportului, pute\u021bi extrage informa\u021biile pe baza unui singur ID sau simultan pentru ambele - a\u0219a cum este mai convenabil.<\/p>\n

Frumuse\u021bea acestui mod de abordare const\u0103 \u00een faptul c\u0103 oricine poate crea tabela de informa\u021bii de care are nevoie, care nu va dubla nimic \u0219i se va actualiza la fiecare actualizare a paginii principale. De exemplu: liderul de echip\u0103 nu \u00eei pas\u0103 c\u00e2nd \u0219i-au \u00eenceput lucrul dezvoltatorii s\u0103i, dar este important ce rol joac\u0103 fiecare dintre ei \u00een echip\u0103. Liderul de echip\u0103 va crea un raport pentru echip\u0103. Iar contabilului nu \u00eei pas\u0103 cine ce rol are, dar este important\u0103 func\u021bia - el va crea un raport pe func\u021bii. Astfel, sursa de informa\u021bie nu va fi duplicat\u0103 sau mutat\u0103.<\/p>\n

Procesul final<\/h2>\n

<\/p>\n

Instruc\u021biune<\/h3>\n

\nA\u0219adar, putem structura frumos \u0219i eficient informa\u021bia \u00een Confluence pe exemplul utiliz\u0103rii macro-urilor. Dar \u00een ideal, ar trebui s\u0103 facem astfel \u00eenc\u00e2t noile informa\u021bii s\u0103 fie imediat structurate \u0219i s\u0103 ajung\u0103 \u00een toate mecanismele de agregare deja folosite.<\/p>\n

Aici vine \u00een ajutor combina\u021bia de macro-uri \u0219i \u0219abloane. Pentru a determina oamenii s\u0103 creeze pagini noi \u00een formatul dorit, pute\u021bi utiliza macro-ul \u201eCreeaz\u0103 din \u0219ablon\u201d. Acesta adaug\u0103 pe pagin\u0103 un buton, ap\u0103s\u00e2nd pe care se creeaz\u0103 o pagin\u0103 nou\u0103 din \u0219ablonul dorit. Astfel, \u00eei determina\u021bi pe oameni s\u0103 lucreze imediat \u00een formatul dorit. <\/p>\n

\"Proiectare
\n
\n\u00cen \u0219ablonul din care permite\u021bi crearea paginii, trebuie s\u0103 ad\u0103uga\u021bi din timp etichete, macro-ul \u201ePropriet\u0103\u021bi ale paginii\u201d \u0219i tabelul cu propriet\u0103\u021bile dorite. De asemenea, recomand s\u0103 ad\u0103uga\u021bi instruc\u021biuni despre ce valori ar trebui s\u0103 completeze \u00een pagin\u0103 \u0219i valorile propriet\u0103\u021bilor.<\/p>\n

\"Proiectare
\n
\nAtunci, procesul final va ar\u0103ta astfel:<\/p>\n

    \n
  1. Creezi un \u0219ablon pentru informa\u021bii de un anumit tip.<\/li>\n
  2. \u00cen acest \u0219ablon ad\u0103uga\u021bi etichete \u0219i propriet\u0103\u021bile paginii \u00een macro.<\/li>\n
  3. \u00cen orice loc convenabil, crea\u021bi o pagin\u0103 r\u0103d\u0103cin\u0103 cu un buton, la click-ul c\u0103ruia se va crea o pagin\u0103 fiic\u0103 dintr-un \u0219ablon. <\/li>\n
  4. Permite\u021bi utilizatorilor s\u0103 acceseze pagina r\u0103d\u0103cin\u0103, care pot genera informa\u021biile necesare (dup\u0103 \u0219ablonul dorit, ap\u0103s\u00e2nd pe buton).<\/li>\n
  5. Aduna\u021bi un raport pentru propriet\u0103\u021bile paginii prin etichetele pe care le-a\u021bi specificat \u00een \u0219ablon.<\/li>\n
  6. V\u0103 bucura\u021bi: ave\u021bi toate informa\u021biile necesare \u00eentr-un format convenabil. <\/li>\n<\/ol>\n

    \"Proiectare
    \n<\/p>\n

    Capcane<\/h3>\n

    \nCa inginer de calitate, pot afirma cu \u00eencredere c\u0103 nu exist\u0103 nimic perfect \u00een lume. Chiar \u0219i tabele divine sunt imperfecte. \u0218i \u00een procesul men\u021bionat mai sus, exist\u0103 capcane.<\/p>\n