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

Zdravo svima! <\/p>\n

Moje ime je Ma\u0161a, delam kot in\u017eenirka kakovosti v skupini podjetij Tinkoff. Delo v QA vklju\u010duje \u0161tevilne komunikacije z razli\u010dnimi ljudmi iz razli\u010dnih ekip, poleg tega pa sem bila tudi vodja in predavateljica izobra\u017eevalnih programov, zato je bila moja komunikacijska mre\u017ea izjemno \u0161iroka. In v nekem trenutku sem popustila: spoznala sem, da ne morem ve\u010d, ne morem, ne morem izpolnjevati neprestanih ton neberljivih tabel in dokumentov. <\/p>\n

\"Na\u010drtovanje
\n
\n<\/a><\/noindex>
\nVerjetno si je vsak izmed vas sedaj predstavljal, o \u010dem govorim, in se oblil s hladnim znojem: seznami priimkov brez abecednega reda, tabele s stotimi stolpci z zme\u0161ano postavitvijo, tabele z na stotine vrsticami, kjer je treba s prstom drgniti po kole\u0161\u010dku mi\u0161ke, da bi videli naslov, tone nepod\u0161tevil\u010denih navodil, stotine e-po\u0161t, ki si jih med seboj po\u0161iljamo z podatki, ki jih je treba analizirati in sistematizirati ter stisniti v prav tako neberljive tabele.<\/p>\n

\"Na\u010drtovanje
\n
\nIn tako, ko sem se nekoliko umirila, sem se odlo\u010dila napisati ta \u010dlanek. Povedala bom, kako lahko normalno (v\u010dasih celo udobno) vodimo raznoliko neraziskovalno dokumentacijo. Upam, da bo \u010dlanek zaokro\u017eil po spletu in da se bo nivo nerazumljivosti v sosednjih oddelkih za razvoj vsaj malo zmanj\u0161al, ljudje (in tudi jaz) pa postali sre\u010dnej\u0161i.<\/p>\n

\"Na\u010drtovanje
\n<\/p>\n

Orodja<\/h2>\n

\nDokumentacija o izdelku se pogosto hrani skupaj s kodo, kar je dobro. Neraziskovalna dokumentacija pa se obi\u010dajno hrani kjerkoli. Ljudje pogosto posku\u0161ajo prenesti informacije z razli\u010dnih mest v Confluence, in mi nismo izjema. Torej, vse nadaljnje pripovedovanje o tem.<\/p>\n

Confluence je v bistvu napreden wiki-motor. Omogo\u010da delo z informacijami v razli\u010dnih oblikah prikaza: besedilo s formatiranjem, tabele, razli\u010dne diagrame. To je zelo zanimivo in mo\u010dno orodje, vendar, \u010de ga ne znate pripraviti, boste dobili le \u0161e eno zme\u0161njavo neberljivih dokumentov. Nau\u010dil vas bom, kako ga pripraviti!<\/p>\n

\"Na\u010drtovanje
\n<\/p>\n

Makroji<\/h2>\n

\nSkoraj vsa magija Confluence temelji na makrojih. Makrojev je veliko, in jih je mogo\u010de kombinirati med seboj. Obstajajo pla\u010dljivi in brezpla\u010dni makroji, spodaj bodo razli\u010dni primeri makrojev s povezavami na dokumentacijo zanje.<\/p>\n

Vmesnik za delo z makroji je izjemno preprost. Da dodate makro, morate pritisniti na plus in izbrati ustrezen element s seznama.<\/p>\n

\"Na\u010drtovanje
\n
\n\u010ce je makro samostojen, torej ne zahteva vstavljanja ni\u010desar drugega v sebe, izgleda kot blok.<\/p>\n

\"Na\u010drtovanje
\n
\n\u010ce makro za delovanje potrebuje, da vanj nekaj postavite, izgleda kot okvir.<\/p>\n

\"Na\u010drtovanje
\n
\nVanjo lahko vstavite poljubno \u0161tevilo drugih okvirjev, \u010de je v va\u0161i piramidi logika.<\/p>\n

\"Na\u010drtovanje
\n
\nVsak makro ima predogled: takoj je vidno, ali ste pravilno izpolnili in nastavili makro.<\/p>\n

Predloge<\/h2>\n

\nPoleg makrov je udoben orodje za predpolnitev vsebine \u2014 to je predloga.
\nPredloge lahko uporabite pri ustvarjanju katere koli strani: preprosto kliknite na tri pike poleg gumba \u00bbUstvari\u00ab in izberite \u017eeleno predlogo.<\/p>\n

\"Na\u010drtovanje
\n
\nTakrat se bo v ustvarjeno stran dodala vsa vsebina, ki jo vsebuje predloga.<\/p>\n

Strani iz predlog lahko ustvarja kdorkoli, medtem ko lahko same predloge ustvarjajo ali urejajo le tisti, ki imajo za to pravice. V predlogo lahko dodate dodatna navodila o tem, kako naj se stran vodi.<\/p>\n

\"Na\u010drtovanje
\n<\/p>\n

Magija tabel<\/h2>\n

\nV resnici, kot tehnik, ne\u017eno ljubim tabele in lahko skoraj vsako informacijo zavijem vanje (\u010deprav to ni vedno u\u010dinkovito). Same tabele so jasne, strukturirane, raz\u0161irljive, \u010darobne!<\/p>\n

\"Na\u010drtovanje
\n
\nToda tudi tako \u010dudovito entiteto, kot je tabela, lahko pokvarite. Lahko pa jo uspe\u0161no uporabite in celo izbolj\u0161ate. O tem spodaj.<\/p>\n

Filtriranje (pla\u010dljiv dodatek)<\/h3>\n

\nVsako ogromno neurejeno tabelo lahko naredite nekoliko manj ogromno in nekoliko bolj berljivo s pomo\u010djo filtriranja. Za to lahko uporabite pla\u010dljiv makro \u00bbFiltriranje tabel\u00ab<\/a><\/noindex>.<\/p>\n

V ta makro morate vstaviti tabelo (lahko celo najbolj grdo, glavna stvar je, da jo vstavite celotno). V makru lahko izberete stolpce za filtriranje iz spustnega menija, besedilnega filtra, \u0161tevil\u010dnega in filtra po datumih. <\/p>\n

\"Na\u010drtovanje
\n
\nPredstavljajte si, da so vse informacije o kandidatih za vse razpise zapisane v tabeli. Seveda niso razvr\u0161\u010dene \u2014 ljudje na razgovore ne prihajajo po abecedi. In vi morate razumeti, ali ste \u017ee intervjuvali dolo\u010denega kandidata. Preprosto vstavite to zme\u0161njavo v makro za filtriranje, dodajte besedilni filter po priimku \u2014 in voila, informacije so na va\u0161em zaslonu.<\/p>\n

\"Na\u010drtovanje
\n
\nPomembno je omeniti, da lahko filtriranje velikih tabel vpliva na delovanje sistema in \u010das nalaganja strani, zato je umestitev velike tabele v filtriranje le za\u010dasna re\u0161itev; bolje je vzpostaviti proces, pri katerem ljudje ne bodo morali ustvarjati ogromnih, neberljivih tabel (primer procesa bo na koncu \u010dlanka).<\/p>\n

Razvr\u0161\u010danje (pla\u010dljiv vti\u010dnik)<\/h3>\n

\nZ magi\u010dnim makrom \u00bbFiltriranje tabel\u00ab<\/a><\/noindex> lahko prav tako nastavite privzeto razvr\u0161\u010danje po katerem koli stolpcu in o\u0161tevil\u010dite vrstice. Ali pa kliknete na kateri koli stolpec tabele, vdelane v makro filtriranja, in razvrstitev se izvede po tem stolpcu. <\/p>\n

\"Na\u010drtovanje
\n
\nNa primer, imate isto tabelo s kandidati in \u017eelite oceniti, kolik\u0161no \u0161tevilo intervjujev je bilo izvedenih v dolo\u010denem mesecu \u2014 razvrstite po datumu in u\u017eivajte.<\/p>\n

Pivotske tabele (pla\u010dljiv vti\u010dnik)<\/h3>\n

\nSedaj preidimo na zanimivej\u0161i primer. Predstavljajte si, da je va\u0161a tabela ogromna in morate nekaj izra\u010dunati na njej. Seveda jo lahko kopirate v Excel, izra\u010dunate potrebno in podatke znova prenesete v Confluence. Lahko pa enkrat uporabite makro \u201ePivotska tabela\u201c<\/a><\/noindex> in dobite enak rezultat, ki se \u0161e posodablja.<\/p>\n

Na primer: imate tabelo, v kateri so zbrani podatki vseh zaposlenih \u2014 kje se geografsko nahajajo in katere polo\u017eaje zasedajo. Da bi izra\u010dunali, koliko ljudi je v vsakem mestu, morate v makru \u201ePivotska tabela\u201c izbrati vrstico, po kateri se agregirajo podatki (lokacija) in tip operacije (se\u0161tevanje).<\/p>\n

\"Na\u010drtovanje
\n
\nSeveda lahko grupirate tudi po ve\u010d znakih hkrati, vse mo\u017enosti si lahko ogledate v dokumentaciji<\/a><\/noindex>.<\/p>\n

Diagrama (pla\u010dljiv vti\u010dnik)<\/h3>\n

\nKot sem \u017ee omenila, ne marajo vsi tabel tako zelo kot jaz. Na \u017ealost jih ve\u010dina managerjev sploh ne ljubi. Zato pa vsi zelo radi imajo svetle barvne diagrame.
\nUstvarjalci Confluence so o tem zagotovo vedeli (verjetno imajo tudi sami nadrejene, ki ljubijo poro\u010dila in diagrame, kamor pa brez njih). Zato lahko uporabite \u010darobni makro \u201eDiagram iz tabele\u201c<\/a><\/noindex>. V ta makro morate vstaviti pivotsko tabelo iz prej\u0161nje to\u010dke, in voila \u2014 va\u0161i sivi, dolgo\u010dasni podatki so lepo vizualizirani.<\/p>\n

\"Na\u010drtovanje
\n
\nSeveda ima tudi ta makro nastavitve. Povezavo na dokumentacijo za kateri koli makro lahko najdete v na\u010dinu urejanja tega makra.<\/p>\n

Enostavnost agregacije<\/h2>\n

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

\"Na\u010drtovanje
\n<\/p>\n

Oznake<\/h3>\n

\nLo\u0161e je kada ljudi \u010duvaju informacije u jednoj nestrukturiranoj \u010dlanku ili ogromnoj tabeli. Jo\u0161 gore \u2014 kada su delovi tih informacija ne samo ne\u010ditko oblikovani, ve\u0107 su i raspr\u0161eni po Confluence-u. Sre\u0107om, postoji mogu\u0107nost okupljanja raspr\u0161enih informacija na jednom mestu. Da biste to uradili, treba da iskoristite tagove<\/a><\/noindex> (poznate svima po dru\u0161tvenim mre\u017eama).<\/p>\n

\"Na\u010drtovanje
\n
\nNa svaku stranicu mo\u017eete dodati bilo koji broj tagova. Ako kliknete na tag, bi\u0107ete preusmereni na stranicu agregacije, gde su linkovi na sve materijale sa tim tagom, kao i vezani tagovi. Vezani tagovi su oni koji se \u010desto pojavljuju na istoj stranici.<\/p>\n

\"Na\u010drtovanje
\n<\/p>\n

Svojstva stranica<\/h3>\n

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

\"Na\u010drtovanje
\n
\nObratite pa\u017enju na ID \u2014 lako je podesiti da se dodele razli\u010dite grupe svojstava razli\u010ditim stranicama (ili \u010dak razli\u010ditim grupama svojstava na jednoj stranici). <\/p>\n

Izve\u0161taji<\/h3>\n

\nPo tagovima mo\u017eete sakupljati izve\u0161taje. Na primer, makro \u00abIzve\u0161taj o sadr\u017eaju\u00bb<\/a><\/noindex> sakuplja sve stranice sa odre\u0111enim skupom tagova.<\/p>\n

\"Na\u010drtovanje
\n
\nAli zanimljiviji izve\u0161taj je makro \u00abIzve\u0161taj po svojstvima stranice\u00bb<\/a><\/noindex>. Tako\u0111e sakuplja sve stranice sa odre\u0111enim skupom tagova, ali ne jednostavno ispisuje njihov spisak, ve\u0107 sastavlja tabelu (primetili ste povezanost s po\u010detkom \u010dlanka?), u kojoj su kolone \u2014 klju\u010devi svojstava stranice.<\/p>\n

\"Na\u010drtovanje
\n
\nDobija se pregledna tabela o informacijama iz razli\u010ditih izvora. Prijatan je dodatak \u0161to ima prakti\u010dne funkcije: responzivni raspored, sortiranje po bilo kojoj koloni. Tako\u0111e, takvu izve\u0161tajnu tabelu mo\u017eete konfigurisati unutar makroa. <\/p>\n

\"Na\u010drtovanje
\n
\nTokom konfiguracije mo\u017eete ukloniti odre\u0111ene kolone iz izve\u0161taja, postaviti podrazumevano stanje ili broj prikazanih zapisa. A tako\u0111e mo\u017eete postaviti ID svojstva stranice kako biste videli samo potrebne informacije.<\/p>\n

Na primer, imate mnogo stranica zaposlenih, a svaka od tih stranica ima set osobina koje se odnose na osobu: koja je njegova pozicija, gde se nalazi, kada je do\u0161ao u tim i tako dalje. Ove osobine su ozna\u010dene ID = employee_inf<\/i>. I postoji drugi set osobina na istoj stranici, koji sadr\u017ei informacije o osobi, kao delu tima: koju ulogu osoba obavlja, u kojem timu se nalazi i tako dalje. Ove osobine su ozna\u010dene ID = team_inf<\/i>. Tada prilikom sastavljanja izve\u0161taja mo\u017eete prikazati informacije samo po jednom ID-ju ili odmah po oba \u2014 kako vam vi\u0161e odgovara.<\/p>\n

Veza takvog pristupa je u tome \u0161to svako mo\u017ee da sastavi informativnu tabelu koja mu je potrebna, koja ne\u0107e ni\u0161ta duplirati i bi\u0107e a\u017eurirana kada se glavna stranica a\u017eurira. Na primer: tim lideru nije va\u017eno kada su njegovi programeri zaposleni, ali je va\u017eno koju ulogu svako od njih obavlja u timu. Tim lider \u0107e sastaviti izve\u0161taj za tim. A knjigovo\u0111i je potpuno svejedno ko koju ulogu obavlja, ali su mu va\u017ena radna mesta \u2014 on \u0107e sastaviti izve\u0161taj prema radnim mestima. Pri tome, izvor informacija se ne\u0107e duplirati ili preme\u0161tati.<\/p>\n

Kona\u010dni proces<\/h2>\n

<\/p>\n

Navodilo<\/h3>\n

\nDakle, mo\u017eemo lepo strukturirati i efikasno agregirati informacije u Confluence-u na primeru kori\u0161\u0107enja makroa. Ali u idealnom slu\u010daju treba da se postigne da nove informacije odmah budu strukturirane i ulaze u sve ve\u0107 kori\u0161\u0107ene mehanizme agregacije.<\/p>\n

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

\"Na\u010drtovanje
\n
\nU \u0161ablon iz kojeg omogu\u0107avate kreiranje stranice, unapred treba dodati oznake, makro \"Svojstva stranice\" i tabelu potrebnih svojstava. Tako\u0111e preporu\u010dujem da dodate uputstva o tome kojima vrednostima treba popuniti stranicu i vrednosti svojstava.<\/p>\n

\"Na\u010drtovanje
\n
\nTada \u0107e kona\u010dni proces izgledati ovako:<\/p>\n

    \n
  1. Kreirate \u0161ablon za informacije odre\u0111enog tipa.<\/li>\n
  2. U ovaj \u0161ablon dodajete oznake i svojstva stranice u makrou.<\/li>\n
  3. Na katerem koli priro\u010dnem mestu ustvarite glavno stran s gumbom, s katerim se ob kliku ustvari podstran iz predloge. <\/li>\n
  4. Na glavno stran spustite uporabnike, ki bodo potencialno generirali potrebne informacije (po ustrezni predlogi, s klikom na gumb).<\/li>\n
  5. Zberite poro\u010dilo o lastnostih strani prek oznak, ki ste jih navedli v predlogi.<\/li>\n
  6. Veselite se: imate vse potrebne informacije v priro\u010dni obliki. <\/li>\n<\/ol>\n

    \"Na\u010drtovanje
    \n<\/p>\n

    Skrbi<\/h3>\n

    \nKot in\u017eenir kakovosti lahko brez zadr\u017ekov trdim, da na svetu ni ni\u010d idealnega. Tudi bo\u017eanske tabele niso brez napak. V opisanem procesu so tudi pasti.<\/p>\n