Hello dulur!
Nami abdi Masha, abdi damel salaku insinyur jaminan kualitas di grup perusahaan Tinkoff. Karya QA ngalibatkeun loba komunikasi jeung jalma béda ti tim béda, sarta kuring ogé manajer sarta dosen program atikan, jadi peta komunikasi abdi salega-gancang. Sarta di sawatara titik I exploded: Kuring sadar yen Abdi teu tiasa, abdi teu tiasa, Abdi teu tiasa ngeusian kaluar hellish ton tabel unreadable sarta dokumén.
Pasti masing-masing anjeun ayeuna ngabayangkeun naon anu kuring nyarioskeun sareng kesang tiis: daptar ngaran kulawarga tanpa urutan abjad, tabel sareng ratusan kolom kalayan perenah bengkok, tabel kalayan rébuan garis dimana anjeun kedah ngusap ramo anjeun. dina kabayang mouse kasampak header, ton kaca parentah unnumbered, ratusan hurup dikirim ka silih kalawan data anu perlu dianalisis tur systematized sarta boneka kana tabel sarua unreadable.
Janten, nalika kuring rada tiis, kuring mutuskeun pikeun nyerat tulisan ieu. Kuring bakal ngobrol ngeunaan kumaha anjeun tiasa normal (sanajan kadang merenah) ngajaga rupa-rupa dokuméntasi non-produk. Kuring miharep éta artikel bakal nyebarkeun sakuliah Internet sarta tingkat naraka di departemén padeukeut pangwangunan bakal ngurangan sahenteuna saeutik, sarta jalma (kaasup kuring) bakal jadi saeutik happier.
instrumen
dokuméntasi produk mindeng diteundeun gigireun kode, nu hiji hal anu alus. Sareng dokuméntasi non-produk biasana disimpen di mana waé. Jalma sering nyoba mindahkeun informasi ti tempat béda kana Confluence, sarta kami aya iwal. Jadi sesa carita ngeunaan anjeunna.
Sacara umum, Confluence mangrupikeun mesin wiki canggih. Éta ngamungkinkeun anjeun damel sareng data dina sababaraha jinis tampilan: téks sareng pormat, tabel, sababaraha bagan. Ieu mangrupikeun alat anu pikaresepeun pisan sareng kuat, tapi upami anjeun henteu terang kumaha nyiapkeunna, maka anjeun bakalan mungkas ku tumpukan dokumén anu teu tiasa dibaca. Abdi bakal ngajarkeun anjeun masak!
Macros
Ampir kabéh sihir Confluence asalna tina makro. Aya seueur makro, sareng aranjeunna tiasa digabungkeun saling. Éta tiasa dibayar atanapi gratis; di handap ieu bakal aya sababaraha conto makro kalayan tautan kana dokuméntasi pikeun aranjeunna.
Antarbeungeut pikeun gawé bareng macros sasederhana mungkin. Pikeun nambihan makro, anjeun kedah klik tambah sareng pilih unsur anu dipikahoyong tina daptar.
Upami makro mangrupikeun mandiri, nyaéta, éta henteu meryogikeun nyelapkeun anu sanés di jerona, sigana sapertos blok.
Lamun makro merlukeun hiji hal pikeun ditempatkeun di jero eta pikeun jalan, eta Sigana mah pigura a.
Dina waktos anu sami, anjeun tiasa nempatkeun saloba anu anjeun pikahoyong di jero hiji pigura, salami aya logika dina piramida anjeun.
Unggal makro gaduh sawangan: éta langsung nunjukkeun naha anjeun ngeusian sareng ngonpigurasi makro kalayan leres.
Nyai
Salian macros, aya alat merenah pikeun eusi pre-eusian - template.
Témplat tiasa dianggo nalika nyiptakeun halaman mana waé: ngan klik dina tilu titik di gigireun tombol "Jieun" sareng pilih citakan anu dipikahoyong.
Lajeng sakabeh eusi nu aya dina citakan bakal ditambahkeun kana kaca dijieun.
Saha waé tiasa ngadamel halaman tina témplat, tapi ngan anu gaduh hak pikeun nyiptakeun atanapi ngédit témplat sorangan anu tiasa ngalakukeun éta. Anjeun tiasa nambahkeun parentah tambahan kana citakan ngeunaan kumaha kaca kudu dijaga.
The magic tabel
Sabenerna, salaku techie a, abdi dearly cinta tabel sarta bisa mungkus ampir sagala informasi di antarana (sanajan ieu teu salawasna éféktif). tabél sorangan jelas, terstruktur, scalable, gaib!
Tapi malah hiji éntitas éndah saperti méja bisa ruined. Sareng anjeun tiasa suksés ngagunakeunana sareng ningkatkeunana. Langkung lengkep ihwal ieu di handap.
Nyaring (plugin berbayar)
Sagala tabel badag, teu bisa dibaca bisa dijieun saeutik kirang badag sarta saeutik leuwih dibaca maké nyaring. Anjeun tiasa nganggo makro anu mayar kanggo ieu .
Anjeun kedah nempatkeun méja di jero makro ieu (sanaos anu paling awon mungkin, hal utama nyaéta nyorong éta sadayana). Dina makro, anjeun tiasa milih kolom pikeun saringan turun-handap, saringan téks, saringan numerik, sareng saringan tanggal.
Bayangkeun waé yén sadaya inpormasi ngeunaan calon pikeun sadaya lowongan kacatet dina daptar tabular. Alami, unsorted - jalma datang ka wawancara teu dina urutan abjad. Sareng anjeun kedah ngartos naha anjeun parantos ngawawancara ngalamar khusus sateuacanna. Anjeun ngan kedah nempatkeun naraka ieu kana makro saringan, tambahkeun saringan téks ku nami tukang - sareng voila, inpormasina aya dina layar anjeun.
Perhatos yén nyaring tabel ageung tiasa mangaruhan kinerja sistem sareng waktos muatkeun halaman, janten nempatkeun méja ageung dina saringan mangrupikeun tongkat samentawis; langkung saé ngawangun prosés dimana jalma henteu kedah nyiptakeun tabel anu ageung sareng teu tiasa dibaca (an conto prosés bakal aya di ahir artikel).
Asihan (plugin berbayar)
Ngagunakeun macro magic Anjeun ogé tiasa nyetél jinis standar dina kolom naon waé sareng nomer barisan. Atawa klik dina sagala kolom tabel diselapkeun kana makro filter, sarta asihan bakal lumangsung ku kolom éta.
Salaku conto, anjeun gaduh méja anu sami sareng pelamar sareng anjeun kedah ngira-ngira sabaraha wawancara anu dilakukeun dina sasih anu tangtu - diurutkeun dumasar kana tanggal sareng janten senang.
Tabel pangsi (plugin berbayar)
Ayeuna urang teraskeun kana kasus anu langkung narik. Bayangkeun yén méja anjeun ageung sareng anjeun kedah ngitung hiji hal ti dinya. Tangtosna, anjeun tiasa nyalin kana Excel, ngitung naon anu anjeun peryogikeun sareng unggah data deui ka Confluence. Naha anjeun tiasa nganggo makro sakali? tur meunangkeun hasil nu sarua, ngan diropéa.
Salaku conto: anjeun gaduh méja anu ngumpulkeun data tina sadaya karyawan - dimana aranjeunna lokasina sacara geografi sareng posisi naon anu diduduki. Pikeun ngitung sabaraha jalma di unggal kota, anjeun kedah milih baris dina makro PivotTable anu ngumpulkeun data (lokasi) sareng jinis operasi (tambahan).
Alami, anjeun tiasa ngagolongkeun sababaraha kriteria sakaligus, sadaya kamungkinan tiasa ditingali .
Bagan (plugin berbayar)
Kawas Cenah mah, teu sadaya jelema mikanyaah tabel saloba I do. Hanjakal, lolobana manajer teu resep aranjeunna. Tapi sarerea bener mikanyaah diagram berwarna caang.
Panyipta Confluence pasti terang ngeunaan ieu (aranjeunna sigana ogé gaduh bos anu resep laporan sareng diagram, dimana aranjeunna tanpa éta). Ku alatan éta, anjeun tiasa nganggo macro magic . Dina makro ieu anjeun kudu nempatkeun tabel pangsi ti paragraf saméméhna, sarta voila - data boring abu anjeun beautifully visualized.
Alami, makro ieu ogé gaduh setélan. Tautan ka dokuméntasi pikeun makro naon waé tiasa dipendakan dina mode éditan makro éta.
aggregation gampang
Inpormasi tina paragraf sateuacana sigana sanés wahyu pikeun anjeun. Tapi ayeuna anjeun pasti terang kumaha ngagunakeun makro, sareng kuring tiasa ngaléngkah ka bagian anu langkung narik dina tulisan.
tags
Éta goréng nalika jalma nyimpen inpormasi dina hiji tulisan anu henteu terstruktur atanapi méja ageung. Ieu malah parah lamun bagéan informasi ieu teu ngan unreadably formatna, tapi ogé sumebar di sakuliah Confluence. Untungna, kasebut nyaéta dimungkinkeun pikeun ngumpulkeun informasi sumebar di hiji tempat. Jang ngalampahkeun ieu anjeun kudu make (tag akrab ka dulur ti jaringan sosial).
Anjeun tiasa nambihan sajumlah tag kana halaman mana waé. Ngaklik dina tag bakal mawa anjeun ka kaca aggregation kalawan tumbu ka sadaya eusi kalawan tag éta, kitu ogé sakumpulan tag patali. Tag anu aya hubunganana nyaéta tag anu sering muncul dina halaman anu sami.
sipat Kaca
Anjeun tiasa nambihan makro anu pikaresepeun pikeun halaman pikeun ngabentuk inpormasi - . Di jerona anjeun kedah ngalebetkeun tabel dua kolom, anu kahiji bakal janten konci, sareng anu kadua bakal nilai harta. Sumawona, makro tiasa disumputkeun tina halaman supados henteu ngaganggu maca eusina, tapi halamanna masih bakal ditandaan ku konci anu diperyogikeun.
Nengetan ID - éta merenah pikeun nyetél éta pikeun napelkeun grup béda sipat ka kaca béda (atawa malah grup béda sipat ka hiji kaca).
Laporan
Anjeun tiasa ngumpulkeun laporan nganggo tag. Contona, makro ngumpulkeun sakabeh kaca ku set husus tina tag.
Tapi laporan anu langkung narik nyaéta makro . Éta ogé ngumpulkeun sadaya halaman kalayan sakumpulan tag anu tangtu, tapi éta henteu ngan ukur ningalikeun daptarna, tapi nyiptakeun méja (naha anjeun mendakan sambungan sareng awal tulisan?), dimana kolom mangrupikeun halaman. konci sipat.
Hasilna nyaéta tabel kasimpulan inpormasi tina sumber anu béda. Ieu nice yén éta boga fungsi merenah: perenah adaptif, asihan ku kolom nanaon. Ogé, tabel laporan sapertos tiasa dikonpigurasi dina makro.
Nalika ngonpigurasikeun, anjeun tiasa ngahapus sababaraha kolom tina laporan, nyetél kaayaan standar atanapi jumlah rékaman anu ditampilkeun. Anjeun oge bisa nyetel ID kaca sipat pikeun ningali ngan informasi nu peryogi.
Salaku conto, anjeun gaduh seueur halaman karyawan, halaman ieu ngagaduhan sakumpulan sipat ngeunaan jalma éta: tingkat naon anjeunna, dimana anjeunna, nalika anjeunna ngagabung sareng tim, sareng saterasna. sipat ieu ditandaan ID = pagawe_inf. Sareng aya set kadua sipat dina halaman anu sami, anu ngandung inpormasi ngeunaan jalma salaku bagian tina tim: peran naon anu dimaénkeun ku jalma, tim naon anjeunna, sareng saterasna. sipat ieu ditandaan ID = team_inf. Teras, nalika nyusun laporan, anjeun ngan ukur tiasa ningalikeun inpormasi pikeun hiji atanapi dua ID sakaligus - mana anu langkung merenah.
Kaéndahan pendekatan ieu yén sadaya jelema bisa ngumpul tabel informasi maranéhna butuh, nu moal duplikat nanaon sarta bakal diropéa nalika kaca utama diropéa. Salaku conto: henteu masalah pikeun kalungguhan tim nalika pamekar na ngagaduhan padamelan, tapi anu penting naon peran masing-masing dimaénkeun di tim. Pimpinan tim bakal ngumpulkeun laporan ngeunaan tim. Sareng akuntan umumna henteu paduli saha anu ngalaksanakeun peranna, tapi jabatanna penting - anjeunna bakal nyusun laporan ngeunaan jabatan. Dina hal ieu, sumber inpormasi moal diduplikasi atanapi ditransfer.
Prosés ahir
parentah
Ku kituna, urang beautifully bisa struktur jeung éféktif agrégat informasi dina Confluence ngagunakeun macros salaku conto. Tapi saenyana, anjeun kedah mastikeun yén inpormasi énggal langsung terstruktur sareng kalebet kana sadaya mékanisme agrégasi anu parantos dianggo.
Ieu dimana sakumpulan makro sareng témplat bakal nyalametkeun. Pikeun maksa jalma nyieun kaca anyar dina format nu dipikahoyong, Anjeun bisa make makro Jieun ti Citakan. Éta nambihan tombol kana halaman, nalika diklik, halaman énggal didamel tina citakan anu anjeun peryogikeun. Ku cara ieu anjeun maksa jalma pikeun langsung damel dina format anu anjeun peryogikeun.
Dina template ti mana anjeun nyieun kaca, Anjeun kudu nambahkeun labél, a "Page Properties" makro sarta tabel sipat nu peryogi sateuacanna. Kuring ogé nyarankeun nambahkeun parentah ngeunaan naon nilai kudu dieusian dina kaca, sarta nilai sipat.
Lajeng prosés ahir bakal kasampak kawas kieu:
- Anjeun nyieun template pikeun tipe husus inpormasi.
- Dina citakan ieu anjeun nambihan labél sareng sipat halaman dina makro.
- Di mana waé tempat anu pikaresepeun, jieun halaman akar sareng tombol, ngaklik anu nyiptakeun halaman anak tina citakan.
- Anjeun ngantep pamaké buka kaca root, anu berpotensi ngahasilkeun informasi diperlukeun (nurutkeun citakan diperlukeun, ku ngaklik on tombol).
- Anjeun ngumpulkeun laporan ngeunaan sipat halaman nganggo tag anu anjeun setel dina citakan.
- Girang: anjeun gaduh sadayana inpormasi anu dipikabutuh dina format anu merenah.
Pitfalls
Salaku insinyur kualitas, kuring aman tiasa nyarios yén teu aya anu sampurna di dunya. Malah tabel ketuhanan teu sampurna. Sareng aya pitfalls dina prosés di luhur.
- Upami anjeun mutuskeun ngarobih nami atanapi komposisi sipat halaman, anjeun kedah ngapdet sadaya obyék anu parantos didamel supados datana leres-leres kalebet dina laporan kasimpulan. Ieu hanjelu, tapi, di sisi séjén, éta maksakeun anjeun mikir di jéntré ngeunaan "arsitektur" susunan informasi anjeun, nu mangrupakeun tugas pisan metot.
- Anjeun kedah nyerat sajumlah petunjuk ngeunaan cara ngeusian tabel inpormasi sareng nganggo tag. Tapi di sisi anu sanés, anjeun ngan ukur tiasa pencét sadaya jalma anu leres kalayan tulisan ieu.
Conto nyimpen dokuméntasi non-produk
Ngaliwatan prosés ditétélakeun di luhur, anjeun tiasa ngatur neundeun ampir sagala informasi. Kaéndahan pendekatan éta téh universal: sakali pamaké meunang dipaké pikeun eta, aranjeunna eureun generating mess. Sejen ageung (tapi henteu gratis) tambah nyaéta kamampuan pikeun ngumpulkeun rupa-rupa statistik dina laleur sareng ngagambar diagram anu saé dumasar kana éta.
Hayu atuh masihan anjeun conto prosés urang pikeun ngajaga informasi ngeunaan hiji tim.
Urang mutuskeun nyieun hiji kartu pagawe pikeun tiap jalma dina tim. Sasuai, urang boga citakan nurutkeun nu unggal jalma anyar nyieun kartu ieu keur dirina jeung mertahankeun sagala informasi pribadi di dinya.
Sakumaha anjeun tiasa tingali, kami gaduh tabel rinci ngeunaan sipat sareng langsung gaduh petunjuk ngeunaan cara ngajaga halaman ieu. Sababaraha tag anu ditambahkeun ku karyawan sorangan nurutkeun parentah; template ngandung ukur nu utama: tag kartu pagawe-kartu, tag arah arah-ngalibetkeun jeung tag tim tim-qa.
Hasilna, sanggeus dulur geus nyieun kartu keur dirina, tabel lengkep sareng informasi ngeunaan karyawan dicandak. Inpormasi ieu tiasa dianggo dina sababaraha titik. Manajer sumberdaya bisa ngumpulkeun tabel umum pikeun diri, sarta kalungguhan tim bisa nyieun tabel tim ku nambahkeun tag tim kana pilihan.
Anjeun tiasa ningali kasimpulan béda ku tag, contona qa-ningkatkeun-rencana Sadaya tugas pangembangan QA bakal ditingalikeun. Dina waktos anu sami, unggal jalma nyimpen sajarah penting sareng rencana pangwangunan sorangan dina kartu karyawanna - nyiptakeun halaman nested tina template rencana pangembangan.
kacindekan
Ngajaga dokuméntasi wae ku cara nu teu aya éra di dinya, sarta teu ngabalukarkeun nyeri excruciating pikeun pamaké!
Abdi ngarep pisan yén tulisan éta bakal mangpaat sareng pesenan bakal sumping ka sadaya dokuméntasi di dunya.
sumber: www.habr.com