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

Tere k\u00f5igile! <\/p>\n

Minu nimi on Masha, t\u00f6\u00f6tan kvaliteedikindlustuse insenerina Tinkoffi kontsernis. QA t\u00f6\u00f6 eeldab palju suhtlemist erinevate inimeste ja meeskondadega, ning kuna olin ka juht ja haridusprogrammide lektor, oli minu suhtluskate v\u00e4ga lai. Ja mingil hetkel puhkeb mul see \u00fcle: m\u00f5istsin, et ei suuda enam t\u00e4ita tohutul hulgal lugematuid tabeleid ja dokumente. <\/p>\n

\"Projekteerimine
\n
\n<\/a><\/noindex>
\nT\u00f5en\u00e4oliselt kujutas iga\u00fcks teist n\u00fc\u00fcd ette, millest ma r\u00e4\u00e4gin, ja katab k\u00fclma higi: nimekirjad perekonnanimedest, mis pole t\u00e4hestikulises j\u00e4rjekorras, tabelid, millel on sadu veerge valesti paigutatud, tuhanded read tabeleid, kus tuleb s\u00f5rme hiire ratta k\u00fclge kahjustada, et pealkirju n\u00e4ha, tohutud lehed numbritega, sadu omavahel edasi saadetavaid kirju andmete anal\u00fc\u00fcsimiseks, mis tuleb organiseerida ning j\u00e4lle sellistesse lugematutesse tabelitesse suruda.<\/p>\n

\"Projekteerimine
\n
\nJa n\u00fc\u00fcd, kui olen veidi jahtunud, otsustasin kirjutada selle artikli. R\u00e4\u00e4gin, kuidas saab normaalselt (v\u00f5i isegi mugavalt) j\u00e4lgida mitmekesist mitte-toote dokumentatsiooni. Loodan, et artikkel levib internetis ja k\u00f5rvalosakondade piinade tase v\u00e4heneb, ning inimesed (ka mina) muutuvad veidi \u00f5nnelikumaks.<\/p>\n

\"Projekteerimine
\n<\/p>\n

T\u00f6\u00f6riistad<\/h2>\n

\nToote dokumentatsioon asub sageli koodi k\u00f5rval, ja see on hea. Kuid mitte-toote dokumentatsioon on tavaliselt igal pool. Inimesed p\u00fc\u00fcavad sageli erinevates kohtades olevat teavet Confluence'i kanda, ja me ei ole erand. Seega on kogu j\u00e4rgnev jutt sellest.<\/p>\n

Tegelikult on Confluence arenenud wikis\u00fcsteem. See v\u00f5imaldab t\u00f6\u00f6tada andmetega erinevates vaadetes: vormindatud tekst, tabelid, mitmesugused diagrammid. See on v\u00e4ga huvitav ja v\u00f5imas t\u00f6\u00f6riist, kuid kui te ei oska seda ette valmistada, saavad teile j\u00e4lle lugematuid loetamatuid dokumente. Ma \u00f5petan teid valmistama!<\/p>\n

\"Projekteerimine
\n<\/p>\n

Makrod<\/h2>\n

\nPeaaegu kogu Confluence'i maagia p\u00f5hineb makrodest. Makrosid on palju ning neid saab omavahel kombineerida. Need on tasulised ja tasuta, edaspidi on erinevad makrode n\u00e4ited linkidega nende dokumentatsioonile.<\/p>\n

Makrode kasutajaliides on v\u00e4ga lihtne. Makro lisamiseks peate klikkima plussm\u00e4rgile ja valima nimekirjast soovitud elemendi.<\/p>\n

\"Projekteerimine
\n
\nKui makro on iseseisev, see t\u00e4hendab, et see ei vaja endasse midagi muud, n\u00e4eb see v\u00e4lja nagu plokk.<\/p>\n

\"Projekteerimine
\n
\nKui makro t\u00f6\u00f6ks on vajalik midagi tema sisse panna, n\u00e4eb see v\u00e4lja nagu raami.<\/p>\n

\"Projekteerimine
\n
\nSamuti v\u00f5ib \u00fche raami sisse paigutada nii palju teisi, kui teie piramidis on loogika.<\/p>\n

\"Projekteerimine
\n
\nIgal makrol on eelvaade: kohe on n\u00e4ha, kas olete makro \u00f5igesti t\u00e4itnud ja seadistanud.<\/p>\n

\u0160ablonid<\/h2>\n

\nLisaks makrodele on mugav sisu eel t\u00e4itmise t\u00f6\u00f6riist - see on mall.
\nMalle saab kasutada igasuguste lehtede loomisel: lihtsalt kl\u00f5psake kolme punkti k\u00f5rval \u201eLoo\u201d nupul ja valige soovitud mall.<\/p>\n

\"Projekteerimine
\n
\nSiis lisatakse loodud lehele kogu sisu, mis sellel mallil on.<\/p>\n

Lehtede loomine mallide abil on v\u00f5imalik k\u00f5igile, kuid mallide loomine v\u00f5i redigeerimine on lubatud ainult neile, kellel on sellele \u00f5igused. Mallile v\u00f5ib lisada t\u00e4iendavaid juhiseid, kuidas lehte hallata.<\/p>\n

\"Projekteerimine
\n<\/p>\n

K tabelid<\/h2>\n

\nTegelikkuses armastan ma, kui tehnik, tabeleid ja suudan peaaegu iga teabe neisse mahutada (kuigi see ei ole alati efektiivne). Tabelid on ise selged, struktureeritud, skaleeritavad, maagilised!<\/p>\n

\"Projekteerimine
\n
\nKuid isegi sellist suurep\u00e4rast olendit nagu tabel, saab rikkuda. Aga seda saab ka m\u00f5istlikult kasutada ja isegi parandada. Selle kohta allpool.<\/p>\n

Filtreerimine (tasuline plugin)<\/h3>\n

\nIga tohutu ja loetamatud tabelid saab muuta veidi v\u00e4hem tohutuks ja veidi loetavamaks filtrimise abil. Selleks saab kasutada tasulist makrot. \u201eTabelifilter\u201d<\/a><\/noindex>.<\/p>\n

Selle makro sisse tuleb panna tabel (isegi k\u00f5ige kole, peamine on see t\u00e4ielikult sisse panna). Makros saab valida filtreeritavad veerud rippmen\u00fc\u00fcst, tekstifiltri, numbrilise ja kuup\u00e4evafiltri. <\/p>\n

\"Projekteerimine
\n
\nKujutage ette, et kogu teave kandidaatide kohta k\u00f5ikide t\u00f6\u00f6kohtade jaoks on salvestatud tabelisse. Loomulikult ei ole see sorteeritud - inimesed ei saabu intervjuudele alfabeedi j\u00e4rgi. Ja peate aru saama, kas olete varem konkreetse kandidaadiga intervjuud teinud. Peate lihtsalt selle segaduse filtrikoosse kokku panema, lisama tekstifiltri perekonnanime j\u00e4rgi - ja voila, teave on ekraanil.<\/p>\n

\"Projekteerimine
\n
\nTuleb m\u00e4rkida, et suurte tabelite filtreerimine v\u00f5ib m\u00f5jutada s\u00fcsteemi t\u00f6\u00f6d ja lehek\u00fclgede laadimisaega. Seet\u00f5ttu on suurte tabelite filtreerimine ajutine lahendus; parem on v\u00e4lja t\u00f6\u00f6tada protsess, kus inimesed ei peaks looma suuri ja loetamatuid tabeleid (protsessi n\u00e4ide on artikli l\u00f5pus).<\/p>\n

Sorteerimine (tasuline plug-in)<\/h3>\n

\nKasutades maagilist makrot \u201eTabelifilter\u201d<\/a><\/noindex> , saab ka m\u00e4\u00e4rata vaikej\u00e4rjestuse mis tahes veerus ja numereerida read. V\u00f5i kl\u00f5psata tahvelarvuti mis tahes veerule, mille makrofilter on sisse pandud, ja seej\u00e4rel toimub sorteering selle veeru j\u00e4rgi. <\/p>\n

\"Projekteerimine
\n
\nN\u00e4iteks, oletame, et teil on sama tabel kandideerijatest ja peate v\u00e4lja arvutama, kui palju intervjuusid on teatud kuul toimunud \u2014 sorteerige kuup\u00e4eva j\u00e4rgi ja nautige.<\/p>\n

Kokkuv\u00f5tte tabelid (tasuline plug-in)<\/h3>\n

\nJ\u00e4rgmine juhtum on huvitavam. Kujutage ette, et teie tabel on tohutu ja peate selle p\u00f5hjal midagi arvestama. Loomulikult v\u00f5ib selle Excelisse kopeerida, vajalikud arvutused teha ja andmed tagasi Confluence'i laadida. Aga v\u00f5ite ka korra rakendada makrot \u201eKokkuv\u00f5tte tabel\u201d<\/a><\/noindex> ja saada sama tulemus, ainult et see on ka uuendatav.<\/p>\n

N\u00e4iteks: teil on tabel, kus on kogutud k\u00f5ikide t\u00f6\u00f6tajate andmed \u2014 kus nad geograafiliselt asuvad ja milliseid ametikohti nad t\u00e4idavad. Et arvutada, kui palju inimesi on igas linnas, peate valima makros \"Kokkuv\u00f5tte tabel\" rea, mille alusel andmed koondatakse (asukoht) ja operatsiooni t\u00fc\u00fcbi (liitmine).<\/p>\n

\"Projekteerimine
\n
\nLoomulikult saab grupeerida ka mitme kriteeriumi alusel korraga, k\u00f5iki v\u00f5imalusi saab vaadata in the documentation<\/a><\/noindex>.<\/p>\n

Diagrammid (tasuline plug-in)<\/h3>\n

\nNagu ma juba mainisin, ei armasta k\u00f5ik tabelite esitlemist nii palju kui mina. Kahjuks ei meeldi juhtidele enamikul juhtudel need \u00fcldse. See-eest armastavad k\u00f5ik erksaid v\u00e4rvilisi diagramme.
\nConfluence'i loojaid oli sellest kindlasti teadlik (kindlasti on ka neil \u00fclemus, kes armastab aruandeid ja diagramme, kuhu siis ilma selleta). Seet\u00f5ttu saab kasutada maagilist makrot \u201eDiagramm tabelist\u201d<\/a><\/noindex>. Sellesse makrosse tuleb panna eelnevalt loodud kokkuv\u00f5tte tabel ja voila \u2014 teie hallid ja igavad andmed on kaunilt visualiseeritud.<\/p>\n

\"Projekteerimine
\n
\nLoomulikult on ka selles makros seadeid. Lingid dokumentatsioonile igasuguste makrode kohta on saadaval selle makro redigeerimise re\u017eiimis.<\/p>\n

Kogumise lihtsus<\/h2>\n

\nEelnevad punktid ei olnud t\u00f5en\u00e4oliselt teile avastus. Kuid n\u00fc\u00fcd oskate kindlasti makrodega t\u00f6\u00f6tada ning ma saan minna artikli huvitavama osa juurde.<\/p>\n

\"Projekteerimine
\n<\/p>\n

M\u00e4rgid<\/h3>\n

\nOn halb, kui inimesed hoiavad teavet \u00fches struktuuritud artiklis v\u00f5i tohutus tabelis. Veel halvem on, kui osa sellest teabest ei ole mitte ainult loetavalt vormistatud, vaid on ka laiali harutatud Confluence'i avarustes. \u00d5nneks on v\u00f5imalik hajutatud teave koguda \u00fchte kohta. Selleks tuleb kasutada m\u00e4rks\u00f5nu<\/a><\/noindex> (sotsiaalmeediast tuntud siltide).<\/p>\n

\"Projekteerimine
\n
\nIgale lehele saab lisada mistahes arvu m\u00e4rks\u00f5nu. Kui kl\u00f5psate m\u00e4rks\u00f5nal, suundute koondlehe, kus on lingid k\u00f5ikidele materjalidele selle m\u00e4rks\u00f5naga, samuti seotud m\u00e4rks\u00f5nade kogumiga. Seotud m\u00e4rks\u00f5nad on need, mis esinevad sageli \u00fchel ja samal lehel.<\/p>\n

\"Projekteerimine
\n<\/p>\n

Lehe omadused<\/h3>\n

\nLehele saab lisada veel \u00fche huvitava makro, et struktureerida teavet \u2014 \u201eLehe omadused\u201c<\/a><\/noindex>. Selle alla tuleb esitada kahe veeru tabel, kus esimene on v\u00f5tme ja teine omaduse v\u00e4\u00e4rtus. T\u00f5si, makrot saab lehelt varjata, et see ei segaks sisu lugemist, kuid lehek\u00fclg on siiski m\u00e4rgistatud vajalike v\u00f5tmetega.<\/p>\n

\"Projekteerimine
\n
\nP\u00f6\u00f6rake t\u00e4helepanu ID-le \u2014 seda on mugav m\u00e4\u00e4rata, et siduda erinevad omaduste grupid erinevate lehtedega (v\u00f5i isegi erinevate omaduste gruppidega \u00fchel lehel). <\/p>\n

Aruanded<\/h3>\n

\nM\u00e4rks\u00f5nade kaudu on v\u00f5imalik koostada aruandeid. N\u00e4iteks makro \u201eSisu aruanne\u201c<\/a><\/noindex> kogub k\u00f5ik lehed teatud m\u00e4rks\u00f5nade komplektiga.<\/p>\n

\"Projekteerimine
\n
\nAga huvitavam aruanne on makro \u201eLehe omaduste aruanne\u201c<\/a><\/noindex>. See kogub samuti k\u00f5ik lehed teatava m\u00e4rks\u00f5nade komplektiga, kuid mitte lihtsalt ei esita nende nimekirja, vaid koostab tabeli (saate aru seosest artikli algusega?), kus veerud on lehe omaduste v\u00f5tmed.<\/p>\n

\"Projekteerimine
\n
\nSee moodustab kokkuv\u00f5tte tabeli erinevatest allikatest p\u00e4rit teabe p\u00f5hjal. Hea on, et sellel on mugavad funktsioonid: kohanduv kujundus, sorteerimine mis tahes veeru j\u00e4rgi. Samuti saab sellist aruande tabelit konfiguratsioonis makros kohandada. <\/p>\n

\"Projekteerimine
\n
\nKonfiguratsiooni k\u00e4igus saab aruandest eemaldada m\u00f5ned veerud, m\u00e4\u00e4rata vaikeolukorra v\u00f5i kuvatavate kirjeid arvu. Samuti on v\u00f5imalik m\u00e4\u00e4rata lehe omaduse ID, et n\u00e4ha ainult vajalikke andmeid.<\/p>\n

N\u00e4iteks, teil on palju t\u00f6\u00f6tajate lehti, millel on komplekt omadusi inimesest: millisel tasemel ta on, kus ta asub, millal ta meeskonda tuli jne. Need omadused on t\u00e4histatud ID = employee_inf<\/i>. Ja on teine komplekt omadusi samal lehel, kus on kogutud teave inimesest kui meeskonna liikmest: millist rolli inimene t\u00e4idab, millisest meeskonnast ta on jne. Need omadused on t\u00e4histatud ID = team_inf<\/i>. Niisiis, aruande koostamisel saate esitada teavet ainult \u00fche ID kohta v\u00f5i kohe kahe kohta - nagu teile sobib.<\/p>\n

Selle l\u00e4henemise v\u00f5lu seisneb selles, et iga\u00fcks saab koostada vajaliku teabega tabeli, mis ei dubleeri midagi ja v\u00e4rskendatakse, kui p\u00f5hileht uuendatakse. N\u00e4iteks: tiimijuhile ei ole oluline, millal tema arendajad t\u00f6\u00f6le asusid, kuid oluline on, millist rolli iga\u00fcks neist meeskonnas t\u00e4idab. Tiimijuht koostab aruande oma meeskonna kohta. Ja raamatupidajale ei ole oluline, kes millist rolli t\u00e4idab, vaid t\u00e4htsad on ametid - ta koostab aruande ametite kohta. Samuti ei dubleerita v\u00f5i \u00fcle viidud teabe allikat.<\/p>\n

L\u00f5ppprotsess<\/h2>\n

<\/p>\n

Juhend<\/h3>\n

\nNii saame kaunilt struktureerida ja t\u00f5husalt agreggeerida teavet Confluences, kasutades makrosid. Kuid ideaaljuhul peaks olema nii, et uus teave oleks kohe struktureeritud ja k\u00f5ikides juba kasutatavates agregatsiooni mehhanismidesse.<\/p>\n

Siin tuleb appi makrode ja mallide kombinatsioon. Inimeste panustamiseks uute lehtede loomisel vajalikes vormingutes v\u00f5ib kasutada makrot \"Loo mallist\". See lisab lehele nupu, millele vajutades luuakse uus leht soovitud mallist. Nii sunnite inimesi kohe t\u00f6\u00f6tama vormingus, mis teile sobib. <\/p>\n

\"Projekteerimine
\n
\nMallisse, millest te lehe loote, tuleb eelnevalt lisada teemad, lehe omaduste makro ja vajalikud omadused sisaldav tabel. Soovitan samuti lisada juhised selle kohta, milliste v\u00e4\u00e4rtustega leht t\u00e4idetakse ja omaduste v\u00e4\u00e4rtuste n\u00e4idised.<\/p>\n

\"Projekteerimine
\n
\nSiis n\u00e4eb l\u00f5ppprotsess v\u00e4lja selline:<\/p>\n

    \n
  1. Te loote teatud t\u00fc\u00fcpi teabe jaoks malli.<\/li>\n
  2. Sellesse malli lisate teemad ja omadused lehe makros.<\/li>\n
  3. Looge peamise lehe mis tahes sobivasse kohta nupp, millele klikates luuakse mallist alamleht. <\/li>\n
  4. Roiute peamisele lehele kasutajad, kes v\u00f5ivad potentsiaalselt genereerida vajalikke andmeid (vajalikus mallis, nuppu vajutades).<\/li>\n
  5. Koostate endale lehe omaduste aruande, kasutades malle, mille olete m\u00e4\u00e4ratlenud.<\/li>\n
  6. R\u00f5\u00f5mustate: teil on k\u00f5ik vajalik teave mugavas formaadis. <\/li>\n<\/ol>\n

    \"Projekteerimine
    \n<\/p>\n

    Pahupooled<\/h3>\n

    \nKvaliteediinsenerina saan julgelt v\u00e4ita, et maailmas ei ole midagi ideaalset. Isegi jumalikud tabelid ei ole ideaalsed. Ja \u00fclaltoodud protsessis on ohtlikke kohti.<\/p>\n