Përshëndetje të gjithëve!
Më quajnë Masha, punoj si inxhiniere për sigurimin e cilësisë në grupin e kompanive Tinkoff. Puna QA përfshin shumë komunikime me njerëz të ndryshëm nga ekipe të ndryshme, ndërsa unë gjithashtu kam qenë menaxhere dhe lektore në programe edukative, prandaj karta ime e komunikimeve ishte maksimalisht e gjerë. Dhe në një moment, shpërtheva: kuptova se nuk mundesha më, nuk mundesha, nuk mundesha të mbushja tonelata të tmerrshme të tabelave dhe dokumenteve të palexueshme.
Sigurisht, secili nga ju e paraqiti tani atë për të cilën po flas dhe u ndjeje i frikësuar: lista emrash pa rend alfabetik, tabela me qindra kolona me format të çrregullt, tabela me mijëra rreshta, në të cilat duhet të fshihni gishtin në rrotulluesin e miut për të parë titujt, tonelata faqesh të pa numëruara të udhëzimeve, qindra email-e që dërgohen njëri-tjetrit me të dhënat që duhet t'i analizoni dhe sistematizoni dhe t'i mbushni në tabela të tilla po aq të pa lexueshme.
Dhe ja, kur u qetësova pak, vendosa të shkruaj këtë artikull. Do të flas për se si mund të menaxhosh në mënyrë normale (edhe herë pas here komode) dokumentacionin e llojeve të ndryshme jo-prodhuese. Shpresoj që artikulli të shpërndahet në rrjet dhe niveli i kaosit në departamentet fqinjë me zhvillimin të ulet, dhe njerëzit (dhe unë po ashtu) do të bëhen pak më të lumtur.
Mjetet
Dokumentacioni produktiv shpesh ruhet afër kodit, dhe kjo është fjalë për fjalë e mirë. Ndërsa dokumentacioni jo-produkiv zakonisht ruhet kudo. shpesh njerëzit përpiqen të transferojnë informacionin nga vende të ndryshme në Confluence, dhe ne nuk jemi përjashtim. Pra, e gjithë historia që do të vijë për të.
Përgjithësisht, Confluence është një motor wiki shumë i avancuar. Ai lejon të punoni me të dhënat në forma të ndryshme shfaqjeje: tekst të formatizuar, tabela, diagrame të ndryshme. Ky është një instrument shumë interesant dhe i fuqishëm, por nëse nuk e dini si ta përgatitni, do të merrni një tjetër grumbull dokumentesh të pa lexueshme. Unë do t'ju mësoj se si ta përgatisni!
Makros
G almost the whole magic of Confluence is built on macros. There are a lot of macros, and they can be combined with each other. They can be both paid and free, and there will be different examples of macros with links to their documentation.
Interface for working with macros is very simple. To add a macro, you need to click on the plus and select the required element from the list.
Nëse makro është vetë-sufficient, që do të thotë se nuk kërkon të fusë diçka tjetër brenda vetes, ai duket si një bllok.
Nëse për funksionimin e makros është e nevojshme të vendosni diçka brenda saj, ai duket si një kornizë.
Përveç kësaj, mund të vendosni sasi të pakufizuara të tjera brenda një kornize, mjafton që në piramidën tuaj të ekzistojë logjika.
Ădo makro ka njĂ« paraqitje paraprake: nĂ« tĂ« mund tĂ« shihni menjĂ«herĂ« nĂ«se keni plotĂ«suar dhe konfiguruar saktĂ« makron.
Shabllonat
Përveç makros, ekziston një vegël e përshtatshme për mbushjen e përmbajtjes - është një shabllon.
Shabllonet mund të përdoren kur krijoni çdo faqe: thjesht klikoni në tre pikë të afërta me butonin 'Krijo' dhe zgjidhni shabllonin që dëshironi.
Atëherë, përmbajtja e gjithë shabllonit do të shtohet në faqen e krijuar.
Krijimi i faqeve nga shabllone mund të bëhet nga kushdo, por krijimi ose redaktimi i vetë shablloneve - vetëm nga ata që kanë të drejta për këtë. Në shabllon mund të shtoni instruksione të tjera se si duhet të menaxhohet faqja.
Magjia e tabelave
Në fakt, si një teknolog, e dua me pasion tabelat dhe mund të mbaj të gjitha informacionet në to (edhe pse kjo nuk është gjithmonë efektive). Tabelat janë të qarta, të strukturuara, të shkallëzuara, magjike!
Por edhe një krijesë kaq e mrekullueshme si tabela mund të prishen. Mund të përdoren me sukses dhe madje të përmirësohen. Këtë do ta shihni më poshtë.
Filtrimi (plugin pagese)
Ădo tabelĂ« e madhe qĂ« nuk lexohet mund tĂ« bĂ«het pak mĂ« pak e madhe dhe pak mĂ« e lehtĂ« pĂ«r t'u lexuar duke pĂ«rdorur filtrimin. PĂ«r kĂ«tĂ«, mund tĂ« pĂ«rdorni njĂ« makro tĂ« paguar .
Brenda kësaj makro, duhet të futni tabelën (madje edhe më të shëmtuarën, e rëndësishme është ta futni tërësisht). Në makro mund të zgjidhni kolonat për filtrin me listë rënie, filtrin tekstual, numëror dhe filtrin sipas datave.
Imagjinoni se të gjitha informacionet për kandidatët për të gjitha pozitat janë regjistruar në një listë tabelare. Sigurisht, jo të renditura - njerëzit vijnë për intervista jo sipas alfabeta. Dhe ju duhet të kuptoni nëse keni bërë intervistë me një kandidat të veçantë më parë. Duhet thjesht ta fusni këtë kaos në makron e filtrit, të shtoni një filtrin tekstual sipas mbiemrit - dhe vuala, informacioni është në ekranin tuaj.
ĂshtĂ« e rĂ«ndĂ«sishme tĂ« theksohet se filtrimi i tabelave tĂ« mĂ«dha mund tĂ« ndikojĂ« nĂ« performancĂ«n e sistemit dhe nĂ« kohĂ«n e ngarkesĂ«s sĂ« faqeve, prandaj futur njĂ« tabelĂ« tĂ« madhe nĂ« filtrin e thahet - Ă«shtĂ« njĂ« zgjidhje temporary, mĂ« mirĂ« tĂ« ndĂ«rtohet njĂ« proces nĂ« tĂ« cilin njerĂ«zit nuk kanĂ« nevojĂ« tĂ« krijojnĂ« tabela tĂ« mĂ«dha dhe tĂ« palexueshme (njĂ« shembull procesi do tĂ« jetĂ« nĂ« fund tĂ« artikullit).
Grupimi (plugin me pagesë)
Me anë të makrosë magjike mund të vendosni gjithashtu një grupim sipas parazgjedhjes në çdo kolonë dhe të numëroni rreshtat. Ose mund të klikoni në çdo kolonë të tabelës, e futur në filtrin e makrosës, dhe do të ndodhi grupimi sipas asaj kolone.
Për shembull, keni të njëjtën tabelë me kandidatët dhe duhet të kalkuloni sa intervista janë mbajtur në një muaj të caktuar, - gruponi sipas datës dhe gëzohuni.
Tabelat përmbledhëse (plugin me pagesë)
Tani kalojmë në një rast më interesant. Imagjinoni se tabela juaj është shumë e madhe dhe duhet të bëni llogaritje mbi të. Sigurisht, mund ta kopjoni në Excel, të bëni llogaritjet e nevojshme dhe të ktheni të dhënat në Confluence. Por mund të aplikoni një herë makron dhe të merrni të njëjtin rezultat, vetëm se dhe i përditësueshëm.
Për shembull: keni një tabelë, në të cilën janë të dhënat e të gjithë punonjësve - ku ndodhen dhe cilat pozita mbajnë. Për të llogaritur sa njerëz ndodhen në çdo qytet, ju nevojitet të zgjidhni në makron «Tabelë përmbledhëse» rreshtin sipas të cilit grupohen të dhënat (vendndodhja) dhe llojin e operacionit (shtimi).
Natyrisht, mund të grupohen sipas disa karakteristikave njëkohësisht, të gjitha mundësitë mund të shikohen .
Grafikat (plugin me pagesë)
Siç e kam thënë, jo të gjithë e duan tabelat ashtu siç e bëj unë. Fatkeqësisht, menaxherët në shumicën e rasteve nuk i pëlqejnë ato fare. Përkundrazi, të gjithë i dashurojnë grafikat e ndritshme me ngjyra.
Krijuesit e Confluence, patjetër që e dinin këtë (sigurisht kanë edhe ata shefa që i duan raportet dhe grafikat, ku të shkojnë pa to). Prandaj, mund të shfrytëzoni makrosën magjike . Në këtë makro duhet të vendosni tabelën përmbledhëse nga pika e mëparshme, dhe ja - të dhënat tuaja të mërzitshme janë vizualizuar bukur.
Natyrisht, edhe në këtë makro ka konfigurime. Linkun për dokumentacionin për çdo makro mund ta gjeni në mënyrën e editimit të këtij makro.
Thjeshtësia e agregimit
Informacioni nga pikat e mëparshme me siguri nuk ishte një zbulim për ju. Por tani ju sigurisht di ta përdorni makros, dhe unë mund të kaloj në pjesën më interesante të artikullit.
Etiketat
ĂshtĂ« e keqe kur njerĂ«zit e ruajnĂ« informacionin nĂ« njĂ« artikull tĂ« vetĂ«m tĂ« pa strukturuar ose nĂ« njĂ« tabelĂ« tĂ« madhe. Edhe mĂ« keq Ă«shtĂ« kur pjesĂ« tĂ« kĂ«tij informacioni janĂ« jo vetĂ«m tĂ« paraqitura nĂ« mĂ«nyrĂ« tĂ« palexueshme, por janĂ« edhe tĂ« shk scattered nĂ« hapĂ«sirat e Confluence. FatmirĂ«sisht, ka mundĂ«si tĂ« mbledhĂ«sh informacionin e shpĂ«rndarĂ« nĂ« njĂ« vend. PĂ«r kĂ«tĂ«, duhet tĂ« pĂ«rdorĂ«sh (tĂ« njohura pĂ«r tĂ« gjithĂ« nga rrjetet sociale).
Në çdo faqe mund të shtoni një numër të pakufizuar etiketash. Nëse klikoni në një etiketë, do të kaloni në faqen e agregimit, ku ka lidhje me të gjithë materialet me atë etiketë, si dhe me një grup të lidhur etiketash. Etiketat e lidhura janë ato që ndodhin shpesh në të njëjtën faqe.
Atributet e faqeve
NĂ« faqe mund tĂ« shtoni njĂ« makro interesant tjetĂ«r pĂ«r organizimin e informacionit â . Brenda tij duhet tĂ« japim njĂ« tabelĂ« me dy kolona, ku kolona e parĂ« do tĂ« jetĂ« çelĂ«si, dhe e dyta â vlera e atributit. Dhe megjithĂ«se makro mund tĂ« fshihet nga faqja, qĂ« tĂ« mos pengojĂ« leximin e pĂ«rmbajtjes, faqja ende do tĂ« jetĂ« e shĂ«nuar me çelĂ«sat e nevojshĂ«m.
Vini re ID-nĂ« â Ă«shtĂ« e lehtĂ« ta caktoni, pĂ«r tĂ« ngjitur grupe tĂ« ndryshme atributesh nĂ« faqe tĂ« ndryshme (ose madje grupe tĂ« ndryshme atributesh nĂ« njĂ« faqe).
Raportet
Përmes etiketave mund të krijoni raporte. Për shembull, makro mbledh të gjitha faqet me një grup të caktuar etiketash.
Por raporti më interesant është makro . Ai gjithashtu mbledh të gjitha faqet me një grup të caktuar etiketash, por nuk thjesht paraqet listën e tyre, por krijon një tabelë (po e kuptoni lidhjen me fillimin e artikullit?), ku kolonat janë çelësat e atributit të faqeve.
Kështu, rezulton një tabelë përmbledhëse për informacionin nga burime të ndryshme. E bukur është që ajo ka funksione të përshtatshme: ndarje adaptuese, renditje sipas çdo kolone. Gjithashtu, një tabelë të tillë raportuese mund ta konfigurosh brenda makros.
Gjatë konfiguruese mund të hiqni disa kolona nga raporti, të caktoni një gjendje të paracaktuar apo numrin e regjistrimeve të shfaqura. Po ashtu, mund të caktoni ID-në e atributit të faqes, për të parë vetëm informacionin e nevojshëm.
PĂ«r shembull, keni shumĂ« faqe pĂ«r punonjĂ«sit; kĂ«to faqe kanĂ« njĂ« grup vetish rreth individĂ«ve: çfarĂ« niveli janĂ«, ku ndodhen, kur janĂ« bashkuar me ekipin dhe kĂ«shtu me radhĂ«. KĂ«to veti janĂ« tĂ« shĂ«nuara ID = employee_inf. Dhe ka njĂ« grup tĂ« dytĂ« vetish nĂ« kĂ«tĂ« faqe, ku Ă«shtĂ« mbledhur informacioni rreth individĂ«ve si pjesĂ« e ekipit: çfarĂ« roli kryen secili, nĂ« cilin ekip ndodhet dhe kĂ«shtu me radhĂ«. KĂ«to veti janĂ« tĂ« shĂ«nuara ID = team_inf. KĂ«shtu, kur tĂ« ndĂ«rtoni raportin, mund tĂ« nxirrni vetĂ«m informacion mbi njĂ« identifikues ose tĂ« dy â siç Ă«shtĂ« mĂ« e lehtĂ«.
Bukuria e këtij qasjes është se çdo njeri mund të mbledhë tabelën e informacionit që i nevojitet, e cila nuk do të ketë asnjë kopjim dhe do të përditësohet me përditësimin e faqes kryesore. Për shembull: një lider ekipi nuk e intereson se kur janë punësuar zhvilluesit e tij, por është e rëndësishme çfarë roli ka secili në ekip. Lideri i ekipit do të mbledhë raport për ekipin. Ndërsa një kontabilist nuk e ka aspak për zemër se kush çfarë roli ka, por janë të rëndësishme pozitat - ai do të mbledhë një raport për pozitat. Në të njëjtën kohë, burimi i informacionit nuk do të kopjohet apo transferohet.
Procesi përfundimtar
Udhëzues
Pra, ne mund të strukturojmë bukur dhe të agregojmë informacionin efektivisht në Confluence duke përdorur makrotë. Por në ideale duhet të bëjmë që informacioni i ri të jetë menjëherë i strukturuar dhe të hyjë në të gjitha mekanizmat që përdoren tashmë për agregim.
Këtu do të ndihmojë kombinimi i makrove dhe ƥablonave. Për të detyruar njerëzit të krijojnë faqe të reja në formatin e duhur, mund të përdorni makron "Krijo nga ƥabloni". Ajo shton në faqe një buton, duke klikuar mbi të krijohet një faqe e re nga ƥabloni që dëshironi. Kështu, detyroni njerëzit të punojnë menjëherë në formatin që dëshiron.
Në ƥablonin nga i cili mund të krijoni faqen, duhet paraprakisht të shtoni etiketat, makron "Vetitë e Faqes" dhe tabelën e vetive që ju nevojiten. Gjithashtu, rekomandoj të shtoni udhëzime mbi se çfarë vlerash duhet të mbushë faqja dhe vlerat e vetive.
Kështu, procesi përfundimtar do të duket kështu:
- Ju krijoni një ƥablon për informacionin e një tipi të caktuar.
- Në këtë ƥablon shtoni etiketat dhe vetitë e faqes në makro.
- Në çdo vend të përshtatshëm krijoni një faqe rrënjë me një buton, me klikimin e të cilit krijohet një faqe nënkategori nga një model.
- Lejoni përdoruesit në faqen rrënjë, të cilët potencialisht do të gjenerojnë informacionin e nevojshëm (sipas modelit të nevojshëm, duke klikuar në buton).
- Mblidheni raportin për pronat e faqes nëpërmjet etiketave që keni caktuar në model.
- Gëzoheni: keni të gjithë informacionin e nevojshëm në një format të përshtatshëm.
ProHoster Sofiyadakı digÉr server provayderlÉrindÉn nÉ ilÉ fÉrqlÉnir?
Si inxhinier i cilësisë, unë mund të them me guxim se në botë nuk ka asgjë ideale. Edhe tabela hyjnore nuk janë perfekte. Dhe në procesin e përshkruar më sipër ka pengesa.
- Nëse vendosni të ndryshoni emrat ose përbërjen e pronave të faqes, do t'ju duhet të përditësoni të gjitha objektet që janë krijuar tashmë, në mënyrë që të dhënat e tyre të përfshihen saktë në raportin përmbledhës. Kjo është e trishtuar, por, nga ana tjetër, e bën të mendoni me kujdes 'arkitekturën' e informacionit tuaj, që është një detyrë mjaft interesante.
- Do t'ju duhet të shkruani një numër të konsiderueshëm udhëzimesh se si të mbushni tabelat informative dhe si të përdorni etiketat. Por, nga ana tjetër, mund të thjesht t'ua dërgoni këtë artikull të gjithë njerëzve të nevojshëm.
Shembuj i ruajtjes së dokumentacionit jo produktiv.
Përmes procesit të përshkruar më sipër, është e mundur të organizoni ruajtjen e casi çdo informacioni. Bukuria e këtij qasje është se është universale: kur përdoruesit të mësojnë me të, ata ndalin së gjeneruari kaos. Gjithashtu, një avantazh i madh (por jo falas) është mundësia për të mbledhur në kohë reale statistika të ndryshme dhe për të vizatuar grafikë të bukur mbi to.
Do të sjell një shembull të procesit tonë në menaxhimin e informacionit për ekipin.
Për çdo person në ekip, ne vendosëm të krijojmë një kartelë punonjësi. Për pasojë, kemi një model, sipas të cilit çdo persona e re krijon këtë kartelë dhe mban aty të gjithë informacionin personal.
Siç e shihni, kemi një tabelë të zgjeruar të pronave dhe menjëherë janë edhe udhëzime se si të menaxhohet kjo faqe. Disa etiketa i vendosin vetë punonjësit sipas udhëzimeve; në model janë vetëm të parat: etiketa e kartelës employee-card, etiketa e drejtimit direction-involve dhe etiketa e ekipit team-qa.
Pas after krijimi i kartelave pĂ«r secilin, rezulton njĂ« tabelĂ« e plotĂ« me informacione pĂ«r punonjĂ«sit. KĂ«to informacione mund tĂ« pĂ«rdoren nĂ« pika tĂ« ndryshme. MenaxherĂ«t e burimeve mund tĂ« krijojnĂ« tabela tĂ« pĂ«rbashkĂ«ta, ndĂ«rsa liderĂ«t e grupeve â tabela ekipore, duke shtuar nĂ« pĂ«rzgjedhje tagun e ekipit.
Me tagĂ«t mund tĂ« shihni pĂ«rmbledhje tĂ« ndryshme, pĂ«r shembull pĂ«r qa-upgrade-plan do tĂ« shfaqen tĂ« gjitha detyrat pĂ«r zhvillimin e QA. NdĂ«rkohĂ«, secili individ nĂ« kartelĂ«n e tij tĂ« punonjĂ«sit mbart njĂ« histori tĂ« rĂ«ndĂ«sishme dhe planin e tij tĂ« zhvillimit â krijon njĂ« faqe tĂ« thelluar nga shablloni i planeve tĂ« zhvillimit.
PĂ«rfundim
Mbani dokumentacionin në një mënyrë që të mos ndiheni keq për të, dhe përdoruesit të mos vuajnë!
Shpresoj shumë që artikulli do të jetë i dobishëm dhe në të gjitha dokumentacionet e botës do të vendoset rend.
Burimi: habr.com
