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

Pozdrav svima! <\/p>\n

Zovem se Ma\u0161a, radim kao in\u017eenjer kvalitete u grupi Tinkoff. QA posao zahtijeva puno komunikacije s raznim ljudima iz razli\u010ditih timova, a ja sam tako\u0111er bila menad\u017eer i predava\u010d obrazovnih programa, tako da je moja komunikacijska mre\u017ea bila maksimalno \u0161iroka. I u nekom trenutku eksplodirala sam: shvatila sam da vi\u0161e ne mogu, ne mogu, ne mogu ispunjavati paklene tone ne\u010ditljivih tablica i dokumenata. <\/p>\n

\"Projektiranje
\n
\n<\/a><\/noindex>
\nSigurno je svatko od vas sada zamislio ono o \u010demu govorim i oblili ste se hladnim znojem: liste prezimena bez abecednog reda, tablice s stotinu kolona s pomaknutim formatiranjem, tablice s tisu\u0107ama redaka, u kojima morate trljati prst o kota\u010di\u0107 mi\u0161a da biste vidjeli naslov, tone stranica nepro numeriranih uputa, stotine poruka koje se \u0161alju jedni drugima s podacima koje treba analizirati i sistematizirati te gurnuti u jednake ne\u010ditljive tablice.<\/p>\n

\"Projektiranje
\n
\nI tako, kad sam se malo smirila, odlu\u010dila sam napisati ovaj \u010dlanak. Pri\u010dat \u0107u o tome kako se mo\u017ee normalno (\u010dak i povremeno ugodno) voditi razne neproizvodne dokumentacije. Nadam se da \u0107e \u010dlanak zaokru\u017eiti mre\u017eu i razina pakla u obli\u017enjim razvojnim odjelima barem malo opasti, a ljudi (uklju\u010duju\u0107i i mene) postati malo sretniji.<\/p>\n

\"Projektiranje
\n<\/p>\n

Alati<\/h2>\n

\nProizvodna dokumentacija obi\u010dno se \u010duva uz kod, \u0161to je dobro. A neproizvodna dokumentacija obi\u010dno se \u010duva gdje god stigne. \u010cesto ljudi poku\u0161avaju prenijeti informacije iz raznih mjesta u Confluence, a nismo iznimka. Tako da \u0107e cijela daljnja pri\u010da biti o njemu.<\/p>\n

Uglavnom, Confluence je napredni wiki sustav. Omogu\u0107ava rad s podacima u razli\u010ditim prikazima: formatirani tekst, tablice, razne dijagrame. To je vrlo zanimljiv i mo\u0107an alat, ali ako ne znate kako ga pripremiti, dobit \u0107ete jo\u0161 jedan sme\u0107ar ne\u010ditljivih dokumenata. Nau\u010dit \u0107u vas kako ga pripremiti!<\/p>\n

\"Projektiranje
\n<\/p>\n

Makroi<\/h2>\n

\nGotovo sva \u010darolija Confluencea temelji se na makroima. Postoji mnogo makroa i mogu se kombinirati me\u0111usobno. Ima ih i pla\u0107enih i besplatnih, a slijede razli\u010diti primjeri makroa s poveznicama na dokumentaciju za njih.<\/p>\n

Su\u010delje za rad s makroima je maksimalno jednostavno. Da biste dodali makro, morate pritisnuti plus i odabrati \u017eeljeni element s popisa.<\/p>\n

\"Projektiranje
\n
\nAko je makro samodostatan, \u0161to zna\u010di da ne zahtijeva umetanje dodatnog sadr\u017eaja unutar sebe, izgleda kao blok.<\/p>\n

\"Projektiranje
\n
\nAko je potrebno ne\u0161to smjestiti unutar makra da bi on funkcionirao, izgleda kao okvir.<\/p>\n

\"Projektiranje
\n
\nMo\u017eete unutar jednog okvira smjestiti koliko god \u017eelite drugih, sve dok u va\u0161oj piramidi postoji logika.<\/p>\n

\"Projektiranje
\n
\nSvaki makro ima pregled: odmah mo\u017eete vidjeti jeste li ispravno ispunili i postavili makro.<\/p>\n

Predlo\u0161ci<\/h2>\n

\nOsim makroa, postoji i zgodan alat za predpunjenje sadr\u017eaja - to je predlo\u017eak.
\nPredlo\u0161ke mo\u017eete koristiti prilikom izrade bilo koje stranice: jednostavno kliknite na tri to\u010dke pored gumba 'Kreiraj' i odaberite \u017eeljeni predlo\u017eak.<\/p>\n

\"Projektiranje
\n
\nTada \u0107e sva sadr\u017eaj iz predlo\u0161ka biti dodan na stvorenu stranicu.<\/p>\n

Stranice iz predlo\u017eaka mo\u017ee izraditi svatko, a samo oni koji imaju ovla\u0161tenja mogu stvarati ili ure\u0111ivati same predlo\u0161ke. U predlo\u017eak mo\u017eete dodati dodatne upute o tome kako treba voditi stranicu.<\/p>\n

\"Projektiranje
\n<\/p>\n

\u010carolija tablica<\/h2>\n

\nZapravo, kao tehni\u010dar, nje\u017eno volim tablice i mogu gotovo svaku informaciju obraditi kroz njih (iako to nije uvijek u\u010dinkovito). Tablice su same po sebi jasne, strukturirane, skalabilne, \u010darobne!<\/p>\n

\"Projektiranje
\n
\nAli \u010dak i tako divnu stvar kao \u0161to je tablica mo\u017eete pokvariti. No, mo\u017eete je uspje\u0161no iskoristiti i \u010dak pobolj\u0161ati. O tome vi\u0161e u nastavku.<\/p>\n

Filtriranje (pla\u0107eni dodatak)<\/h3>\n

\nSvaku ogromnu, ne\u010ditljivu tablicu mo\u017eete u\u010diniti malo manje ogromnom i ne\u0161to \u010ditljivijom pomo\u0107u filtriranja. Za to mo\u017eete koristiti pla\u0107eni makro \u201eFiltriraj tablice\u201c<\/a><\/noindex>.<\/p>\n

Unutar ovog makra trebate smjestiti tablicu (mo\u017eete \u010dak i onu najru\u017eniju, samo je va\u017eno staviti je u cijelosti). U makru mo\u017eete odabrati stupce za filtriranje s padaju\u0107im popisom, tekstualnog filtra, numeri\u010dkog i filtra prema datumima. <\/p>\n

\"Projektiranje
\n
\nZamislite da se sve informacije o kandidatima za sve radne pozicije zapisuju u tabli\u010dni popis. Naravno, to nije sortirano \u2014 ljudi ne dolaze na razgovore po abecedi. A vi trebate shvatiti jeste li ranije obavili razgovor s odre\u0111enim kandidatom. Samo trebate smjestiti ovaj kaos u makro filtra, dodati tekstualni filtar prema prezimenu \u2014 i voila, informacije su vam na ekranu.<\/p>\n

\"Projektiranje
\n
\nVa\u017eno je napomenuti da filtriranje velikih tablica mo\u017ee utjecati na rad sustava i vrijeme u\u010ditavanja stranica, stoga je umetanje velike tablice u filtriranje privremeno rje\u0161enje; bolje je organizirati proces tako da se ljudima ne mora stvarati velike, te\u0161ke za \u010ditanje tablice (primjer procesa bit \u0107e na kraju \u010dlanka).<\/p>\n

Sortiranje (pla\u0107eni dodatak)<\/h3>\n

\nPomo\u0107u \u010darobnog makronaredbe \u201eFiltriraj tablice\u201c<\/a><\/noindex> tako\u0111er se mo\u017ee postaviti zadano sortiranje za bilo koju kolonu i numerirati redove. Ili kliknite na bilo koju kolonu u tablici koja je umetnuta u filtar, i do\u0107i \u0107e do sortiranja po toj koloni. <\/p>\n

\"Projektiranje
\n
\nNa primjer, imate istu tablicu s kandidatima i trebate procijeniti koliko je intervjua odr\u017eano u odre\u0111enom mjesecu \u2014 sortirajte po datumu i u\u017eivajte.<\/p>\n

Pivotne tablice (pla\u0107eni dodatak)<\/h3>\n

\nSada prelazimo na zanimljiviji slu\u010daj. Zamislite da je va\u0161a tablica ogromna i treba ne\u0161to izra\u010dunati na njoj. Naravno, mo\u017eete je kopirati u Excel, izra\u010dunati potrebne podatke i prenijeti ih natrag u Confluence. Ali mo\u017eete jednom upotrijebiti makronaredbu \u201ePivotna tablica\u201c<\/a><\/noindex> i dobiti isti rezultat, samo jo\u0161 i a\u017euriran.<\/p>\n

Na primjer, imate tablicu u kojoj su prikupljeni podaci svih zaposlenika \u2014 gdje se teritorijalno nalaze i koje pozicije obna\u0161aju. Da biste izra\u010dunali koliko ljudi se nalazi u svakom gradu, trebate odabrati u makronaredbi \u201ePivotna tablica\u201c redak po kojem se agregiraju podaci (lokacija) i vrstu operacije (zbrajanje).<\/p>\n

\"Projektiranje
\n
\nNaravno, mo\u017eete grupirati prema vi\u0161e kriterija odjednom, sve mogu\u0107nosti mo\u017eete vidjeti u dokumentaciji<\/a><\/noindex>.<\/p>\n

Dijagrami (pla\u0107eni dodatak)<\/h3>\n

\nKao \u0161to sam ve\u0107 spomenula, ne vole svi tablice toliko kao ja. Na\u017ealost, ve\u0107ina menad\u017eera ih uop\u0107e ne voli. Ali svi jako vole \u0161arene i \u017eivopisne dijagrame.
\nStvoritelji Confluencea o tome su, nesumnjivo, znali (sigurno imaju i oni nadredene koji vole izvje\u0161taje i dijagrame, kako bi druga\u010dije). Stoga se mo\u017eete poslu\u017eiti \u010darobnom makronaredbom \u201eDijagram iz tablice\u201c<\/a><\/noindex>. U ovu makronaredbu treba staviti pivotnu tablicu iz prethodnog stavka, i voil\u00e0 \u2014 va\u0161i sivi, dosadni podaci su lijepo vizualizirani.<\/p>\n

\"Projektiranje
\n
\nNaravno, u ovoj makronaredbi tako\u0111er postoje postavke. Poveznicu na dokumentaciju za bilo koju makronaredbu mo\u017eete prona\u0107i u na\u010dinu ure\u0111ivanja te makronaredbe.<\/p>\n

Jednostavnost agregacije<\/h2>\n

\nInformacije iz prethodnih ta\u010daka zasigurno nisu bile otkrovenje za vas. Ali sada sigurno znate kako koristiti makroe, a ja mogu pre\u0107i na zanimljiviji deo \u010dlanka.<\/p>\n

\"Projektiranje
\n<\/p>\n

Oznake<\/h3>\n

\nLo\u0161e je kada ljudi \u010duvaju informacije u jednom nestrukturiranom \u010dlanku ili ogromnoj tabeli. Jo\u0161 gore je kada su delovi tih informacija ne samo lo\u0161e formatirani, nego su i raspr\u0161eni po Confluence-u. Na sre\u0107u, postoji mogu\u0107nost da skupite raspr\u0161ene informacije na jednom mestu. Za to treba iskoristiti oznake<\/a><\/noindex> (poznate svima iz dru\u0161tvenih mre\u017ea tagovi).<\/p>\n

\"Projektiranje
\n
\nNa svaku stranicu mo\u017eete dodati neograni\u010den broj oznaka. Ako kliknete na oznaku, do\u0107i \u0107ete na stranicu agregacije, gde su povezani svi materijali sa tom oznakom, kao i set povezanih oznaka. Povezane oznake su one koje se \u010desto pojavljuju na istoj stranici.<\/p>\n

\"Projektiranje
\n<\/p>\n

Svojstva stranica<\/h3>\n

\nNa stranicu mo\u017eete dodati jo\u0161 jedan zanimljiv makro za strukturiranje informacija \u2014 \u201eSvojstva stranica\u201c<\/a><\/noindex>. U njega treba uneti tabelu sa dva kolone, prva \u0107e biti klju\u010d, a druga \u2014 vrednost svojstva. Osim toga, makro se mo\u017ee sakriti sa stranice kako ne bi ometao \u010ditanje sadr\u017eaja, ali stranica \u0107e i dalje biti ozna\u010dena potrebnim klju\u010devima.<\/p>\n

\"Projektiranje
\n
\nObratite pa\u017enju na ID \u2014 lako je postaviti da se razli\u010dite grupe svojstava pove\u017eu sa razli\u010ditim stranicama (ili \u010dak razli\u010ditim grupama svojstava na jednoj stranici). <\/p>\n

Izvje\u0161taji<\/h3>\n

\nPreko oznaka se mogu prikupljati izve\u0161taji. Na primer, makro \u201eIzve\u0161taj o sadr\u017eaju\u201c<\/a><\/noindex> prikuplja sve stranice sa odre\u0111enim skupom oznaka.<\/p>\n

\"Projektiranje
\n
\nAli zanimljiviji izve\u0161taj je makro \u201eIzve\u0161taj po svojstvima stranice\u201c<\/a><\/noindex>. On tako\u0111e prikuplja sve stranice sa odre\u0111enim skupom oznaka, ali ne samo da ispisuje njihov spisak, ve\u0107 sastavlja tabelu (shvatate vezu s po\u010detkom \u010dlanka?), u kojoj su kolone klju\u010devi svojstava stranice.<\/p>\n

\"Projektiranje
\n
\nTako dobijate okvirnu tabelu koja sadr\u017ei informacije iz razli\u010ditih izvora. Lepo je \u0161to ima korisne funkcije: responzivni dizajn, sortiranje po bilo kojoj koloni. Tako\u0111e, ovu izve\u0161tajnu tabelu mo\u017eete konfigurisati unutar makroa. <\/p>\n

\"Projektiranje
\n
\nPrilikom konfigurisanja mo\u017eete iz izve\u0161taja ukloniti odre\u0111ene kolone, postaviti stanje po defaultu ili broj prikazanih unosa. Tako\u0111e mo\u017eete postaviti ID svojstva stranice da biste videli samo potrebne informacije.<\/p>\n

Na primjer, imate mnogo stranica zaposlenika, koje imaju set svojstava o osobi: kojeg je nivoa, gdje se nalazi, kada se pridru\u017eio timu itd. Ova svojstva su ozna\u010dena ID = employee_inf<\/i>. I postoji drugi set svojstava na istoj stranici, koji sadr\u017ei informacije o osobi kao dijelu tima: koju ulogu osoba obavlja, u kojem se timu nalazi itd. Ova svojstva su ozna\u010dena ID = team_inf<\/i>. Tada prilikom sastavljanja izve\u0161taja mo\u017eete izvu\u0107i informacije prema samo jednom ID-u ili odmah prema oba \u2014 kako vam vi\u0161e odgovara.<\/p>\n

\u010car ovog pristupa je u tome \u0161to svaki mo\u017ee sastaviti informativnu tabelu koja mu je potrebna, koja ne\u0107e ni\u0161ta duplicirati i bi\u0107e a\u017eurirana kada se a\u017eurira glavna stranica. Na primjer: timu vo\u0111a nije va\u017eno kada su njegovi developeri zapo\u010deli rad, ali je va\u017eno koju ulogu svatko od njih obavlja u timu. Timski vo\u0111a \u0107e sastaviti izve\u0161taj o timu. A ra\u010dunovo\u0111i nije bitno ko koju ulogu obavlja, ve\u0107 su mu va\u017ene pozicije \u2014 sastavi\u0107e izve\u0161taj o pozicijama. Pri tome izvor informacija se ne\u0107e duplicirati ili prenositi.<\/p>\n

Zavr\u0161ni proces<\/h2>\n

<\/p>\n

Upute<\/h3>\n

\nDakle, mo\u017eemo lepo strukturirati i efikasno agregirati informacije u Confluence na primjeru kori\u0161\u0107enja makroa. Ali u idealnom slu\u010daju, potrebno je u\u010diniti da nove informacije odmah budu strukturirane i da se uklju\u010de u sve ve\u0107 kori\u0161\u0107ene mehanizme agregacije.<\/p>\n

Tu \u0107e pomo\u0107i kombinacija makroa i \u0161ablona. Da biste naterali ljude da kreiraju nove stranice u potrebnom formatu, mo\u017eete koristiti makro \"Kreiraj iz \u0161ablona\". On dodaje na stranicu dugme, pritiskom na koje se kreira nova stranica iz potrebnog \u0161ablona. Tako prisiljavate ljude da odmah rade u formatu koji vam je potreban. <\/p>\n

\"Projektiranje
\n
\nU \u0161ablon iz kojeg dajete mogu\u0107nost kreiranja stranice, treba unapred dodati oznake, makro \"Svojstva stranice\" i tabelu potrebnih svojstava. Tako\u0111e preporu\u010dujem da dodate uputstva o tome kojim vrednostima treba popuniti stranicu, i vrednosti svojstava.<\/p>\n

\"Projektiranje
\n
\nTada \u0107e zavr\u0161ni proces izgledati ovako:<\/p>\n

    \n
  1. Kreirate \u0161ablon za informacije odre\u0111enog tipa.<\/li>\n
  2. U taj \u0161ablon dodajete oznake i svojstva stranice u makro.<\/li>\n
  3. Na bilo kojem prikladnom mjestu stvarate glavnu stranicu s gumbom, na koji se klikom stvara podstranica na osnovu predlo\u0161ka. <\/li>\n
  4. Pustite na glavnu stranicu korisnike koji mogu potencijalno generirati potrebne informacije (po potrebnom predlo\u0161ku, pritiskom na gumb).<\/li>\n
  5. Prikupite izvje\u0161taj o svojstvima stranice putem oznaka koje ste naveli u predlo\u0161ku.<\/li>\n
  6. Veselite se: imate sve potrebne informacije u prikladnom formatu. <\/li>\n<\/ol>\n

    \"Projektiranje
    \n<\/p>\n

    Skriveni problemi<\/h3>\n

    \nKao in\u017eenjer kvalitete, mogu re\u0107i da ni\u0161ta savr\u0161eno ne postoji u svijetu. \u010cak ni bo\u017eanske tablice nisu savr\u0161ene. I u navedenom procesu postoje skrivene zamke.<\/p>\n