Конфлуенциядагы дизайн

Баарына салам!

Менин атым Маша, мен Tinkoff компаниялар тобунда сапатты камсыздоо боюнча инженер болуп иштейм. QA иши ар кандай командалардын ар кандай адамдары менен көп баарлашууну камтыйт, мен дагы билим берүү программаларынын менеджери жана лектору болгом, ошондуктан менин байланыш картасы мүмкүн болушунча кенен болчу. Анан бир убакта мен жарылып кеттим: мен окулбаган таблицаларды жана документтерди толтура албайм, кыла албайм, толтура албасымды түшүндүм.

Конфлуенциядагы дизайн


Албетте, ар бириңер азыр мен эмне жөнүндө айтып жатканымды элестетип, муздак тер басып кеттиңер: фамилиялардын алфавит тартиби жок тизмелери, кыйшык жайгашуусу менен жүздөгөн тилкелерден турган таблицалар, манжаңызды сүртүп салышыңыз керек болгон миңдеген саптардан турган таблицалар. чычкан дөңгөлөктүн башын карап чыгуу үчүн, номерсиз нускамалардын тонна беттери, талдоо жана системалаштыруу жана бирдей окулбаган таблицаларга толтуруу керек болгон маалыматтар менен бири-бирине жөнөтүлгөн жүздөгөн каттар.

Конфлуенциядагы дизайн

Ошентип, бир аз муздагандан кийин, мен бул макаланы жазууну чечтим. Мен ар кандай продукт эмес документтерди кантип кадимкидей (ал тургай кээде ыңгайлуу) сактай ала тургандыгы жөнүндө сүйлөшөм. Макала интернетке жайылып, өнүгүүгө жанаша жайгашкан бөлүмдөрдөгү тозоктун деңгээли бир аз болсо да төмөндөп, эл (анын ичинде мен да) бир аз бактылуу болот деп ишенем.

Конфлуенциядагы дизайн

аспаптар

Продукциянын документтери көбүнчө коддун жанында сакталат, бул жакшы нерсе. Ал эми продукт эмес документтер, адатта, каалаган жерде сакталат. Адамдар көбүнчө Конфлуенске ар кайсы жерден маалыматты көчүрүүгө аракет кылышат, жана биз да четте калбайбыз. Ошентип, окуянын калган бөлүгү ал жөнүндө.

Жалпысынан, Confluence - бул өнүккөн вики кыймылдаткычы. Ал ар кандай дисплейдеги маалыматтар менен иштөөгө мүмкүндүк берет: форматтуу текст, таблицалар, ар кандай диаграммалар. Бул абдан кызыктуу жана күчтүү курал, бирок сиз аны кантип даярдоону билбесеңиз, анда окулбаган документтердин дагы бир таштандысы пайда болот. Мен сага тамак жасаганды үйрөтөм!

Конфлуенциядагы дизайн

макросторун

Confluence сыйкырынын дээрлик бардыгы макростордон келет. Макростор көп жана алар бири-бири менен айкалыштырылышы мүмкүн. Алар акы төлөнүүчү же бекер болушу мүмкүн; төмөндө алар үчүн документтерге шилтемелер менен макростордун ар кандай мисалдары болот.

Макростар менен иштөө интерфейси мүмкүн болушунча жөнөкөй. Макросту кошуу үчүн, плюсту басып, тизмеден керектүү элементти тандоо керек.

Конфлуенциядагы дизайн

Эгер макро өз алдынча болсо, башкача айтканда, анын ичине башка нерсени киргизүүнү талап кылбаса, ал блокко окшош.

Конфлуенциядагы дизайн

Эгер макрос анын иштеши үчүн анын ичине бир нерсе жайгаштырылышын талап кылса, ал кадрга окшош.

Конфлуенциядагы дизайн

Ошол эле учурда, пирамидаңызда логика болсо, бир кадрдын ичине каалаганыңызча башкаларды жайгаштырсаңыз болот.

Конфлуенциядагы дизайн

Ар бир макросту алдын ала көрүү бар: ал макросту туура толтурганыңызды жана конфигурациялаганыңызды дароо көрсөтөт.

Калып:

Макростордон тышкары, мазмунду алдын ала толтуруу үчүн ыңгайлуу курал бар - шаблон.
Калыптарды каалаган баракты түзүүдө колдонсо болот: жөн гана “Түзүү” баскычынын жанындагы үч чекитти чыкылдатып, керектүү шаблонду тандаңыз.

Конфлуенциядагы дизайн

Андан кийин калыптагы бардык мазмун түзүлгөн баракка кошулат.

Ар бир адам шаблондордон барактарды түзө алат, бирок шаблондорду өздөрү түзүүгө же түзөтүүгө укугу барлар гана жасай алат. Сиз шаблонго баракчаны кантип сактоо керектиги жөнүндө кошумча көрсөтмөлөрдү кошо аласыз.

Конфлуенциядагы дизайн

Столдордун сыйкырчылыгы

Чынында, техник катары мен үстөлдөрдү абдан жакшы көрөм жана аларга дээрлик бардык маалыматты ороп алам (бирок бул дайыма эле эффективдүү боло бербейт). Таблицалардын өзү так, структураланган, масштабдуу, сыйкырдуу!

Конфлуенциядагы дизайн

Бирок дасторкон сыяктуу сонун нерсе да бузулушу мүмкүн. Жана сиз аны ийгиликтүү колдонуп, жада калса жакшырта аласыз. Бул тууралуу төмөндө.

Чыпкалоо (акы төлөнүүчү плагин)

Кандайдыр бир чоң, окулбаган таблицаны чыпкалоо аркылуу бир аз чоңураак жана бир аз окула турган кылса болот. Бул үчүн акы төлөнүүчү макросту колдоно аласыз "Стол чыпкасы".

Бул макростун ичине таблица коюшуңуз керек (эң жаманы да мүмкүн, эң негизгиси аны толугу менен түртүп коюу). Макродо сиз ачылуучу чыпка, текст чыпкасы, сандык чыпка жана күн чыпкасы үчүн тилкелерди тандай аласыз.

Конфлуенциядагы дизайн

Элестеткиле, бардык бош орундарга талапкерлер боюнча бардык маалыматтар таблица тизмегинде жазылган. Албетте, сортсуз - адамдар алфавиттик тартипте эмес, интервьюга келишет. Жана сиз мурда белгилүү бир талапкер менен маектешкениңизди түшүнүшүңүз керек. Сиз жөн гана бул тозокту чыпкалоо макросуна салып, фамилия боюнча текст чыпкасын кошушуңуз керек - жана voila, маалымат сиздин экранда.

Конфлуенциядагы дизайн

Белгилей кетчү нерсе, чоң таблицаларды чыпкалоо тутумдун иштешине жана баракты жүктөө убакыттарына таасир этиши мүмкүн, андыктан чоң таблицаны чыпкага салуу убактылуу балдак; адамдар чоң, окулбаган таблицаларды түзбөй турган процессти куруу жакшыраак. процесстин мисалы макаланын аягында болот).

Сорттоо (акы төлөнүүчү плагин)

Сыйкырдуу макро колдонуу "Стол чыпкасы" Ошондой эле каалаган тилкеге ​​демейки сортту орнотуп, саптарды номерлей аласыз. Же чыпка макросуна киргизилген таблицанын каалаган мамычасын чыкылдатыңыз жана сорттоо ошол тилке боюнча ишке ашат.

Конфлуенциядагы дизайн

Мисалы, сизде абитуриенттер менен бир таблица бар жана сиз белгилүү бир айда канча интервью өткөргөнүн баалашыңыз керек - датасы боюнча сорттоп, бактылуу болуңуз.

Пивот таблицалары (акы төлөнүүчү плагин)

Эми кызыктуураак ишке өтөлү. Элестетиңиз, сиздин үстөлүңүз чоң жана сиз андан бир нерсе эсептешиңиз керек. Албетте, сиз аны Excelге көчүрүп, керектүү нерсени эсептеп, маалыматтарды Confluenceке кайра жүктөй аласыз. Макросту бир жолу колдоно аласызбы? "Пивот стол" жана ошол эле натыйжаны алуу, бир гана жаңыртылды.

Мисалы: сизде бардык кызматкерлерден маалыматтарды чогултуучу таблица бар - алар географиялык жактан кайда жайгашкан жана алар кандай кызматтарды ээлейт. Ар бир шаарда канча адам бар экенин эсептөө үчүн, сиз PivotTable макросундагы маалыматтарды (жайгашкан жерди) жана операция түрүн (кошумча) бириктирген сапты тандооңуз керек.

Конфлуенциядагы дизайн

Албетте, сиз бир эле учурда бир нече критерийлер боюнча топтосоңуз болот, бардык мүмкүнчүлүктөрдү көрүүгө болот документтерде.

Диаграммалар (акы төлөнүүчү плагин)

Айткандай эле мендей дасторконду баары жакшы көрө бербейт. Тилекке каршы, көпчүлүк жетекчилер аларды таптакыр жактырышпайт. Бирок ар бир адам чындап эле ачык түстүү диаграммаларды жакшы көрөт.
Confluenceтин жаратуучулары бул жөнүндө, албетте, билишкен (балким, аларда отчетторду жана диаграммаларды жакшы көргөн жетекчилер бар, ансыз алар кайда болмок). Ошондуктан, сиз сыйкырдуу макро колдоно аласыз "Таблицадан диаграмма". Бул макродо сиз мурунку абзацтагы пивот таблицасын коюшуңуз керек, жана voila - сиздин боз кызыксыз маалыматтар сонун визуализацияланган.

Конфлуенциядагы дизайн

Албетте, бул макронун да жөндөөлөрү бар. Каалаган макростун документтерине шилтеме ошол макронун түзөтүү режиминде тапса болот.

Оңой топтоо

Мурунку абзацтардагы маалымат, балким, сиз үчүн ачылыш болгон эмес. Бирок азыр сиз макросторду кантип колдонууну билесиз, мен макаланын кызыктуу бөлүгүнө өтө алам.

Конфлуенциядагы дизайн

Tags

Адамдар маалыматты бир структураланбаган макалада же чоң таблицада сактаса жаман. Бул маалыматтын бөлүктөрү окулбай форматталып гана тим болбостон, Confluence боюнча чачырап кеткенде дагы жаман. Бактыга жараша, бир жерде чачылган маалыматты чогултуу мүмкүн. Бул үчүн колдонуу керек этикеткалар (социалдык тармактардан баарына тааныш тэгдер).

Конфлуенциядагы дизайн

Сиз каалаган бетке каалаган сандагы тегдерди кошо аласыз. Тегди чыкылдатуу сизди ошол тег менен бардык мазмунга шилтемелер, ошондой эле тиешелүү тегдердин топтому бар топтоо барагына алып барат. Тиешелүү тегдер бир эле баракта көп пайда болгон тегдер.

Конфлуенциядагы дизайн

Барактын касиеттери

Маалыматты түзүү үчүн баракка дагы бир кызыктуу макросту кошо аласыз - "Барак касиеттери". Анын ичинде сиз эки тилкеден турган таблицаны тапшырышыңыз керек, биринчиси ачкыч, экинчиси мүлктүн баасы болот. Мындан тышкары, макрос мазмунду окууга тоскоол болбошу үчүн баракчадан жашырылышы мүмкүн, бирок барак дагы эле керектүү баскычтар менен белгиленет.

Конфлуенциядагы дизайн

Идентификаторго көңүл буруңуз - аны ар кандай барактарга касиеттердин ар кандай топторун (же атүгүл бир бетке касиеттердин ар кандай топторун) дайындоо үчүн коюу ыңгайлуу.

Отчеттор

Сиз тегдерди колдонуу менен отчетторду чогулта аласыз. Мисалы, макро "Мазмун отчету" белгилердин белгилүү бир топтому менен бардык барактарды чогултат.

Конфлуенциядагы дизайн

Бирок кызыктуураак отчет макро болуп саналат "Барак касиеттери отчету". Ал ошондой эле белгилүү бир тегдер топтому бар бардык барактарды чогултат, бирок ал алардын тизмесин гана көрсөтпөстөн, таблицаны түзөт (макаланын башы менен байланышты кармайсызбы?), анда тилкелер бет болуп саналат. мулк ачкычтары.

Конфлуенциядагы дизайн

Натыйжада ар кандай булактардан алынган маалыматтардын жыйынды таблицасы болуп саналат. Анын ыңгайлуу функциялары бар экени жакшы: адаптациялоо, каалаган тилке боюнча сорттоо. Ошондой эле, мындай отчеттук таблицаны макростун ичинде конфигурациялоого болот.

Конфлуенциядагы дизайн

Конфигурациялоодо сиз отчеттон кээ бир мамычаларды алып салсаңыз, демейки абалды же көрсөтүлгөн жазуулардын санын орното аласыз. Сиз ошондой эле сизге керектүү маалыматты гана көрүү үчүн барактын касиетинин идентификаторун орното аласыз.

Мисалы, сизде көптөгөн кызматкерлердин баракчалары бар, бул баракчаларда адам жөнүндө касиеттердин жыйындысы бар: ал кандай деңгээлде, ал кайда, командага качан кошулган ж.б.у.с. Бул касиеттери белгиленген ID = кызматкер_inf. Жана ошол эле баракта экинчи касиеттер топтому бар, анда команданын бир бөлүгү катары адам жөнүндө маалымат камтылган: адам кандай ролду ойнойт, ал кайсы командада турат ж.б.у.с. Бул касиеттери белгиленген ID = team_inf. Андан кийин, отчетту түзүүдө сиз бир эле учурда бир же эки ID үчүн маалыматты гана көрсөтө аласыз - кайсынысы ыңгайлуу болсо, ошого жараша.

Бул ыкманын кооздугу - ар бир адам өзүнө керектүү маалыматтык таблицаны чогулта алат, ал эч нерсени кайталабайт жана негизги бет жаңыланганда жаңыланат. Мисалы: команданын жетекчиси үчүн анын иштеп чыгуучулары качан ишке орношкону маанилүү эмес, бирок алардын ар бири командада кандай роль ойногону маанилүү. Топтун жетекчиси команда боюнча отчет чогултат. Ал эми бухгалтер жалпысынан ким кандай ролду аткарып жатканына маани бербейт, бирок кызмат орундары маанилүү - ал кызмат орундары боюнча отчет түзөт. Бул учурда маалымат булагы кайталанбайт жана өткөрүлүп берилбейт.

Акыркы процесс

нускама

Ошентип, биз макросторду мисал катары колдонуп Confluenceде маалыматты сонун түзө алабыз жана эффективдүү топтой алабыз. Бирок, идеалдуу түрдө, сиз жаңы маалымат дароо структураланган жана буга чейин колдонулуп жаткан бардык топтоо механизмдерине түшөт деп ынануу керек.

Бул жерде бир топ макростар жана шаблондор жардамга келет. Адамдарды керектүү форматта жаңы барактарды түзүүгө мажбурлоо үчүн, сиз Калыптан түзүү макросун колдонсоңуз болот. Ал баракка баскычты кошот, басылганда сизге керектүү шаблондон жаңы барак түзүлөт. Ушундай жол менен сиз адамдарды дароо сизге керектүү форматта иштөөгө мажбурлайсыз.

Конфлуенциядагы дизайн

Баракты түзүп жаткан шаблондо сиз энбелгилерди, "Барак касиеттери" макросун жана алдын ала керектүү касиеттердин таблицасын кошууңуз керек. Мен ошондой эле баракчада кандай баалуулуктарды толтуруу керектиги боюнча нускамаларды жана менчик баалуулуктарын кошууну сунуштайм.

Конфлуенциядагы дизайн

Андан кийин акыркы процесс төмөнкүдөй болот:

  1. Сиз маалыматтын белгилүү бир түрү үчүн шаблон түзөсүз.
  2. Бул калыпта сиз макроста энбелгилерди жана барак касиеттерин кошосуз.
  3. Каалаган ыңгайлуу жерде, баскычы бар тамыр барагын түзүңүз, аны чыкылдатуу менен шаблондон бала баракча түзүлөт.
  4. Сиз колдонуучуларга керектүү маалыматты (талап кылынган шаблонго ылайык, баскычты чыкылдатуу менен) түзө турган түпкү бетке өтүүгө уруксат бересиз.
  5. Сиз шаблондо көрсөтүлгөн тегдерди колдонуп, баракчанын касиеттери боюнча отчет чогултасыз.
  6. Кубаныңыз: сизде ыңгайлуу форматта бардык керектүү маалыматтар бар.

Конфлуенциядагы дизайн

тузактар

Сапаттуу инженер катары мен дүйнөдө идеалдуу эч нерсе жок деп ишенимдүү айта алам. Атүгүл Кудайдын үстөлдөрү да жеткилең эмес. Ал эми жогорудагы процессте тузактар ​​бар.

  • Эгер сиз барак касиеттеринин атын же курамын өзгөртүүнү чечсеңиз, анда бардык түзүлгөн объекттерди алардын маалыматтары жыйынтыктоочу отчетко туура камтышы үчүн жаңыртышыңыз керек болот. Бул өкүнүчтүү, бирок, экинчи жагынан, сизди маалымат топтомуңуздун "архитектурасы" жөнүндө кылдат ойлонууга мажбурлайт, бул абдан кызыктуу иш.
  • Сиз маалымат таблицаларын толтуруу жана тегдерди колдонуу боюнча адилеттүү нускамаларды жазышыңыз керек болот. Бирок, экинчи жагынан, сиз жөн гана бул макала менен бардык туура адамдарды уруп алат.

Продукциядан тышкаркы документтерди сактоонун мисалы

Жогоруда айтылган процесс аркылуу сиз дээрлик бардык маалыматты сактоону уюштура аласыз. Бул ыкманын кооздугу анын универсалдуу экендигинде: колдонуучулар көнүп калгандан кийин, алар баш аламандык жаратууну токтотот. Дагы бир чоң (бирок бекер эмес) плюс - ар кандай статистикалык маалыматтарды тез арада чогултуу жана алардын негизинде кооз диаграммаларды тартуу мүмкүнчүлүгү.

Команда тууралуу маалыматты сактоо процессибиздин мисалын берейин.

Конфлуенциядагы дизайн

Биз командадагы ар бир адамга кызматкер картасын түзүүнү чечтик. Демек, бизде шаблон бар, ага ылайык ар бир жаңы адам бул картаны өзү үчүн түзүп, андагы бардык жеке маалыматтарды сактайт.

Конфлуенциядагы дизайн

Көрүнүп тургандай, бизде касиеттердин деталдуу таблицасы бар жана дароо бул баракты кантип так сактоо керектиги боюнча көрсөтмөлөр бар. Тегдердин айрымдары инструкцияга ылайык кызматкерлердин өздөрү тарабынан кошулат; шаблон негизгилерин гана камтыйт: карта теги кызматкер-карта, багыт белгиси багыт-тартыш жана команда теги команда-ка.

Натыйжада, ар бир адам өзүнө карта түзгөндөн кийин, кызматкерлер жөнүндө маалымат менен толук таблица алынат. Бул маалымат ар кандай пункттарда колдонулушу мүмкүн. Ресурс менеджерлери өздөрү үчүн жалпы таблицаларды чогулта алышат, ал эми команда лидерлери тандоого команда тегин кошуу менен команда таблицаларын түзө алышат.

Мисалы, тегдер боюнча ар кандай жыйынтыктарды көрө аласыз qa-upgrade-план Бардык QA иштеп чыгуу тапшырмалары көрсөтүлөт. Ошол эле учурда, ар бир адам өзүнүн жумушчу картасында маанилүү тарыхын жана өзүнүн өнүгүү планын сактайт - өнүгүү пландарынын шаблонунан уяланган баракты түзөт.

Конфлуенциядагы дизайн

жыйынтыктоо

Ар кандай документацияда уят болбогудай кылып сактаңыз жана колдонуучулар үчүн жан чыдагыс ооруну жаратпайт!

Мен чындап эле макала пайдалуу болот деп үмүттөнөм жана тартип дүйнөдөгү бардык документтерге келет.

Конфлуенциядагы дизайн

Source: www.habr.com

Комментарий кошуу